README.MD
SweetVibe is a sleek, terminal-based (TUI) music player built with Python. It features a retro-modern aesthetic, automatic audio engine setup, and CJK character support for international song titles.
- Retro TUI: High-performance terminal interface using asciimatics.
- Auto-Engine Setup: Automatically downloads and configures ffplay.exe on first launch if missing.
- Smart Library: Supports CJK (Chinese, Japanese, Korean) characters without visual artifacts or "bleeding."
- Dynamic Spectrum: Visualizer that reacts to your music.
- Shuffle Mode: Easily toggle random playback.
If you want to run the script directly:
-
Install Dependencies:
pip install asciimatics tinytag requests -
Run the App:
python main.py
| Key | Action |
|---|---|
| UP / DOWN | Navigate library |
| ENTER | Play selected song |
| SPACE | Pause / Resume |
| S | Toggle Shuffle |
| Q | Quit Player |
Distributed under the Apache License 2.0. See LICENSE for more information.