Only the latest public release is supported for security fixes. If you are running an older version, update before reporting a bug unless the issue also reproduces on the latest release.
Please do not post tokens, config files, logs, screenshots with secrets, or exploit details in a public issue.
For non-sensitive security hardening suggestions, open a GitHub issue at:
https://github.com/eripum9/Amazon-Music-Discord-RPC/issues
For sensitive reports, use GitHub private vulnerability reporting if it is available on the repository. If it is not available, open a minimal public issue asking for a private security contact and do not include exploit details.
Useful report details:
- Amazon Music RPC version
- Windows version
- Whether the installed build or source build is used
- Whether enhanced metadata is enabled
- Whether notification enrichment or scrobbling is enabled
- A short reproduction path
- Redacted logs only
Amazon Music RPC can read:
- Amazon Music playback metadata from the local Amazon Music app when enhanced metadata is enabled
- Windows media metadata through SMTC fallback
- Amazon Music Windows notifications when notification enrichment is enabled
- Settings from the local config file
- Local logs for the diagnostics window
Enhanced metadata uses a local debugging interface on a random high port for the current app session. The selected port is kept in memory, shared only with child settings windows, and target validation is limited to Amazon Music pages on music.amazon.*.
Notification enrichment is disabled by default. If enabled, it reads Windows notifications locally and filters them for Amazon Music metadata.
Amazon Music RPC can send:
- Song title, artist, album, playback time, and artwork URL to Discord through local Discord IPC for Rich Presence
- Scrobbles to Last.fm if Last.fm is enabled
- Scrobbles to ListenBrainz if ListenBrainz is enabled
- Track lookup requests to Deezer or iTunes when fallback matching or artwork lookup needs them
- Release check requests to GitHub when update checks run
The app does not upload raw logs or config files automatically.
Last.fm session keys and ListenBrainz tokens are currently stored in the app config file when those features are enabled. Diagnostics and log views redact known token values, Settings exports omit tokens unless explicitly requested, and Settings includes a clear-token action, but %APPDATA%\AmazonMusicRPC\config.json should still be treated as private.
Do not paste config files, diagnostics, or logs publicly unless you have checked that tokens and private data are removed.
The bundled Last.fm API key and API secret are public application credentials for this open-source app. They are not your Last.fm account password or session token.
Enhanced metadata is optional for new installs. It improves track names, album art, playback state, and timing by launching or repairing Amazon Music with a local debugging interface.
Security behavior:
- The debug port is randomly selected from a high local port range.
- The selected port is stored in memory for the app session.
- The app refuses non-Amazon Music targets.
- The common DevTools port
9222is not used for launching Amazon Music. - Diagnostics warns if the common DevTools port is reachable unexpectedly.
To disable enhanced metadata, open Settings and turn off Enhanced Amazon metadata. To avoid Windows notification access too, leave Notification enrichment turned off.
Private session mode clears Discord Rich Presence and can stop scrobbling while it is enabled. Keyword privacy rules can also block specific tracks from being shared.
The updater checks GitHub releases and can download the latest installer. It opens the GitHub release page before running the installer and verifies the installer SHA256 when a hash is present in the release notes.
Each release should include a SHA256 line for AmazonMusicRPC_Setup.exe, a clear changelog, and an enhanced metadata compatibility note. Signed release tags and code-signed Windows installers are still planned hardening steps.
The installer removes installed files, startup entries, logs, config data, and Amazon Music metadata launcher shortcuts during uninstall. If you ran from source, delete the project folder, the Windows/config.json source config if present, and %APPDATA%\AmazonMusicRPC manually.