← Back

hum

A minimal TUI music player. Search YouTube, play with mpv, and it downloads tracks to a local library in the background. No accounts, no bloat. Next time you play that song it just works offline. Probably my favorite project and the one I use the most.

GitHub

Dependencies

mpv for playback, yt-dlp for YouTube, and ncurses.

Build

make
cp hum ~/.local/bin/

How it works

Search for music on YouTube, play it, and hum automatically downloads it to ~/Music/hum in the background. Playlists are just text files in ~/Music/hum/playlists/. You can build them up over time by adding tracks from search results, your library, or the queue.

Keys

Vim-style navigation. j/k to move, l or Enter to play, Space to pause, n/p for next/previous, a to add to queue, A to add to playlist. Press ? in the app for the full list.

Config

Edit config.h and rebuild. Keybinds, library path, search result count, volume step, seek step, all in there.