gtm is a terminal music player: a background daemon (gtmd) with a client
(gtm), both driven from the terminal.
- Background playback: reattach to the client from anywhere in the terminal
- YouTube & Spotify: search & download from YouTube and sync Spotify playlists; missing metadata/cover art is backfilled from Spotify, Deezer and MusicBrainz.
- Internet radio: browse the Radio Browser directory 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
m3u8playlists - 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
# stable (latest)
curl -fsSL https://gtmd.dev/install.sh | bashFor nightly builds (released on every push to dev):
# nightly
curl -fsSL https://gtmd.dev/install.sh | bash -s -- --nightlyOr grab an archive releases page, extract it, and run the ./install.sh in its directory
See CONTRIBUTING.md for more installation routes.
You can read about it in this post.
See CONTRIBUTING.md & CODE_OF_CONDUCT.md.
- color-thief
- rustfft
- ratatui, ratatui-image
- symphonia, fundsp, and rodio
- innertube-rs
- LRCLIB
- Myx
- spotify-player
(c) 2026, prjctimg
Released under the GPL-3.0 license.