prjctimg/gtm
📻 gtm is a feature rich terminal audio player. Contribute to prjctimg/gtm development by creating an account on GitHub.
10 stars · 1 forks
README
gtm 📻
gtm is a terminal music player: a background daemon (gtmd) with a client (gtm), both driven from the terminal. On this page
Features Install Documentation Contributing Acknowledgements Contributors
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 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 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
Install
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. Documentationgtmd.dev
Manpages
gtm(1) gtmd(1) gtmd-ipc(1)
Contributing See the contributing guide & the Code of Conduct.
Acknowledgements
This wouldn't be possible without the amazing open source community!
color-thief rustfft ratatui, ratatui-image symphonia, fundsp, and rodio innertube-rs LRCLIB Myx spotify-player
Contributors
(c) 2026, prjctimg Released under the GPL-3.0 license.