A configurable Rich Presence for homebrewed consoles

Presenced is an hopefully flexible and customizable Discord Rich Presence app for homebrewed consoles writen in python meant to run as a background service. Originally created to run on an headless computer as self-bot, it's not a self-bot by default since such things are against the Discord TOS and thus Use at own risk which means you need, by default, to have a Discord client running alongside Presenced to use it.

Note

While the Wii U database should hopefully be complete enough to cover every game you could imagine, it's not the case for PS3 so feel free to contribute to the PresencedPS3-DB whose link is down bellow

TODO:

• General:
  • Make the "{Client}Format" fields in the Default config auto generare at runtime
  • Make the SanitizerTM() run faster (Not necessary per say since it runs once at the start end never again + I have no idea how to do that)
  • Decouple static icons from the default AppID (I already have a system to do that but I'd like better assets first)
  • Better quality appAssets
• PS3:
  • PS2 classics Support
• Wii U:
  • Don't drop connection on app change
  • Don't drop connection when in Miiverse

Requirements:

Presenced relies on discord.py-self, pypresence, bs4, and requests. Install them by running

pip install -r requirements.txt

Usage :

• Standard usage

python Presenced.py

• Get all available CLI arguments

python Presenced.py --help

python Presenced.py -h

• Custom config file path

python Presenced.py --config-file [FilePath]

python Presenced.py -c [FilePath]

• Run a config file check and add missing fields

python Presenced.py --update-config

python Presenced.py -u

Configuration

The way the config file is structured and what values you can put in each field is documented in the CONFIG.MD file. Bellow is the most minimal config you can use to customize your onboarding experience, Presenced will automagicly add all the required fields according to these settings, you can of course customize Presence much more by reading the Config documentation.

{
  "General": {
    "PollInterval": 10,
    "ConsoleClients": "all",
    "PyPresenceBackend": true
  },
  "Presence": {
    "UseCommonFormat": true,
    "ResetTimeOnAppChange": true,
  }
}

Game Icon databases

• WiiU: Feel free to comtribute to the Game icon database over at Flaming's repo
• PS3: This database is very work in progress, any contributions to the repo are welcome

Acknowledgements

• Zorua98741 Inspiration for this project, and WebManMOD's CPURSX.PS3 scraping idea
• FlamingNineteen His plugin is used to connect to the Wii U as well as his icon database