ommp 0.1.3

Features

• Music playback — FLAC, MP3, M4A, OGG, WAV, Opus, AAC, WMA
• Browse your library — by artist, album, genre, format, directory, or playlist
• Album art — displayed natively in supported terminals
• Search — find any track instantly with filters like artist:, album:, genre:, *.flac
• Playlists — create, rename, delete, and bookmark your favorite tracks
• Mouse friendly — click, scroll, drag to resize panes
• Remembers your settings — volume, playlists, layout are saved between sessions
• Live sync — automatically picks up new or removed files in your music folder

Before You Start

Nerd Font (required)

OMMP uses Nerd Font icons throughout the interface. Without one installed, icons will appear as broken squares.

Recommended fonts: JetBrainsMono Nerd Font, MesloLGS NF, FiraCode Nerd Font

After installing, set it as your terminal's font.

Terminal

OMMP needs true colour (24-bit) support, which any current terminal has.

Album art is drawn as a real image in terminals that implement one of the graphics protocols OMMP understands — the Kitty graphics protocol, Sixel, or the iTerm2 inline image protocol. Which one is in use is detected at startup; nothing to configure.

Anything else falls back to block characters, which still shows the artwork — just coarser. Note that GPU acceleration is unrelated: Alacritty is GPU-accelerated but implements none of these, while xterm is not and supports Sixel.

Audio

PulseAudio or ALSA is required for audio output on Linux.

Install

On Arch Linux:

yay -S ommp

Anywhere else, with Rust installed:

cargo install ommp

That's it. Now you can run ommp from anywhere:

ommp

~/.cargo/bin may not be in your PATH. Add this line to your ~/.bashrc or ~/.zshrc:

export PATH="$HOME/.cargo/bin:$PATH"

Restart your terminal to apply.

git clone https://github.com/sqzer-x/ommp.git
cd ommp
cargo build --release
./target/release/ommp

Usage

Place your music files in ~/Music and run ommp. It will automatically scan all files and subdirectories.

Album art comes from the audio files themselves — whatever cover is embedded in the tags. Nothing to place alongside them.

Browsing

The screen is split into three panels:

• Left — Library browser (artists, albums, genres, etc. depending on the active tab)
• Center — Play queue
• Right — Album art / Clock (top) + Track info (bottom)

Switch browsing modes using the tabs at the top: Queue, Directories, Artists, Albums, Genre, Format, Playlists

Search

Press Ctrl+S to open the search modal. Results filter as you type.

You can also search by specific fields:

• artist:radiohead — search by artist
• album:ok computer — search by album
• genre:rock — search by genre
• *.flac — filter by format

Keybindings

Press Ctrl+H inside the app to view the full keybinding list at any time.

Playback

Navigation

Commands

Mouse

License

Apache 2.0