▗▄▄▖ ▗▄▖ ▗▖ ▗▖▗▖  ▗▖▗▄▄▄   ▗▄▄▖
▐▌   ▐▌ ▐▌▐▌ ▐▌▐▛▚▖▐▌▐▌  █ ▐▌   
 ▝▀▚▖▐▌ ▐▌▐▌ ▐▌▐▌ ▝▜▌▐▌  █  ▝▀▚▖
▗▄▄▞▘▝▚▄▞▘▝▚▄▞▘▐▌  ▐▌▐▙▄▄▀ ▗▄▄▞▘

A filesystem-first audio player for the terminal

---

Sounds is a lightweight TUI music player that lets you browse, manage, and play audio directly from your local files. No databases, no daemons — just point it at a directory and listen.

Features

• 🎵 Play MP3, FLAC, WAV, OGG, and AAC files
• 📁 Browse your music library as a file tree
• 🎛️ Playback controls (play, pause, skip, volume)
• ⌨️ Fully keyboard-driven interface
• ⚡ Fast and lightweight

Install

Linux & MacOS

curl -sSL https://raw.githubusercontent.com/alhaymex/sounds/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/alhaymex/sounds/main/install.ps1 | iex

From source

git clone https://github.com/alhaymex/sounds.git
cd sounds
cargo install --path .

Note: On Linux, you need libasound2-dev and pkg-config installed.

Usage

sounds

This opens the TUI where you can browse and play your music. Press ? for keybindings.

CLI Commands

# Open the TUI with the default library
sounds

# Show the current version
sounds version

# Update to the latest release
sounds update

# Download audio from a YouTube URL into library/Downloads
sounds download https://youtube.com/watch?v=dQw4w9WgXcQ

Note: sounds download requires yt-dlp and ffmpeg to be installed.

Roadmap

• Support nested directories in the file browser
• Navigate screen history by changing prev_screen: Screen to a Vec<Screen>
• Auto-play next song
• Add simple, scoped file manipulation (e.g. rename a playlist or a song)
• Audio playack speed controls
• Refactor app.rs
• macOS support
• Search
• YouTube integration via yt-dlp
• MPRIS

License

MIT