Tunetti 🎵

A desktop YouTube Music player built with Python and Qt6. Search, play, and manage your music library — all from a native GUI, no browser needed.

Disclaimer: This project is approximately 99% AI-generated code.

---

Features

• YouTube Music search & playback – Search songs, albums, and artists directly from the app.
• Rich Qt6 GUI – Sleek, dark-themed interface with custom widgets (glassmorphism cards, animated nav buttons, smooth sidebar).
• Discord Rich Presence – Shows what you're listening to on your Discord profile.
• Play history & statistics – Every play is logged. View your most-played tracks, play counts by day, and listening trends.
• Favourites – Mark songs as favourites and quickly access them.
• Audio visualizer – Real-time FFT-based spectrum analyser that reacts to the current playback.
• Playback controls – Play, pause, skip, seek, volume, mute, loop, and queue management.
• Configurable – Settings stored in ~/.config/tunetti/config.json (XDG-compliant). Volume, Discord RPC toggle, visualizer toggle, and more.
• Lightweight – Downloads audio on-the-fly via yt-dlp; no permanent music library to store.

---

Requirements

• Python 3.10+
• A PulseAudio or PipeWire audio system (Linux)
• FFmpeg installed and available in PATH

Installation

# Clone the repository
git clone https://github.com/your-org/tunetti.git
cd tunetti

# Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate

# Install dependencies
pip install -r requirements.txt

Note: PySide6 provides the Qt6 bindings. On some distributions you may need to install system packages like libegl1 or libxkbcommon0 as well.

Usage

# Normal mode
python main.py

# Verbose/debug mode (shows yt-dlp and Qt FFmpeg internals)
TUNETTI_VERBOSE=1 python main.py

On first launch, Tunetti creates ~/.config/tunetti/ and populates it with default settings.

Environment Variables

Variable	Description
TUNETTI_VERBOSE	Set to 1, true, or yes to enable debug logging.

---

Project Structure

Tunetti/
├── main.py                # Entry point & logging setup
├── gui.py                 # All UI components (window, search, playback bar, visualizer, stats, settings)
├── player.py              # Audio playback, download workers, queue management
├── config.py              # XDG-compliant configuration loader & migrator
├── music_db.py            # SQLite database layer (history, favourites, stats)
├── discord_rpc.py         # Discord Rich Presence integration via pypresence
├── requirements.txt       # Python dependencies
├── sonar-project.properties  # SonarQube analysis config
└── .gitea/
    └── workflows/
        └── sonar.yaml     # Gitea Actions CI pipeline

Configuration

Settings are persisted in ~/.config/tunetti/config.json and include:

Key	Default	Description
volume	50	Playback volume (0–100)
max_history	5000	Maximum history entries
discord_rpc_enabled	true	Enable Discord Rich Presence
visualizer_enabled	true	Enable the audio spectrum visualizer
db_path	~/.config/tunetti/music_history.db	SQLite database location

Dependencies

Package	Purpose
yt-dlp	YouTube audio download & search
ytmusicapi	YouTube Music search API
PySide6	Qt6 GUI framework
pypresence	Discord Rich Presence

CI / Quality

The project uses SonarQube for static analysis, with a Gitea Actions workflow defined in .gitea/workflows/sonar.yaml.

License

See LICENSE.