__  __                 _                   
 |  \/  |               (_)                  
 | \  / |  _   _   ___   _    ___    __ _    
 | |\/| | | | | | / __| | |  / __|  / _` |   
 | |  | | | |_| | \__ \ | | ( (__  | (_| |   
 |_|  |_|  \__,_| |___/ |_|  \___|  \__,_|   

Light-weight • Minimalist • High Performance • Terminal Music Player • Offline Music Playing

"The player that respects your system's resources as much as your playlist."

---

---

Why Musica?

Most modern music players consume 200MB to 600MB of RAM. Musica stays under 35MB, making it the perfect companion for:

• Gamers who need zero background jitter.
• Developers compiling heavy projects.
• AI Researchers running memory-intensive models.
• Designers working in CAD or high-res software.

---

Features

• Universal Track Scanning: Automatically find and organize MP3, WAV, FLAC, OGG, M4A, and MPEG files.
• Fluid Visualizer: A beautiful real-time wave visualizer (can be toggled live for zero-CPU mode).
• Dynamic Theming: Nord, Monokai, Dracula, Sunset, and more. Tweak colors on the fly.
• Repeater Modes: Loop single tracks or play your whole library.
• JSON Persistance: Your theme, visualizer state, and paths are remembered.

---

Controls

Key	Action
q	Quit
s	Scan for Tracks
space	Play/Pause
enter	Select/Play highlighted track
r	Toggle Repeat Mode
t	Cycle Themes
v	Cycle Visualizer Modes (Wave/Off)
b	Toggle Visualizer Visibility (Dynamic Layout)

---

Installation & Usage

Get Started Fast (Windows)

1. Clone the repo.
2. Run install.bat to set up dependencies.
3. Run run.bat to enjoy!

Cross-platform

python build/installer.py  # Install dependencies
python build/musica.py     # Run the player

Remember to Update Path at Settings.json

Note: The paths must be up-to-date for scanning the musics.

How to Contribute

We love contributors! Whether you're a terminal wizard or just starting with Python, you can help:

1. Fork the repository.
2. Feature Requests: Open an issue if you have a cool idea.
3. Bug Reports: Found a crash? Let us know with a traceback!
4. Pull Requests:
   • Check the Roadmap for missing features.
   • Run python build/musica.py to test your changes.
   • Keep the design philosophy: Keep it light!

---

Built with ❤️ using Textual.