MangaPresence is a browser extension that, with a node.js server, updates your Discord rich presence based on the manga or anime you're currently reading/watching. Currently MangaPresence is only for windows currently. What sets it apart from other similar anime or manga Discord rich presence applications is its dynamic functionality. It functions seamlessly on most sites right out of the package, and with minimal effort, it can practically work on most websites.

• Size: ~43mb

• MangaPresence
• How to use MangaPresence
  • Install latest release
  • Installing MangaPresence Extension
  • Creating discord bot
• Startup
  • Automatic startup
  • Manual Startup
• Filtering of sites
  • Popup
  • Familiar array
  • Excluded sites
• Customizing Discord Presence Preferences
• Compatibility
• Questions
• Licensing
• Acknowledgement

To use MangaPresence follow these steps:

1. Install latest release

   • You can install latest release of the extension and server in here.

2. Installing MangaPresence Extension

   • Firefox
     • Go to the firefox folder in the extension folder
     • Simply drag and drop the xpi file onto your firefox browser
     • And an prompt will appear, asking if you want to add the extension.
   • Chrome and brave
     • Go to url chrome://extensions/
     • Enable "Developer mode" in the top right corner of the page
     • Click the "Load unpacked"
     • And select the corresponding folder in the extensions folder.

3. Creating discord bot

   To update discord rich presence you need an discord bot and below is instructions to how you can create your own discord bot.

   • Go to here.
   • Create a new application and give it a name that represents your bot.
   • In the sidebar, navigate to the "OAuth2" section.
   • Copy your bot's client ID.
   • Open clientId config file in the server's config folder and put your clientId into the "clientId" key.
   • If you want to show the website icon then you can read instructions in the "Filtering of sites" part. In short you have to send the website icons into your discord bot and include the name in familiarArray so that it can retrieve the icon.

Once you have successfully created your Discord bot and added its client ID to the client Id config file, make sure that your discord is running and then MangaPresence will be ready to function but you might want to change like familiarArray.json or preferences.json that are talked more down on readme.

1. Automatic startup

   If you want that the server starts up on startup you can run "SetServerOnStartup.bat" that will create an shortcut to your start up folder.

2. Manual Startup

   To start the server manually, run the "NoConsole.bat" or "Console.bat" in the "server/startup" folder.

• Popup
  • With popup you can modify familiar sites, excluded sites and preferences without the need of modifying the config files directly.
• Familiar array
  • MangaPresence works primarily by checking the hostnames of the urls and checking if they contain "manga" or "anime". However, you can manually include urls in the familiar array in the configs folder to extend the accuracy of scraping. With familiar array you can include urls, discord images, watch together, query selectors for titles and episodes/chapters, should it show "looking" type sites and should it only scrape websites that have been specified in familiar array. With familiar array you can also include like crunchyroll website even tho it dosent contain "manga" or "anime" in its hostname. I talk little bit more about query selectors in the questions.
• Excluded sites
  • You can exclude domains or subdomains by adding domains to excluded sites in configs folder.

• MangaPresence allows you to modify preferences to tailor your own preferences. To modify them follow the steps below.
  • Go to "configs" folder in the server directory and then find "preferences.json"
  • Inside the JSON file, you'll find sections for different types of states and preferences for them.

   "Manga": {
     "Reading": {
       "details": "Reading {title}",
       "state": "{installment}",
       "buttons": [
         { "label": "Reading", "url": "{siteUrl}" },
         { "label": "Github", "url": "https://github.com/Sandelier/MangaPresence" }
       ]
     }
   }
  

  • The "details", "state" and "buttons" have certain limitations.

    • They have to be fewer then 32 characters, as discord limits them to this length and if you do exceed the limit the program will automatically truncate the content to prevent errors.
    • Maximium of two buttons.

  • If you dont add any content to them then program will default to using the manga or anime title and installment number.

  • You can utilize variables within the "details", "state" and "buttons" to dynamically insert information

    • {title}: Represents the title of the manga or anime you're currently watching. If you have set familiarArray to scrape "Looking" states then it will also show the current website name when in "Looking" state.
    • {installment}: Displays the chapter or episode number if available.
    • {siteUrl}: Provides the url of the current website, suitable for buttons ot link dynamically.

1. Tested on Firefox version 115.0.2
2. Tested on Chrome version 115.0.5790.171
3. Tested on Brave version 1.56.20
4. Tested on Node.js version 18.17.1
5. Made in Node.js version 20.3.1
   • Librarys:
     • discord-rpc - 4.0.1
     • systray - 1.0.5
     • pkg - 5.8.1
     • @angablue/exe - 2.0.2