Skip to content

Customize your discord rich presence as you want. You can also sync it with Apple Music.

License

Notifications You must be signed in to change notification settings

WorldOfBasti/CustomRichPresence

Repository files navigation

CustomRichPresence

CustomRichPresence is a tool which helps you to customize your Rich Presence on Discord. It is built with Python and is available for Windows, macOS and Linux.
If you are on macOS, you can also sync your Rich Presence with Apple Music.


Two languages are currently supported:

  • English
  • German

Usage

Installation

You can watch this Tutorial or follow these steps:

  • Download the program of the release page and run it:
    • Windows: Download the file and unzip it. You should be able to start it.
    • macOS: Download the .dmg. Open it and copy CustomRichPresence to your applications folder.
    • Linux: Download and unzip the file. Open your terminal and navigate to the linux-install folder. Type:
      sudo chmod +x install.sh
      sudo ./install.sh
      You should be able to start the application via the Applications Menu
  • Create a new application on the discord developer page. (The name is also the name of your Rich Presence. You can change it at any time.)
  • Copy your Application ID from the developer page and paste it in the Client ID entry.
  • Now you can customize your Rich Presence as you wish.

Don't forget to click the "Update rich presence" button or press enter!

Edit Rich Presence Title

If you want to change your Rich Presence Title, click the "Edit title" Button and change the name of the Application.
The title gets changed as soon as you click on the "Update rich presence" button

Adding Buttons

You can add two buttons to your Rich Presence. To do that, you need to write the text of a button in one of the text entries, then you need to add a link to the link entry. (You can't click your own buttons, they will only work for other users.)

Adding Images

If you want to add an image to your Rich Presence, you can click the "Manage images" Button and add them. It may take a while until Discord processed the images to their servers.
After that you need to write the name of the image to the "image_name" entry.

Sync with Apple Music

If you are on macOS you can sync your Rich Presence with Apple Music. You only have to check the checkbox on top of the program and it will sync your discord rich presence with your apple music playback.

Building

If you want to build CustomRichPresence from source, you need to do a couple of things:

  • Make sure you have Python at least version 3.8 installed
  • Download the source
  • Install all required modules
  • Build the program
    To compile the program into executeables, I used Pyinstaller. You can install it with pip install pyinstaller:
    • Windows: Open cmd, go to the src directory and type (please adjust the paths):
      pyinstaller --noconfirm --onefile --windowed --icon "C:/path/to/CustomRichPresence/files/icon_windows.ico" --add-data "C:/path/to/CustomRichPresence/files;files/" CustomRichPresence.py
    • macOS: Open your terminal, go to the src directory and type (please adjust the paths):
      pyinstaller CustomRichPresence.py --windowed --icon "path/to/CustomRichPresence/files/icon_mac.icns" --add-data "path/to/CustomRichPresence/files/:files"
    • Linux: Open your terminal, go to the src directory and type (please adjust the paths):
      pyinstaller CustomRichPresence.py --onefile --windowed --hidden-import="PIL._tkinter_finder" --add-data "/path/to/CustomRichPresence/files/:files"

If everything worked, there should be a "dist" folder, which contains the executeable.

Acknowledgements

Without these modules/etc. it wouldn't have been possible to create this project. So thank you all very much:

Want to support this project?

The best way to support this project is to create issues and sending pull requests. Alternatively, you can translate the program to other languages.