BEETPOST(1)

💖 BEETPOST(1) 💖

okay bestie, gather round, because this one is literally the cutest little bridge in your whole system. it's a User Command, it's called beetpost, and it's about to make your local music taste known to the internet. let's get into it 🎀

---

✨ NAME ✨

beetpost — a local media playback bridge for MusicBrainz scrobbling via ListenBrainz. no cap, that's the whole vibe. 💅

---

🌸 SYNOPSIS 🌸

beetpost

that's it. that's the whole invocation. no flags, no args, no drama. she just goes. ✨

---

🦋 DESCRIPTION 🦋

so Beetpost is this optional service that bridges your local media playback events over to MusicBrainz scrobbling via ListenBrainz. and the way it does that?? iconic:

• it grabs playback events from MPRIS-enabled players, or from an MPD server
• it sends those scrobbles to Beetbrainz for enrichment
• then Beetbrainz submits them onward to ListenBrainz

🚨 okay important boundary check bestie: Beetpost is not intended for use with content not residing in your local Beets database. it's a local-girlie situation only. don't try to make it scrobble stuff that isn't yours. 🙈

---

🌈 REQUIREMENTS 🌈

to actually utilize beetpost, you're gonna need these:

• MPRIS-enabled players: such as qmmp or Elisa. 👑
• MPD server: plus an associated client application like cantata or MPC.
• Beetbrainz: essential for enriching scrobbles before submission to ListenBrainz. like, cannot skip this one fr fr.

---

🎀 CONFIGURATION 🎀

Beetpost is configured primarily through environment variables, which you typically set inside its systemd service unit file, or through user overrides. very much a "set it and forget it" situation. 💜

• BEETPOST_LOG_LEVEL
  • Description: controls the verbosity of the Beetpost logs. basically, how much she talks. 💬
  • Default: info
  • Example: BEETPOST_LOG_LEVEL="info"
• MPD_ENABLE
  • Description: a TRUE/FALSE toggle to enable or disable Beetpost MPD processing.
  • Default: TRUE
  • Example: MPD_ENABLE="FALSE"
• BEETBRAINZ_URL_MPD
  • Description: the URL where Beetpost will send its data — it points to your Beetbrainz instance's mpd webhook endpoint.
  • Default: http://localhost:5000/mpd
  • Example: BEETBRAINZ_URL_MPD="http://localhost:5000/mpd"
• MPD_PORT
  • Description: must match the port in your MPD configuration. 👀
  • Default: 6600
  • Example: MPD_PORT="6600"
• MPD_HOST
  • Description: must match the bind_to_address in your MPD configuration.
  • Default: 127.0.0.1
  • Example: MPD_HOST="127.0.0.1"
• MPRISPOST_ENABLE
  • Description: a TRUE/FALSE toggle to enable or disable Beetpost MPRIS processing.
  • Default: TRUE
  • Example: MPRIS_ENABLE="FALSE"
• BEETBRAINZ_URL_MPRIS
  • Description: the URL where Beetpost will send its data — it points to your Beetbrainz instance's mpris webhook endpoint.
  • Default: http://localhost:5000/mpris
  • Example: BEETBRAINZ_URL_MPRIS="http://localhost:5000/mpris"
• MPRIS_ALLOWLIST
  • Description: a comma-separated list of mpris player names from which Beetpost will accept events. if you're not on the list, you're not getting in. 💅
  • Default: qmmp,elisa
  • Example: MPRIS_ALLOWLIST="qmmp,elisa"

under normal circumstances, no additional user configuration is required, because the default settings in beetpost.service should suffice. and if you do wanna override stuff, you can do it via systemctl --user edit beetpost.service. easy. ✨

---

🧚 INSTALLATION 🧚

Beetpost is available in the official Fedora production repositories. let's gooo. 🎉

1. Install the Beetpost package:

sudo dnf5 install golang-codeberg-gbcox-beetpost

this command will also ensure that Beetbrainz is installed as a dependency. convenient!! 🫶

🚨 after installation, it is critical to proceed immediately to the "Enabling and Customizing the Systemd User Service" sections to configure Beetpost correctly for your environment. the service will not function as intended without these steps. not me warning you twice but like... i'm warning you twice. 😭

---

👑 ENABLING AND CUSTOMIZING THE SYSTEMD USER SERVICE 👑

the beetpost service unit is designed for user-specific execution, which lets beetpost run as the currently logged-in user. and that's literally ideal for interacting with mpris-enabled players. main character energy fr. 💖

end users can make overrides to this service — primarily for setting environment variables, or for debugging — using systemctl --user edit beetpost.service.

🌸 User Service Locations 🌸

• /usr/lib/systemd/user/beetpost.service: the main service file installed by the package. 📦
• ~/.config/systemd/user/beetpost.service.d/: the primary location for local, custom drop-in files for your user service, which take precedence. 👑

💅 How to Configure Overrides 💅

to set any desired overrides, use systemctl --user edit. this command automatically creates the necessary drop-in directory and file if they don't exist. she's proactive like that. ✨

1. Open the override file for editing:

systemctl --user edit beetpost.service

this will open an editor (usually nano or vim) with a new, empty file. 🎀

2. Add your customizations:

inside the editor, add the [Service] section and the Environment= directive to set your desired variables.

# ~/.config/systemd/user/beetpost.service.d/override.conf
[Service] Environment="BEETPOST_LOG_LEVEL=debug"

3. Save and exit the editor. you got this bestie. 💪
4. Enable and start the user service:

after making changes, enable the service to start automatically on login, and then start it manually for the first time:

systemctl --user enable beetpost.service systemctl --user start
beetpost.service

5. Check the service status (optional):

you can verify that the service is running correctly:

systemctl --user status beetpost.service

---

🫶 AUTHORS 🫶

gbcox — thank you for your service, legend. 👑

---

and that's the whole page, bestie!! 🌈✨ this was Beetpost Documentation, dated July 16, 2025 — go forth and scrobble responsibly, you absolute icon. mwah. 💋🎀🦋