Skip to content

PKBeam/AMWin-RP

Repository files navigation

AMWin-RP

GitHub release (latest by date including pre-releases) GitHub release (latest by date including pre-releases)   (日本語)

A Discord Rich Presence client for Apple Music's native Windows app.
Also includes scrobbling for Last.FM and ListenBrainz.

   

Installation

AMWin-RP requires Windows 10 21H1 or later.

Releases can be found here.
Download the package, unzip it and place the contents somewhere safe.

Which release do I use?

There are two release files: the standard one and one marked as NoRuntime.

If in doubt, use the unlabelled release (i.e. the one without NoRuntime).
This version works universally, but is larger in size because it bundles the components of .NET that are needed for the app to run.

The NoRuntime release is much smaller, but requires you to have the .NET 9.0 desktop runtime installed.
If you don't have this runtime installed, the app will prompt you to do it when it opens.

Usage

You need the Microsoft store version of Apple Music to use AMWin-RP.
No other version of Apple Music is supported.

  • Open the .exe to start the app.
  • AMWin-RP runs in the background, minimised to the system tray.
  • Double clicking on the tray icon brings up the settings window.
    • From here you can adjust individual settings such as run on startup, scrobbling and song detection.
  • The app can be closed by right-clicking on the tray icon and selecting "Exit".
  • By default, the Apple Music app must be open and currently playing music (i.e. not paused) in order for the rich presence to show.

Note: If you use virtual desktops, AMWin-RP and Apple Music must be in the same desktop.
This is a technical limitation of the UI Automation library used to scrape the Apple Music client app.

Scrobbling

The scrobbler implementation does not support offline Scrobbles, which means any songs you listen to while not connected to the internet will be lost.

Last.FM

You will need your own API Key and API Secret from Last.FM.
To generate one, go to https://www.last.fm/api and select "Get an API Account."
Enter these in the settings menu with your Last.FM username and password.

The Last.FM password is stored in Windows Credentials Manager under your local Windows account.

ListenBrainz

You can scrobble to ListenBrainz by adding your user token in the settings.

Reporting Bugs

Before creating a new issue, please make sure your problem does not fall under an existing issue.
If you are reporting a problem, please attach any relevant .log files (found in %localappdata%\AMWin-RichPresence).

Before posting, please double-check the following:

  • The problem isn't already covered by an existing open or closed issue.
  • You have RP display enabled in Discord (Settings > Activity Settings > Activity Privacy > Activity Status).

About

A Discord Rich Presence client for Apple Music's native Windows app.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages