Screenshot or GIF of the visualizer goes here — replace once available.
- 🎨 Beautiful Audio Visualizer — real-time TUI visualizer with multiple modes, the centerpiece of RTunes
- 🎵 Local File Playback — play music from your local filesystem with full playback controls
- 📥 YouTube Music Downloads — download tracks directly into your library using yt-dlp
- 📚 Library Management — add and manage multiple library folders from within the app
- ⌨️ Keyboard-driven UI — fast, distraction-free terminal controls for everything
| Platform | Architecture | Status |
|---|---|---|
| Linux (Arch) | x86_64 | ✅ Supported |
| Windows | x86_64 | ✅ Supported |
| Windows | aarch64 | ✅ Supported |
| macOS | aarch64 (Apple Silicon) | ✅ Supported |
Download the latest binary for your platform from the Releases page.
Linux / macOS:
chmod +x rtunes
sudo mv rtunes /usr/local/bin/Windows: Download the .exe from releases and add it to your PATH.
Prerequisites: Rust stable toolchain and cargo — install from https://www.rust-lang.org/tools/install
# 1. Clone the repository
git clone https://github.com/TheCoder1232/RTunes.git
cd RTunes
# 2. Build in release mode
cargo build --release
# 3. Binary output:
# Linux/macOS: ./target/release/rtunes
# Windows: ./target/release/rtunes.exe
# 4. (Optional) Install system-wide on Linux/macOS
sudo mv ./target/release/rtunes /usr/local/bin/rtunesDetailed keybindings and usage guide coming soon.
RTunes is early in development at v0.1.1 — there is a lot more planned.
- Playlist support
- Equalizer settings
- Last.fm scrobbling
- Config file (~/.config/rtunes/config.toml)
- Streaming support
Have an idea? Open a feature request →
Contributions are welcome at all skill levels — whether it is a typo fix or a brand-new feature. See CONTRIBUTING.md for guidelines on how to get started.
RTunes is licensed under the MIT License.
© 2026 TheCoder1232
Built with ❤️ and Rust