Installation

Music Sync requires Python 3.9 or later. The only external dependency is Textual.

Requirements

Python 3.9+
Textual (installed automatically via pip)
Linux, macOS, or Windows (any terminal that supports 24-bit colour)

Install via pip

pip install music-sync

Then run with:

music-sync

Install from source

git clone <repo-url>
cd music-sync
pip install -r requirements.txt
python3 main.py

Verify the installation

If the tool launches and shows the setup screen, everything is working. Point the source field at your PC music library and the destination at your Android device's music folder.

Tip: Your Android device should be connected via USB with file transfer enabled, or accessible over MTP/ADB. The destination path is typically something like /run/media/$USER/PHONE/Music on Linux.

Next: Usage guide