Genesis Music Player

Version 2025.11.30

A lightweight Qt6 YouTube Music playlist manager & MPV player

---

Features

• YouTube Music Search – Find songs, albums, and artists directly
• YouTube Playlists – Load any public or unlisted playlist
• Local Playlists – Play from folders
• Offline Caching – Save playlists as JSON to avoid repeated API calls
• Download Playlists – Download playlists locally
• MPV-Powered Playback – Full video playback with MPV’s rendering
• Firefox Cookie Support – Bypass age/login restrictions using your browser session
• Clean, Native Qt6 UI – Fast, responsive, and minimal. QSS themes can be made

---

📦 Installation

Prerequisites

• Python 3.9+
• MPV (installed and in PATH)
• Firefox / Browser (cookie support, recently won't work without)

Clone & Run

git clone https://github.com/mira-xt/genesis-music.git
cd genesis-music
pip install -r requirements.txt # or in a virtual environment
python app.py

---

Usage

Launch the app

Use the search bar to find YouTube Music content

Use /ADD to import a YouTube playlist or local folder

Select a playlist from the dropdown

Click tracks to play via MPV

Playback opens in an external MPV window

Check app.ini file for config

Commands

Type these in the command input field:

Command	Description
/ADD	Add a YouTube playlist URL or local folder
/CACHE	Save current YouTube playlist as local JSON (fast reload)
/RELOAD	Refresh the playlist dropdown
/COOKIES	Toggle browser cookies in MPV
/DOWNLOAD	Download YouTube playlist