Skip to content

Wifsimster/PlexCord

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PlexCord

Display your Plex music playback as Discord Rich Presence

PlexCord is a lightweight, cross-platform desktop application that bridges your Plex Media Server and Discord, showing what you're listening to in real-time. Built with Go + Vue 3 + Wails.

PlexCord Dashboard

Features

  • 🎵 Real-time Plex music playback detection
  • 💬 Discord Rich Presence integration (track, artist, album, artwork)
  • 🖥️ Cross-platform support (Windows, macOS, Linux)
  • 🔐 Secure credential storage (OS keychain integration)
  • ⚡ Lightweight single binary (<20MB)
  • 🎨 Modern UI with setup wizard
  • 🔄 Auto-recovery on connection loss

Quick Start

Download the latest release for your platform, run the app, and follow the setup wizard to connect Plex and Discord.

Requirements: Plex Media Server with music library + Discord Desktop App

📖 Detailed instructions: Getting Started Guide

Documentation

  • Getting Started - Installation, setup wizard, and troubleshooting
  • Architecture - System design, technology stack, and project structure
  • API Reference - Backend API documentation and error codes
  • Development - Build from source, development workflow, and testing
  • Contributing - How to contribute, coding guidelines, and PR process
  • Roadmap - Feature roadmap, release plan, and version history

Building from Source

# Clone repository
git clone https://github.com/Wifsimster/PlexCord.git
cd PlexCord

# Install dependencies
go mod download
cd frontend && npm install && cd ..

# Development mode with hot reload
wails dev

# Build production binary
wails build

Prerequisites: Go 1.21+, Node.js 18+, Wails CLI

For detailed build instructions and development setup, see the Development Guide.

Contributing

Contributions are welcome! Please read the Contributing Guide for guidelines.

  • Report bugs via Issues
  • Suggest features via Discussions
  • Submit pull requests for improvements

Tech Stack

  • Backend: Go 1.21+
  • Frontend: Vue 3 (Composition API) + PrimeVue + TailwindCSS
  • Framework: Wails v2
  • Discord Integration: rich-go

License

MIT License - see LICENSE for details.

Disclaimer

This project is not affiliated with or endorsed by Plex Inc. or Discord Inc.


Made with ❤️ for music lovers

About

A lightweight Node.js bridge that synchronizes your Plexamp playback status to Discord Rich Presence. Features real-time track metadata, album art support, and playback progress bars.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors