gtm 📻

gtm is a reimagined audio player built for terminal enthusiasts.

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.

Install via AUR

gtm is now available in the AUR as gtm-player (Compiles it) and gtm-player-bin (Binary/No compilation):

# Using yay
yay -S gtm-player

# Using paru
paru -S gtm-player

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

# Using yay
yay -S gtm-player-bin

# Using paru
paru -S gtm-player-bin

Documentation

• gtmd.dev

Manpages

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

Contributing

See the contributing guide and the Code of Conduct first.

Acknowledgements

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

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

Contributors

(c) 2026, prjctimg

Released under the GPL-3.0 license.