track_presence

Crates.iotrack_presence
lib.rstrack_presence
version0.1.1
created_at2026-01-05 19:03:17.931355+00
updated_at2026-01-21 14:24:33.771013+00
descriptionShows your current music on Discord, with support for multiple media players
homepage
repositoryhttps://github.com/nar1nari/track-presence
max_upload_size
id2024375
size90,425
(nar1nari)

documentation

README

Cover

Track Presence is a lightweight Discord music status application that tracks what you’re listening to and displays it on Discord. It’s modular, fully local, and extremely resource-efficient — under 1 MB in size, minimal CPU, and memory usage.

Features

  • ✅ Lightweight, low CPU & RAM usage
  • ✅ Fully local — no external connections
  • ✅ Modular — pick only the music players you want
  • ✅ Supports multiple players (currently via MPRIS)
  • ✅ Exclusion options for players, artists, tracks, and URLs
  • ✅ Optional custom Discord Client ID
  • ✅ Album art support via MusicBrainz

Installation

Linux only (for now). Track Presence currently supports MPRIS. Support for other OSes and additional players will come in future updates.

Install with Cargo package manager:

cargo install track_presence

Run Track Presence:

trackpresence

To launch at system startup, add trackpresence to your autostart configuration.

Cargo features

Feature Description Default
mpris Enables MPRIS player support ✅ Yes
musicbrainz Enables album art fetching via MusicBrainz ✅ Yes

If you don't want to connect to MusicBrainz to fetch album art, you can disable this feature accordingly:

cargo install track_presence --no-default-features --features mpris

But note that album art will not appear in rich presence.

Usage

Track Presence runs entirely in the background — no GUI required.

Optional Arguments

  • --excluded-players — hide certain players
  • --excluded-titles — hide certain song titles
  • --excluded-artists — hide certain artists
  • --excluded-urls — hide songs from specific URLs

Example:

trackpresence --excluded-players mpv --excluded-urls "www.youtube.com,vk.com" --excluded-artists "Justin Bieber,Ironmouse"

Advanced users can use a custom Discord Client ID.

See all options with trackpresence --help.

Future Plans

  • Windows API support
  • MPD player support
  • MacOS support

License

Licence

See LICENSE for details.

Commit count: 11

cargo fmt