Questions & Answers
Short answers for the things users usually ask before installing or while troubleshooting.
Does this need Python?
No. Normal users should download the Windows installer. Python is only needed when running from source.
Is this affiliated with Amazon or Discord?
No. It is an independent open-source app for Amazon Music users on Windows.
Why use enhanced metadata?
It gives better song, album, artwork, pause state, and timer data than Windows fallback metadata.
Which Amazon Music app should I install?
Use the Microsoft Store version of Amazon Music if you want enhanced metadata. The website/desktop installer version may reject the metadata launch flag and fall back to Windows metadata.
Can I disable enhanced metadata?
Yes. Open Settings and turn off Enhanced Amazon metadata. The app will use fallback metadata instead.
Why does Amazon Music sometimes need to repair or restart?
If Amazon Music opened without metadata access, the app may need to repair that session so enhanced metadata can attach.
What happens in private session?
Discord presence is cleared, and scrobbling can pause while private session is enabled.
Does it read all Windows notifications?
Notification fallback reads notifications locally but only uses Amazon Music notification text for fallback metadata.
Where are settings stored?
Installed builds store settings in %APPDATA%\AmazonMusicRPC\config.json.
Are scrobbling tokens uploaded?
No automatic log or config upload exists. Tokens are stored locally and used only for the service you enable.
Why does SmartScreen warn?
The installer is unsigned. Download from GitHub releases and verify the SHA256 hash when available.
How do I verify the installer hash?
Run Get-FileHash .\AmazonMusicRPC_Setup.exe -Algorithm SHA256 and compare it with the release notes.
How do I fully uninstall?
Use Windows Apps settings or the uninstaller. Source users can delete the project folder, Windows/config.json if present, and %APPDATA%\AmazonMusicRPC.
Why does Discord not show the button sometimes?
Discord can hide buttons from your own profile view. Check with another account and confirm the selected link source.
Why is album art sometimes different?
Fallback lookup can match a different release or alternate artwork when Amazon Music artwork is not available.
What should I include in a bug report?
Include app version, Windows version, metadata source, reproduction steps, expected result, actual result, and redacted logs.