mpv-discordRPCX

An mpv plugin for displaying currently playing media on Discord
Forked from mpv-discordRPC

Credits • Key Features • How To Use • Configuration • License

Credits

This project is a fork of ujjwal-dev23/mpv-discordRPC, the original author who developed the core codebase and maintained the plugin after forking from cniw/mpv-discordRPC.

Bruuhim (Maintainer): Performed major modifications and improvements, including:

• 🔥 Universal Season Matching: Automatically detects and displays correct seasons for ANY anime series (S2, S3, etc.) without manual configuration.
• Automatic Anime Title Detection: Extracts and cleans anime titles from parent folder names for accurate API lookups.
• Episode Extraction: Reliably parses episode numbers and titles from video filenames (e.g., "03 - Everyday Life Under Dangerous Circumstances").
• Enhanced Cover Art: Improved fetching of official anime posters via Jikan API metadata, prioritizing anime-matched images.
• Debug Logging: Added comprehensive terminal output for troubleshooting extraction and API calls.
• Stability Fixes: Resolved Lua pattern matching errors and enhanced script reliability.

Changelog:

• v1.4.3: 🔥 Added Universal Season Matching - automatic season detection for ANY anime (2025).
• v1.4.2: Lua pattern fixes, debug logging, improved anime detection (2023-2025).
• v1.4.1: Original release by ujjwal-dev23 with initial anime scraping.
• Initial: Based on cniw's plugin.

For feature requests or issues, please open a GitHub issue on this repository.

Key Features

• 🔥 Universal Season Matching: Automatically detects and displays the correct season (S2, S3, etc.) for ANY anime without manual configuration
• Can fetch cover art for Music or Anime
• Support for http streams in Rich Presence
• Metadata tags (Title, Artist, Album, Genre)
• Icons for playing, paused, and buffering
• Supports Windows, Mac, and Linux
• Easy to use install script
• Support for multiple rpc wrappers
• Simple configuration file

🔥 Universal Season Matching

The script now features bulletproof universal season matching that works with ANY anime series automatically:

Supported Examples:

• KonoSuba S2 → Automatically detects "KonoSuba: God's Blessing on This Wonderful World! 2"
• Hibike! Euphonium S2 → Automatically detects "Sound! Euphonium 2"
• Attack on Titan S4 → Automatically detects "Attack on Titan: The Final Season"
• Re:Zero S2 → Automatically detects "Re:Zero - Starting Life in Another World Season 2"
• My Hero Academia S6 → Automatically detects "My Hero Academia Season 6"
• Demon Slayer S3 → Automatically detects "Demon Slayer: Kimetsu no Yaiba Swordsmith Village Arc"

How It Works:

1. Intelligent Filename Parsing: Supports all naming conventions (dots, dashes, brackets, groups, etc.)
2. Season Detection: Automatically extracts season information from filenames (S2, Season 2, 2nd Season, etc.)
3. API Matching: Uses advanced scoring algorithms to find the exact season match
4. Fallback System: Gracefully falls back to best available match if perfect match isn't found

Robust Filename Support:

• [Group] Anime Title - S02E03.mkv ✅
• Anime Title Season 2 - 03.mkv ✅
• Anime Title 2nd Season E03.mkv ✅
• Anime Title S2 - Episode 03.mkv ✅
• Anime.Title.S02.E03.1080p.mkv ✅
• Works with any fansub group naming convention

How To Use

Dependencies

1. Provided by user: mpv, Discord
2. Included: Discord RPC, status-line,lua-discordRPC
3. Optional: Python, pypresence

# Clone the repository
git clone https://github.com/ujjwal-dev23/mpv-discordRPC.git
cd mpv-discordRPC.git

# Use the appropriate install script
install-linux.sh
install-win.bat
install-osx.sh

Configuration

rpc_wrapper=lua-discordRPC
# Available option, to set `rpc_wrapper`:
# * lua-discordRPC
# * python-pypresence

periodic_timer=15
# Recommendation value, to set `periodic_timer`:
# value >= 1 second, if use lua-discordRPC,
# value >= 3 second, if use pypresence (for the python3::asyncio process),
# value <= 15 second, because discord-rpc updates every 15 seconds.

playlist_info=yes
# Valid value to set `playlist_info`: (yes|no)

hide_url=no
# Valid value to set `hide_url`: (yes|no)

loop_info=yes
# Valid value to set `loop_info`: (yes|no)

cover_art=yes
# Valid value to set `cover_art`: (yes|no)

mpv_version=yes
# Valid value to set `mpv_version`: (yes|no)

active=yes
# Set Discord RPC active automatically when mpv started.
# Valid value to `set_active`: (yes|no)

key_toggle=D
# Key for toggle active/inactive the Discord RPC.
# Valid value to set `key_toggle`: same as valid value for mpv key binding.
# You also can set it in input.conf by adding this next line (without double quote).
# "D script-binding mpv_discordRPC/active-toggle"

anime_scraping=yes
# Enables scraping of anime cover art, titles, and genres from Jikan API
# Valid values to set `anime_scraping`: (yes|no)

You may also like...

• cniw/mpv-discordRPC - The source of this fork
• noaione/mpv-discordRPC - The original script that was the source of the source of this fork

License

MIT

---