
              ##        #######   ######   ########  ########   ######
              ##       ##     ## ##    ##  ##     ## ##     ## ##    ##
              ##       ##     ## ##        ##     ## ##     ## ##
              ##       ##     ## ##   #### ########  ########  ##
              ##       ##     ## ##    ##  ##   ##   ##        ##
              ##       ##     ## ##    ##  ##    ##  ##        ##    ##
              ########  #######   ######   ##     ## ##         ######

                             Version 2.43 by Logicism
              A Rich Presence program to show your activity on Discord

-------------------------------------------------------------------------------------

Java 8 is required to run this program! You can download these options that can install Java 8 freely:
    - Eclipse Temurin: https://adoptium.net/temurin/releases/?package=jre#version-filter
    - Azul Zulu: https://www.azul.com/downloads/?package=jre#zulu-tab-content
    - BellSoft Liberica: https://bell-sw.com/pages/downloads/?package=jre#downloads
    - Amazon Corretto: https://aws.amazon.com/corretto/

Presence Types:
    Manual:
      - Default (config.yml) w/ Presets
      - Customizable Presence
      - Game Consoles:
          - Nintendo 3DS
          - Wii U
          - Nintendo Switch
          - Nintendo Switch 2
      - PC Games:
          - Overwatch 2 Presence (DISABLED)
      Credits go to:
        ninstar on GitHub for Nintendo Console Discord Presences
        Tominous on GitHub for Overwatch Discord Presence Application IDs
      
    Program (Windows Only):
      Uses Windows User32 Library to grab the current window title and process name that the user is using currently.
      - Adobe (Photoshop, Illustrator, Indesign, After Effects, Premiere Pro, Dreamweaver, Acrobat Reader)
      - Beat Saber
      - Emulators (ares, DeSmuME, DOSBox, FCEUX, Fusion, MAME, melonDS, Mesen, MPC-HC, NO$GBA, SNES9X, VisualBoyAdvance-M)
      - Microsoft Office (Word, PowerPoint, Excel)
      - LibreOffice (Writer, Calc, Impress, Draw, Base, Math)
      - Media Player Classic
      - PotPlayer
      - MAGIX VEGAS Pro 14.0 - 23.0
      - DaVinci Resolve
      - VLC Media Player
      - Zoom Meetings
    Credits go to: 
      MechaDragonX on GitHub for DOSBox, FCEUX, Fusion, SNES9X, VisualBoyAdvance-M, MAME Discord Presence Application IDs
      angeloanan on GitHub for MPC-HC Discord Presence Application IDs
      FizzyApple12 on GitHub for Beat Saber Discord Presence Application IDs
      shadoweG on GitHub for DaVinci Resolve Discord Presence Application IDs

    Music (Windows/macOS):
      Windows: Uses a Python Script with Embedded Python to grab the song information from the Windows Media Control Bar using WinRT API. Artwork is grabbed from TIDAL, and secondarily iTunes.
      For Qobuz Users on Windows, the presence is grabbed through the Window Title using a PowerShell command by it's executable name. This can be set in the config by changing musicWindowTitleGrabbing to true.
        Specific Rich Presence Programs:
        - Amazon Music (does not display Timestamp)
        - Deezer
        - iTunes (iTunes Users should install: https://apps.microsoft.com/detail/9nq3d21qt8ml?hl=en-US&gl=US)
        - Qobuz
        - TIDAL
        Default Rich Presence: Any program that shows information from the Windows Media Control Bar.
      macOS: Uses a TypeScript Script to grab the song information from Apple Music/iTunes. Artwork is grabbed from iTunes.
    Credits go to:
      NextFire on GitHub for the original TypeScript Script Code and Apple Music, iTunes Discord Presence Application IDs
      willf668 on GitHub for the original Python Script Code
      Braasileiro for the Deezer Discord Presence Application ID
      Lockna on GitHub for the Qobuz Discord Presence Application ID
      purpl3F0x on GitHub for the TIDAL Discord Presence Application ID

    Website (Chrome/Firefox Extension):
      Uses the Chrome/Firefox Extension to grab the Website Title, URL and HTML to parse into Discord Presences.
      - Dailymotion
      - Disney+
      - Hulu
      - Instagram
      - Netflix
      - Twitch
      - Twitter
      - Wikipedia
      - YouTube
    Credits go to PreMiD on GitHub for Website Discord Presence Application IDs

    Beat Saber Presence:
      Requires the DataPuller Mod installed from ModAsssistant in order for it to work.
    Credits go to FizzyApple12 on GitHub for Beat Saber Application IDs

    Wiimmfi Mario Kart Wii Presence:
      Uses your browser or a headless proxy server to grab data from Wiimmfi.de

    DeSmuME (Pokémon Gen 4):
      Grabs data from a lua script to track map information on the emulator.
    Supports only Diamond, Pearl, and Platinum ROMs. Credits go to kiwi515 on GitHub for the script

    Nintendo Switch 1/2 Auto Presence:
       Uses the Nintendo Services and nxapi to grab what you are playing on Nintendo Switch.
       You must use a secondary account that is friends with your account to grab the presence.
            If you don't have one, you can make an alt account and add yourself and login to your alt account on the login page.

    Media Player:
        VLC Media Player:
            Grabs media title, uses filename as fallback.
            Uses the Lua HTTP Interface to grab media information, such as play state and position.
        Media Player Classic:
            Uses filename as title.
            Uses the Web Interface to grab media information, such as play state and position.

Placeholders:
    Heart Rate Presence Counter:
      Grabs your current BPM from Pulsoid or HypeRate. Supports many different devices including BLE Monitors and SmartWatches
      Can be used in any presence, just use the variable ${hrRate} and it will show your BPM.
    Credits go to qe201020335 for the HR Counter Code

-------------------------------------------------------------------------------------

                         Windows 11 Music App IDs

The following are the App IDs if you are using the Music Presence. The ID should be specified in "musicProgram" in the config.yml

- Deezer: com.deezer.deezer-desktop
- Amazon Music: Amazon.Music
- TIDAL: com.squirrel.TIDAL.TIDAL
- Qobuz: com.squirrel.Qobuz.Qobuz
- iTunes: 49586DaveAntoine.MediaControllerforiTunes_9bzempp7dntjg!App

-------------------------------------------------------------------------------------

                                Support

Discord Server: https://discord.gg/nStuNeZsWz

If you would like to request a program, game, website or presence to be added, you can join the Discord Server above and then clicking on the role selection LogRPC.

-------------------------------------------------------------------------------------

	                How to install the LogRPC Extension

1. Enable Developer Mode on your Browser (if you are using Firefox, skip to the next step):  Click the menu icon and select Extensions or type in the url above chrome://extensions. Toggle the Developer Mode Option.

2. Load the Unpacked Extension:
  - Chrome (or Chromium Based Browsers): Click on Load Unpacked on the Extensions Page and select the LogRPC Chrome Extension folder.
  - Firefox (or Firefox Based Browsers): Click on the menu icon and select Settings. Click on Extensions & Themes below and then click on   Extensions on the left side panel. Click on the gear on the top right and click Debug Add-Ons. You can also type in the URL about:debugging.   Then click on Load Temporary Add-On and select the manifest.json file in the LogRPC Firefox Extension folder.

3. Test the Presence: Right Click on the LogRPC Program on the taskbar and click on Extension. Your presence should be shown as you visit a page. You may have to reload the page if your browser is already on one.

-------------------------------------------------------------------------------------

		     How to use the headless Wiimmfi Presence

* This is only for users who have set wiimmfiPresenceType to headless. This method does is grab data from a local FlareSolverr proxy server without having to open a browser window. This is only for advanced users, if you rather use your browser window to grab data, follow the instructions above on how to install the LogRPC Extension and then click on the Wiimmfi Presence instead of Chrome.

1. Download and Install FlareSolverr on GitHub and then start the proxy server. https://github.com/FlareSolverr/FlareSolverr

2. Configure the FlareSolverr URL if you are not running it on the same machine as LogRPC.

3. Right Click on the LogRPC Program on the taskbar and click on Wiimmfi. Your presence should be shown as you play on a Worldwide, Continential/Regional, or Private Room.

-------------------------------------------------------------------------------------

		      How to use the DeSmuME Presence Script

1. Open DeSmuME with a Platnium, Pearl or Diamond ROM.

2. Click on Tools and then Lua Scripting then click on New Lua Script Window. Click on Browse and open the export.lua file in the DeSmuME Presence Script file.

3. Right Click on the LogRPC Program on the taskbar and click on DeSmuME. In the DeSmuME Presence Script Folder, a file called out.dat will be generated by the emulator. Open that file in the dialog shown and your presence will be generated.

-------------------------------------------------------------------------------------

		      How to edit the LogRPC Config on macOS Systems

1. Right Click on the LogRPC Application and Click on Show Package Contents.

2. The location of the config is in Contents/Java and there you can open it with TextEdit or your favorite text editor program.

-------------------------------------------------------------------------------------

		      How to use the LogRPC Music Presence on macOS Systems

1. Install Homebrew from brew.sh.

2. In terminal, install Deno with the command "brew install deno".

-------------------------------------------------------------------------------------
