Aspect - Terminal Music Player

A lightweight terminal UI music player that streams audio from YouTube.

Features

• 🎵 Search YouTube for songs and artists
• 🎶 Build and manage queues
• ▶️ Play/pause, skip, and volume control
• 🔄 Autoplay similar tracks
• 🎨 Clean terminal interface using Textual

Installation

From source (development)

git clone https://github.com/ohxa/aspect.git
cd aspect
pip install -e .

Then run:

aspect

Build locally for testing

pip install -e .
aspect

Arch Linux (AUR)

Once on the AUR:

yay -S aspect
aspect

The AUR package should install the required runtime dependencies, including mpv, so launching aspect should work directly after installation.

Controls

Key	Action
/	Search
enter	Play selected
a	Add to queue
d	Remove from queue
c	Toggle search/queue view
n / p	Next / Previous
space	Play/Pause
s	Stop
+ / -	Volume up/down
m	Mute
x	Toggle autoplay
q	Quit

Requirements

• Python 3.10+
• mpv (for audio playback)
• yt-dlp (for YouTube streaming)
• Textual (for terminal UI)

Development

Install dependencies:

pip install -r requirements.txt

Run directly:

python -m aspect.main

License

MIT