Open Stremio Links on MPV

A powerful userscript that automatically converts Stremio Web stream links to open directly in MPV player using the mpv-handler protocol.

Features

• Automatic Processing: Seamlessly converts Stremio stream links without user intervention
• MPV Integration: Uses mpv-handler protocol for direct MPV player launch
• Multi-language Support: Available in English, Portuguese (Brazil), and Portuguese (Portugal)
• Quality Control: Configure preferred video quality settings
• Profile Support: Use custom MPV profiles
• Console Options: Choose whether to show MPV console
• Easy Configuration: Access settings through Tampermonkey/Greasemonkey menu
• Real-time Processing: Automatically processes new links as they appear on the page

Requirements

1. MPV Player

Download and install MPV player:

• Windows/macOS/Linux: https://mpv.io/installation/

2. mpv-handler

Install the mpv-handler browser extension (v0.3.15 or later):

• Chrome/Edge: Chrome Web Store
• Firefox: Firefox Add-ons

3. Userscript Manager

Install a userscript manager extension:

• Tampermonkey: Chrome | Firefox
• Greasemonkey: Firefox (Firefox only)

Installation

1. Install Prerequisites: Ensure MPV player, mpv-handler, and a userscript manager are installed
2. Install Script: Click here to install the userscript
3. Confirm Installation: Your userscript manager will prompt you to install the script

Usage

Automatic Operation

The script works automatically once installed:

1. Navigate to Stremio Web: Go to web.stremio.com or stremio.zarg.me
2. Enable M3U Playlist: In Stremio settings, enable the "M3U Playlist" option
3. Click Stream Links: The script automatically converts stream links to MPV protocol
4. Enjoy: Links now open directly in MPV player

Configuration

Access configuration through your userscript manager menu:

Tampermonkey/Greasemonkey Menu Options:

• MPV Settings: Configure script preferences
• Process Links Manually: Force manual processing if needed

Available Settings:

• MPV Profile: Choose MPV profile (default or custom profile name)
• Prefer Video Quality: Select preferred quality (default, 2160p, 1440p, 1080p, 720p, 480p, 360p)
• Run With Console: Show MPV console (yes or no)

Supported Sites

• Stremio Web: web.stremio.com
• Stremio Zarg: stremio.zarg.me

How It Works

1. Link Detection: Monitors the page for Stremio stream links (data URI format)
2. Base64 Decoding: Extracts actual HTTP/HTTPS URLs from encoded data
3. Protocol Conversion: Converts URLs to mpv-handler protocol format
4. Automatic Launch: Clicking converted links opens MPV directly

Troubleshooting

Script Not Working

• Ensure all prerequisites are installed and up-to-date
• Check that "M3U Playlist" option is enabled in Stremio settings
• Try manually processing links via userscript menu

MPV Not Opening

• Verify mpv-handler extension is installed and enabled
• Check MPV player installation
• Try with "Run With Console" enabled to see error messages

Links Not Converting

• Open browser console (F12) to check for error messages
• Ensure you're on a supported Stremio site
• Try refreshing the page

Console Access

Open browser developer console (F12) to see script debug information and processing status.

Technical Details

• Version: 3.9
• mpv-handler Version: v0.3.15
• Supported Browsers: Chrome, Firefox, Edge, Safari (with appropriate userscript managers)
• Dependencies: GM_config library for settings management

Contributing

Contributions are welcome! Please feel free to submit issues, feature requests, or pull requests.

License

MIT License - see the script header for full license text.

Author

Ângelo Azevedo

Changelog

v3.9

• Removed all debug console logs for cleaner operation
• Silent background processing without console pollution

v3.8

• Fixed multiple MPV instances opening on single click
• Added throttling to prevent excessive processing
• Improved event listener management with cloning technique
• Enhanced link processing reliability

v3.7

• Added English menu commands
• Improved user experience

v3.6

• Added Tampermonkey/Greasemonkey menu integration
• Easy access to settings and manual processing

v3.5

• Removed manual control buttons for fully automatic operation
• Streamlined user interface

v3.4

• Removed visual styling of processed links
• Cleaner integration with Stremio interface

v3.3

• Enhanced link processing with better URL conversion
• Improved click handling for MPV protocol

v3.2

• Added visual feedback for processed links
• Enhanced CSS styling and user experience

v3.1

• Improved notification system
• Better debugging capabilities

v3.0

• Complete rewrite with advanced features
• Multi-language support
• MPV icon integration
• Professional configuration interface

Acknowledgments

• Based on the excellent Play with MPV script
• Uses mpv-handler for protocol handling
• Built with GM_config for configuration management