📻️ gtm(d)

The missing (terminal) audio player.
Features · Download · Docs · Contributing · Discord · Acknowledgements

Features

• Background playback: reattach to the client from anywhere in the terminal
• YouTube & Spotify: search & download from YouTube and sync Spotify.
• Offline playback: Resolve Spotify tracks via yt-dlp for downloading.
• Internet radio: browse the Radio Browser and cliamp directories and stream any station
• Podcasts: subscribe to RSS/Atom feeds and play episodes in order
• Top charts: Spotify, Apple and community charts, browsable as a tree
• Crossfade: gapless-ish transitions with a configurable duration.
• Lyrics: automatic fetch from LRCLIB (default provider)
• Metadata sync: backfill missing tags, cover art, and lyrics for local files
• Last.fm: scrobbling, love and now-playing
• Equalizer: 16 presets
• Visualizer: 12 spectrum presets
• Command palette: fuzzy-finder over every TUI action
• Extensions: toggle optional surfaces per session
• Playlist management: Import/export m3u8 playlists
• Sleep timer
• Cover art support: rendered inline via the kitty/terminal image protocol
• Zero configuration: sane defaults, fully customizable via TOML
• Progress styles: four indicators for the playback position
• Theming: accent colors extracted from the current track cover (reactive theming), transparent mode and 16 built-in themes
• MPRIS: media player controls via D-Bus

Download

# stable (latest)
curl -fsSL https://gtmd.dev/install.sh | bash

For nightly builds (released on every push to dev):

# nightly
curl -fsSL https://gtmd.dev/install.sh | bash -s -- --nightly

Or grab an archive releases page, extract it, and run the ./install.sh in its directory

See CONTRIBUTING for more installation routes.

Install via AUR

gtm is available in the AUR as gtm-player and gtm-player-bin (binaries, no compilation step):

# yay
yay -S gtm-player

# paru
paru -S gtm-player

You can also install the binary directly instead of the above:

# yay
yay -S gtm-player-bin

# paru
paru -S gtm-player-bin

Documentation

• gtmd.dev

Manpages

• gtm(1)
• gtmd(1)
• gtmd-ipc(1)

Dependencies

• Direct dependencies and acknowledgements

Contributing

See the contributing guide and the Code of Conduct first.

Screenshots

multiple clients opened in different panes

spotify search

theme picker

about

Acknowledgements

This project wouldn't be possible without the amazing open source community!

• color-thief
• rustfft
• ratatui, ratatui-image, tachyonfx, and tui-big-text
• symphonia, fundsp, and rodio
• innertube-rs
• yt-dlp
• LRCLIB
• Myx
• spotify-player

See the dependency list for the complete set of direct crates used by the client and daemon.

Contributors

(c) 2026, prjctimg

Released under the GPL-3.0 license.