{"id":27133241,"url":"https://github.com/valentin-marquez/vlc-rpc","last_synced_at":"2026-04-18T22:04:45.685Z","repository":{"id":280155578,"uuid":"941144308","full_name":"valentin-marquez/vlc-rpc","owner":"valentin-marquez","description":"🎬 Share your VLC playback on Discord, because your friends totally need to know you're watching Shrek for the 17th time.","archived":false,"fork":false,"pushed_at":"2025-03-27T01:05:58.000Z","size":624,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-27T01:28:17.916Z","etag":null,"topics":["discord","discord-integration","lua","media-player","media-sharing","python","rich-presence","status-updates","vlc","windows-app"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/valentin-marquez.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-01T15:43:48.000Z","updated_at":"2025-03-22T07:02:10.000Z","dependencies_parsed_at":"2025-03-27T01:28:29.084Z","dependency_job_id":"5f551bfd-c71f-4ff5-ab87-2440a978bebc","html_url":"https://github.com/valentin-marquez/vlc-rpc","commit_stats":null,"previous_names":["valentin-marquez/vlc-discord-rp","valentin-marquez/vlc-rpc"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valentin-marquez%2Fvlc-rpc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valentin-marquez%2Fvlc-rpc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valentin-marquez%2Fvlc-rpc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valentin-marquez%2Fvlc-rpc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/valentin-marquez","download_url":"https://codeload.github.com/valentin-marquez/vlc-rpc/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247744533,"owners_count":20988814,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["discord","discord-integration","lua","media-player","media-sharing","python","rich-presence","status-updates","vlc","windows-app"],"created_at":"2025-04-07T23:20:14.047Z","updated_at":"2026-04-18T22:04:45.616Z","avatar_url":"https://github.com/valentin-marquez.png","language":"Python","funding_links":["https://ko-fi.com/nozzdev"],"categories":[],"sub_categories":[],"readme":"# VLC Discord Rich Presence\n\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"resources/icon.png\" alt=\"VLC Discord RP Logo\" width=\"200\" height=\"200\" style=\"border-radius: 10px;\" /\u003e\n\u003c/div\u003e\n\n\u003e *\"Because your friends totally need to know you're watching Shrek for the 17th time.\"*\n\n## What's New in Version 3.0.0\n\n🎉 **Major Update Alert!** 🎉\n\n- **Cross-Platform Support**: Now available for Windows, macOS, and Linux!\n- **Automatic Updates**: Never miss a new feature with our new built-in update system\n- **Smart Content Detection**: Better identification of TV shows, movies, and anime\n- **Activity Type Precision**: Shows \"Listening to\" for music and \"Watching\" for videos\n- **Improved Reconnection Logic**: Automatically reconnects to Discord if connection drops\n- **Enhanced Error Handling**: More robust operation with better recovery from failures\n- **Modern UI**: Sleek, responsive interface with light/dark theme support\n- **Tray Integration**: Keep the app running in the background for seamless tracking\n\n### See It In Action\n\n\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"docs/music detection.png\" alt=\"Music Detection\" width=\"300\" /\u003e\n    \u003cimg src=\"docs/anime detection.png\" alt=\"Anime Detection\" width=\"300\" /\u003e\n    \u003cimg src=\"docs/general media.png\" alt=\"General Media\" width=\"300\" /\u003e\n    \u003cimg src=\"docs/paused detection.png\" alt=\"Paused Detection\" width=\"300\" /\u003e\n\u003c/div\u003e\n\n## What Is This Thing?\n\nVLC Discord Rich Presence is a magical little bridge between your VLC Media Player and Discord, letting your friends see what media you're currently enjoying (or enduring). It shows:\n\n- What you're watching/listening to\n- Artist and album info (for music)\n- Play/pause status\n- Album/media artwork\n- Fancy icons and progress bars\n\nBuilt initially during a questionable 10-hour coding marathon and now significantly improved with proper architecture and planning!\n\n## Installation\n\n### The Easy Way\n\n1. Download the latest installer for your platform from the [releases page](https://github.com/valentin-marquez/vlc-discord-rp/releases)\n- Windows: `vlc-rpc-setup.exe` or `vlc-rpc-portable.exe`\n- macOS: `vlc-rpc.dmg` or `VLC-Discord-RP-arm64-mac.zip` for Apple Silicon\n- Linux: `vlc-rpc_amd64.deb`, `vlc-rpc.x86_64.rpm`, or `vlc-rpc.AppImage`\n2. Run the installer\n3. Follow the on-screen instructions\n4. Enjoy your new Discord flex powers!\n\n### The Hard Way (For Developers)\n\n1. Clone this repo\n2. Install dependencies: `npm install`\n3. Start development server: `npm run dev`\n4. Build for production: \n   - Windows: `npm run build:win`\n   - macOS: `npm run build:mac`\n   - Linux: `npm run build:linux`\n\n## How It Works\n\n1. The application connects to VLC's Web Interface (automatically enabled if needed)\n2. Media information is retrieved via HTTP requests to `http://localhost:{port}/requests/status.json`\n3. Advanced content detection identifies what you're watching\n4. Album artwork and media metadata are extracted and formatted\n5. This information is relayed to Discord's Rich Presence API\n6. Social validation achieved! 🎉\n\n## FAQ\n\n### Q: Why isn't anything showing up in Discord?\n**A:** Make sure:\n1. Both VLC and Discord are running\n2. VLC's Web Interface is enabled (the app should enable this automatically)\n3. You're playing a media file\n4. Check the app for status information\n5. If issues persist, try the reconnect button in settings\n\n### Q: How do I close/exit the app?\n**A:** Right-click the app icon in your system tray (Windows/Linux) or menu bar (macOS) and select \"Exit\". Or use the close button in the main window.\n\n### Q: Where is it installed?\n**A:** Default installation locations:\n- Windows: `%LOCALAPPDATA%\\VLC Discord RP`\n- macOS: `/Applications/VLC Discord RP.app`\n- Linux: `/opt/vlc-discord-rp` or `/usr/bin/vlc-discord-rp`\n\n### Q: Does it work on Mac/Linux?\n**A:** Yes! Version 3.0 fully supports Windows, macOS, and Linux with native installers for each platform.\n\n### Q: How much of my privacy am I giving up?\n**A:** Only the title, artist, album info, and cover art from your media files are shared - and only with your Discord friends. We don't collect any data. Also, you can pause the sharing via the tray/menu bar icon.\n\n### Q: I found a bug!\n**A:** That's not a question, but I respect your enthusiasm. Please open an issue on GitHub with details about what went wrong.\n\n### Q: Will this get me banned from Discord?\n**A:** No! This app uses Discord's official Rich Presence API which is designed exactly for this purpose.\n\n### Q: Why did you make this?\n**A:** The voices told me to. Also, it seemed like a fun project.\n\n## Support The Project\n\nIf you enjoy this app and want to support its development, consider buying me a coffee:\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/nozzdev)\n\n## Development Notes\n\nThis project has evolved from a sleepless-night hack to a robust application with:\n- Cross-platform compatibility\n- Proper error handling\n- System tray/menu bar integration\n- Web interface utilization\n- Cover art extraction and display\n- Automatic updates\n\nPull requests are welcome if you want to help improve things further!\n\n## License\n\nMIT License - Feel free to use, modify, and distribute as you see fit.\n\n---\n\n*Made with ❤️ and significantly less sleep deprivation this time*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvalentin-marquez%2Fvlc-rpc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvalentin-marquez%2Fvlc-rpc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvalentin-marquez%2Fvlc-rpc/lists"}