https://github.com/barrettotte/Plex-Discord-RPC

Use Discord RPC to display local Plex session data.
https://github.com/barrettotte/Plex-Discord-RPC

discord discord-rich-presence discord-rpc node-js plex plex-media-server

Last synced: 4 months ago
JSON representation

Use Discord RPC to display local Plex session data.

• Host: GitHub
• URL: https://github.com/barrettotte/Plex-Discord-RPC
• Owner: barrettotte
• License: mit
• Archived: true
• Created: 2020-04-19T17:40:21.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2024-01-09T17:28:50.000Z (6 months ago)
• Last Synced: 2024-01-16T17:14:55.332Z (6 months ago)
• Topics: discord, discord-rich-presence, discord-rpc, node-js, plex, plex-media-server
• Language: JavaScript
• Homepage:
• Size: 284 KB
• Stars: 8
• Watchers: 3
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-discord-activities - Plex-Discord-RPC - Use Discord RPC to display local [Plex](https://www.plex.tv/) session data. (Media)

README

        
# Plex-Discord-RPC

![docs/watching.png](docs/watching.png)

Use Discord RPC to display local Plex session data.

## Background

I made this for me; it is really only handling my single use case

(Linux environment and a Plex server on local network).

By all means, if someone wants to make this more generic I think they easily could.

But, that's not in the scope for this little side project.

**The only goal is to watch a show on Plex and have it update my Discord activity.**

![docs/status.png](docs/status.png)

## Approach

I just wanted to do something pretty straightforward, so here it is.

- Hit Plex Web API for list of active sessions on server

- Grab local IP and compare to session IP

- Gather session data for current media

- Update Discord activity/status via Discord RPC with media data

- Provide link to Anilist entry if session is watching entry from library 'Anime'

![docs/anilist.png](docs/anilist-link.png)

## Dev Setup

- `npm install`

- rename `config/secrets_template.js` to `config/secrets.js` and configure ([How do I get my Plex token?](https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/))

- `npm run start`

## Run on Startup - Linux + PM2

- install dependencies `sudo npm i pm2@latest -g`

- setup app `pm2 start src/plex_discord_rpc.js`

- save app process `pm2 save`

- enable pm2 to start on boot `pm2 startup`

- view status `pm2 list`

## Run on Startup - Lazy Windows Setup

- There are way better methods to do this, but I'm feeling particularly lazy today; I barely get on Windows anymore.

- Edit **setup/Plex_Discord_RPC.bat** to match current path of repository

- Create shortcut pointing to **setup/Plex_Discord_RPC.bat**

- Copy shortcut to ```%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup```

- If the script fails its not going to start back up. That's another problem for another day.

## References

- [Discord RPC Documentation](https://discord.com/developers/docs/topics/rpc)

- [Unoffical Plex API Documentation](https://github.com/Arcanemagus/plex-api)

- [Plex Icon](https://www.pngkey.com/detail/u2t4o0r5o0e6i1a9_plex-media-server-transparent-plex-icon/)

- [Node.js with systemd](https://nodesource.com/blog/running-your-node-js-app-with-systemd-part-1/)