Skip to content

CalmWave is a lightweight, optimized, and fast music player designed for simplicity

License

Notifications You must be signed in to change notification settings

dreamcatcher45/CalmWave

Repository files navigation

CalmWave Music Player

CalmWave is a lightweight, optimized, and fast music player designed for simplicity and ease of use. It allows you to play your favorite music files with minimal system resources, making it perfect for users who want a no-frills music experience.

Features

  • Lightweight: Designed to consume minimal system resources.
  • Optimized: Smooth playback with efficient memory usage.
  • Fast: Quick loading times for music files and instant playback.
  • Minimal UI: Clean and simple interface for easy navigation.
  • Folder Support: Load and play music from a selected folder.
  • Playback Controls: Play, pause, next, and previous track controls.
  • Media Key Support: Supports media keys for play/pause, next, and previous.
  • Resume Playback: Remembers the last played track and position.
  • Tag Support: Displays song title and artist from file metadata.
  • Cross-Platform: Built for Windows using .NET 8.0.

Requirements

  • Operating System: Windows 10 or later.
  • .NET Runtime: .NET 8.0 Runtime (included in the installer or available here).
  • Disk Space: Minimal storage required (less than 10MB).

Compatibility

  • Platform: Windows (x64 and x86).
  • File Formats: Supports .mp3, .wav, .m4a, and .wma files.
  • Media Keys: Compatible with keyboards/media devices with play/pause, next, and previous track buttons.

Installation

  1. Download the Latest Release:

    • Visit the Releases page.
    • Download the latest .exe installer or portable .zip file.
  2. Install the Application:

    • If using the .exe installer, run it and follow the on-screen instructions.
    • If using the .zip file, extract it to your desired location and run CalmWave.exe.
  3. Launch CalmWave:

    • Double-click the CalmWave.exe file to start the application.

Usage

  1. Select a Music Folder:

    • Click the "Select Folder" button to choose a folder containing your music files.
    • The application will automatically load all supported music files.
  2. Play Music:

    • Select a song from the list and click the play button (⏯) or press the spacebar.
    • Use the previous (⏮) and next (⏭) buttons to navigate between tracks.
  3. Media Keys:

    • Use your keyboard/media device's play/pause, next, and previous track buttons for quick control.
  4. Resume Playback:

    • CalmWave remembers the last played track and position. It will resume playback from where you left off when you reopen the application.

Contributing

Contributions are welcome! If you'd like to contribute to CalmWave, please follow these steps:

  1. Fork the repository.
  2. Create a new branch for your feature or bug fix.
  3. Submit a pull request with a detailed description of your changes.

License

CalmWave is licensed under the MIT License. Feel free to use, modify, and distribute it as per the license terms.

Support

If you encounter any issues or have suggestions for improvement, please open an issue on GitHub.


Enjoy your music with CalmWave! 🎶