Stremio Desktop app with the latest Stremio web UI v5, built with WebView2
Upscaler Comparison
Anime4k + Auto HDR vs Offical Stremio v5.
Thumbnail Previews
Best on local files using thumbfast. Size can be adjusted.
Discord Rich Presence
Live activity like Discovering, Watching, or Paused updates in real-time.
## π§ Installation 1. πͺ **Windows x64 and x86** 1. π₯ **Installer** - **Install using the** `Installer`. Download `stremio-5.0.0-x64.exe` or `stremio-5.0.0-x86.exe` and run it. 2. πΌ **Portable Version** - **Install using the** `Archive`. Download `stremio-5.0.0-x64.7z` or `stremio-5.0.0-x86.7z` extract it and run `stremio.exe` 3. π₯ **Scoop.sh** ```shell # Install scoop bucket add zarg https://github.com/zaarrg/scoop scoop install stremio-desktop-v5 # Update scoop update zarg scoop update stremio-desktop-v5 # Uninstall scoop uninstall stremio-desktop-v5 ``` 4. π« **Chocolatey** ```shell # Install choco install stremio-desktop-v5 -y # Update choco upgrade stremio-desktop-v5 -y # Uninstall choco uninstall stremio-desktop-v5 -y ``` > **β³ Note:** If you have stremio-desktop v4.x.x installed make sure to uninstall it first. Otherwise there might be issues. 2. π **Linux, macOS** - Coming soon! > **β³ Note:** Linux and Mac release will take considerable time as they need their own build with os specific technology's ## π **Mpv Upscalers** - π₯ **[Anime4k](https://github.com/bloc97/Anime4K)** - β Included by default. - π’ Use `CTRL+1` - `CTRL+6` to enable shaders. - β Use `CTRL+0` to disable. - π¨ **[AnimeJaNai](https://github.com/the-database/mpv-upscale-2x_animejanai)** - β Not included by default. - π₯ Download from the **Stremio-Desktop-v5** [release tab](https://github.com/Zaarrg/stremio-desktop-v5/releases/5.0.0-beta.7) the `stremio-animejanai-3.x.x.7z` for Stremio and drop the content of the 7z into `%localAppData%\Programs\LNV\Stremio-5\` and `replace all` - π οΈ **Changes made:** - Removed `mpvnet.exe` as Stremio is used as the player. - Adjusted `mpv.conf` to work with Stremio. - Adjusted `input.conf` to work with Stremio. - β¨οΈ **Possible Keybindings** - π¬ `CTRL+J` Show Upscaler Status - π οΈ `CTRL+E` Open AnimeJaNai ConfEditor - β `CTRL+0` Disable Upscaling - π’ `SHIFT+1` - `SHIFT+3` Select Quality, Balanced or Performance Profiles - βοΈ `CTRL+1` - `CTRL+9` Switch between Custom Profiles - π For more, check [AnimeJaNai](https://github.com/the-database/mpv-upscale-2x_animejanai) > **β³ Note:** When using AnimeJaNai on first playback Stremio will be unresponsive and a console will open to build the model via e.g. TensorRT. You will need to wait until the console closes for playback to start. This happens only once per model. - π **Nvidia RTX and Intel VSR Scaling** - β Supported by using `mpv.conf`. - βοΈ Modify in `%localAppData%\Programs\LNV\Stremio-5\` the ``portable_config/mpv.conf`` and add the line ``vf=d3d11vpp=scale=2:scaling-mode=nvidia`` more details [here](https://www.reddit.com/r/nvidia/comments/1foyl4n/mpv_player_v0390_adds_rtx_video_super_resolution/) ## π **Mpv Addons** - π₯ **[ThumbFast](https://github.com/po5/thumbfast)** - π§ Go in the `Stremio-Dekstop-v5` Repo to ``utils/mpv/thumbfast`` or [direct-link](https://github.com/Zaarrg/stremio-desktop-v5/tree/webview-windows/utils/mpv/thumbfast) and download ``thumbfast.7z``. Drag and Drop the archive contents into ``%localAppData%\Programs\LNV\Stremio-5`` - π Works best with local files as there is no **network bottleneck**. U can `Drag and Drop` any local file into **Stremio** or right click ``Open With > Stremio`` > **β³ Note:** For more details visit [mpv-portable-configs](https://github.com/Zaarrg/stremio-desktop-v5/blob/webview-windows/utils/mpv/README.md) ## β¨ **Stremio App** - π **Local Files** - Play any **local file** or **torrent** by `drag and dropping` or ``Open With > Stremio`` that mpv and ffmpeg support - Play any **magnet** by `opening it via the browser` in Stremio or `copy pasting` it into the **Search Bar** - 𧩠**Browser Extensions** - Add any Browser Extension to Stremio by dropping the ``unpacked`` Extension into ``portable_config/extensions`` - On Start Extensions from ``portable_config/extensions`` are loaded. - π **To install extension:** 1. Get the ``unpacked`` Extensions from``%localAppData%\Microsoft\Edge\User Data\Default\Extensions``. 2. Here look for the `mainfest.json` for example ublock `{string-id}/1.62.0_0/manifest.json` as all the content beside is the extension 3. Now we can copy the contents of ``{string-id}/1.62.0_0`` to ``%localAppData%\Programs\LNV\Stremio-5\portable_config\extensions\ublock`` 4. Important is that the ``mainfest.json`` is located directly in ``portable_config\extensions\ublock`` 5. **Done**. Restart app and addons will be loaded. If loading fails check ``portable_config\errors-{date}.txt`` - **Supported Extensions**: Some extension need support added manually. These extension can be downloaded [here](https://github.com/Zaarrg/stremio-desktop-v5/tree/webview-windows/extensions). - βοΈ **App Settings** - **All App Settings** can be adjusted with ``portable_config\stremio-settings.ini`` - Some options can be set by `right-clicking` on the **tray icon** as well. - β¨οΈ **Possible Settings** - β ``CloseOnExit`` Close app on exit instead of minimized to tray - π ``UseDarkTheme`` Toggle dark theme - π ``ThumbFastHeight`` Enable thumbfast and set the thumbfast image height. This adjust the offset of the top left corner of the thumb. Meaning `100` will move the top left corner 100px up. `0` disables thumbfast - π΄ ``PauseOnMinimize`` Pause playback on window minimize - π ``PauseOnLostFocus`` Pause playback on window loses focus - π ``AllowZoom`` Allow zoom via `pinch action` or ``CTRL+Scroll`` - β **App Errors & Troubleshooting** - π **Quick Fixes for Common Issues** 1. **Try F5 first** - Refreshes the page and fixes many display issues 2. **Try Ctrl+F5** - Clears cache and fixes persistent problems (including volume slider) 3. **Restart the app** - Close completely via Task Manager and restart 4. **Reboot PC** - Fixes sleep-related streaming server issues - π **App Won't Start / Instantly Closes** - **Check error logs:** ``portable_config\errors-{date}.txt`` for specific error messages - **WebView2 Issues:** - β **[WebView2](https://developer.microsoft.com/en-us/microsoft-edge/webview2/) not installed** β Most common startup issue - Download from [Microsoft WebView2 Runtime](https://developer.microsoft.com/en-us/microsoft-edge/webview2/) - Install the "Evergreen Standalone Installer" - Restart computer after installation - π **WebView2 corrupted:** Uninstall from "Add or Remove Programs" and reinstall - π« **Antivirus blocking:** Add Stremio folder to antivirus exclusions - **Configuration Issues:** - βοΈ **Invalid ``stremio-settings.ini``:** Delete file and restart (default will be created) - πΊ **Invalid MPV config:** Try deleting ``mpv.conf``, ``input.conf`` temporarily - 𧩠**Extension conflicts:** Move extensions out of ``portable_config\extensions`` to test - β« **Black Screen Issues** - **First try:** Press **F5** to refresh the page - **If F5 doesn't work:** Press **Ctrl+F5** to clear cache (also fixes volume slider) - **For persistent issues, add to ``mpv.conf``:** ```shell vo=gpu # Try one of these GPU settings: gpu-api=vulkan # OR gpu-api=opengl ``` - **WebView2 GPU conflicts:** Run from Command Prompt: ```shell cd %localAppData%\Programs\LNV\Stremio-5\ set WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--disable-gpu stremio.exe ``` - **Alternative WebView2 fixes:** ```shell set WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--use-angle=opengl # OR try these: --use-angle=swiftshader --use-angle=vulkan --use-angle=d3d11 --disable_direct_composition_video_overlays=1 ``` - π΅ **Volume Control Not Working** - **Quick fix:** Press **Ctrl+F5** to refresh and clear cache - **Alternative:** Close video, restart app, try again - **Check:** Windows audio mixer - ensure Stremio isn't muted - π± **"Device suddenly not support stream" Error** - **Immediate fix:** Restart the application completely - **Root cause:** Occurs after computer sleep/hibernate - **Prevention:** Restart Stremio after waking computer from sleep - **Check streaming server status:** Go to Settings > Streaming tab - **Server should show:** Status "Online" - **If offline:** Use Task Manager to close all Stremio processes, then restart - π **Web UI Connection Issues** - **Cannot reach Web UI:** Verify you can access the web interface hosted [here](https://zaarrg.github.io/stremio-web-shell-fixes/) - **Streaming server offline:** Check Settings > Streaming - should show "Online" - **Port conflicts:** Another Stremio instance might be running - check Task Manager - **After sleep mode:** Always restart Stremio after computer wake-up - π **Performance Issues** - **High CPU/Memory:** - Close other applications - Reduce ``ThumbFastHeight`` setting or set to ``0`` - Update graphics drivers - **Stuttering/Buffering:** - Try different GPU settings in ``mpv.conf`` - Check available storage space - Disable browser hardware acceleration if conflicts occur - π§ **Advanced Troubleshooting** - **Complete reinstall:** 1. Uninstall app completely with user data 2. Verify ``%localAppData%\Programs\LNV\Stremio-5\`` is empty 3. Manually delete ``%temp%\stremio_updater`` if needed 4. Reinstall fresh copy - **Cache issues:** Try Ctrl+F5 refresh to clear WebView2 cache - **Multiple instances:** Use Task Manager to ensure no other Stremio processes - π **Log File Locations** - **Main errors:** ``portable_config\errors-{date}.txt`` - **MPV logs:** ``portable_config\mpv-log.txt`` (if logging enabled) - **Extension logs:** Check individual extension folders - **Windows logs:** Event Viewer > Application logs (search "Stremio") - π **Reporting Issues** - Include error log from ``portable_config\errors-{date}.txt`` - Specify Windows version and graphics card - Mention if issue occurs after sleep/wake cycle - Note which F5/Ctrl+F5 method worked (if any) - List recently changed settings or installed extensions ## ποΈ **Mpv Configuration** Enhance your Stremio experience by customizing the MPV player settings. Below are the key configuration files and guidelines to help you get started: - π **`mpv.conf` Location** - The ``mpv.conf`` file can be found in the following location: - **Installation Path:** ``%localAppData%\Programs\LNV\Stremio-5\portable_config\mpv.conf`` - **Shaders Folder:** Located within the installation directory ``..\Stremio-5\portable_config\shaders``. - **Latest Portable Config:** Latest portable config can be found [here](https://raw.githubusercontent.com/Zaarrg/stremio-desktop-v5/webview-windows/utils/mpv/Default%20Portable%20Config.7z). - **πΉ Usage example of `mpv.conf` for DV Content:** ```shell # MPV Conf for DV Content vo=gpu-next gpu-api=vulkan target-colorspace-hint=yes ``` > **β³ Note:** Any other configuration files can be just dropped into ``%localAppData%\Programs\LNV\Stremio-5\portable_config`` as this is the mpv ``config-dir`` like ``input.conf``. ``scripts`` or ``scripts-conf`` - **πΉ Usage example in `input.conf` using [Anime4k](https://github.com/bloc97/Anime4K):** ```shell # Optimized shaders for higher-end GPU CTRL+1 no-osd change-list glsl-shaders set "~~/shaders/Anime4K_Clamp_Highlights.glsl;~~/shaders/Anime4K_Restore_CNN_VL.glsl;~~/shaders/Anime4K_Upscale_CNN_x2_VL.glsl;~~/shaders/Anime4K_AutoDownscalePre_x2.glsl;~~/shaders/Anime4K_AutoDownscalePre_x4.glsl;~~/shaders/Anime4K_Upscale_CNN_x2_M.glsl"; show-text "Anime4K: Mode A (HQ)" CTRL+2 no-osd change-list glsl-shaders set "~~/shaders/Anime4K_Clamp_Highlights.glsl;~~/shaders/Anime4K_Restore_CNN_Soft_VL.glsl;~~/shaders/Anime4K_Upscale_CNN_x2_VL.glsl;~~/shaders/Anime4K_AutoDownscalePre_x2.glsl;~~/shaders/Anime4K_AutoDownscalePre_x4.glsl;~~/shaders/Anime4K_Upscale_CNN_x2_M.glsl"; show-text "Anime4K: Mode B (HQ)" CTRL+3 no-osd change-list glsl-shaders set "~~/shaders/Anime4K_Clamp_Highlights.glsl;~~/shaders/Anime4K_Upscale_Denoise_CNN_x2_VL.glsl;~~/shaders/Anime4K_AutoDownscalePre_x2.glsl;~~/shaders/Anime4K_AutoDownscalePre_x4.glsl;~~/shaders/Anime4K_Upscale_CNN_x2_M.glsl"; show-text "Anime4K: Mode C (HQ)" CTRL+4 no-osd change-list glsl-shaders set "~~/shaders/Anime4K_Clamp_Highlights.glsl;~~/shaders/Anime4K_Restore_CNN_VL.glsl;~~/shaders/Anime4K_Upscale_CNN_x2_VL.glsl;~~/shaders/Anime4K_Restore_CNN_M.glsl;~~/shaders/Anime4K_AutoDownscalePre_x2.glsl;~~/shaders/Anime4K_AutoDownscalePre_x4.glsl;~~/shaders/Anime4K_Upscale_CNN_x2_M.glsl"; show-text "Anime4K: Mode A+A (HQ)" CTRL+5 no-osd change-list glsl-shaders set "~~/shaders/Anime4K_Clamp_Highlights.glsl;~~/shaders/Anime4K_Restore_CNN_Soft_VL.glsl;~~/shaders/Anime4K_Upscale_CNN_x2_VL.glsl;~~/shaders/Anime4K_AutoDownscalePre_x2.glsl;~~/shaders/Anime4K_AutoDownscalePre_x4.glsl;~~/shaders/Anime4K_Restore_CNN_Soft_M.glsl;~~/shaders/Anime4K_Upscale_CNN_x2_M.glsl"; show-text "Anime4K: Mode B+B (HQ)" CTRL+6 no-osd change-list glsl-shaders set "~~/shaders/Anime4K_Clamp_Highlights.glsl;~~/shaders/Anime4K_Upscale_Denoise_CNN_x2_VL.glsl;~~/shaders/Anime4K_AutoDownscalePre_x2.glsl;~~/shaders/Anime4K_AutoDownscalePre_x4.glsl;~~/shaders/Anime4K_Restore_CNN_M.glsl;~~/shaders/Anime4K_Upscale_CNN_x2_M.glsl"; show-text "Anime4K: Mode C+A (HQ)" CTRL+0 no-osd change-list glsl-shaders clr ""; show-text "GLSL shaders cleared" ``` > **β³ Note:** Some keys might not work as key presses are converted from js event.codes to literal values for mpv - **π‘ Subtitle Customization:** - Subtitles can be full customized in the ``mpv.conf`` by adding the following: ```shell # Adjust as needed - sub-font="Comic Sans MS" osd-font="Comic Sans MS" osd-font-size=43 sub-font-size=43 sub-color=#e1fe00 sub-font-size=43 sub-color=#ffffff sub-font-size=43 sub-border-color=#000000 sub-border-size=2 sub-shadow-offset=1 sub-shadow-color=#000000 sub-spacing=0 sub-margin-y=41 sub-line-spacing=0 ass-line-spacing=0 # To overwrite .ass subs use sub-ass=no or just use F2 to cycle subtitle modification levels ``` - Stremio by default overwrites the following: ```shell # These 3 options are set using the web ui under the settings page 'subtitlesTextColor': 'sub-color', 'subtitlesBackgroundColor': 'sub-back-color', 'subtitlesOutlineColor': 'sub-border-color', # Affected mpv sub settings by this are: sub-color sub-back-color # + Alias sub-shadow-color sub-border-color # + Alias sub-outline-color # All these need to be set via the web ui instead ``` ## βοΈ **Start Arguments** Use these extra arguments when launching the application: | Argument | Example | Description | |-----------------------------|-------------------------------------------------------|-----------------------------------------------------------------------------------------------------------| | --webui-url= | --webui-url=https://web.stremio.com/ | Loads web ui from `https://web.stremio.com/` | | --streaming-server-disabled | | Disable auto start of `streamio-server`, Default behaviour in prod | --autoupdater-force-full | | Forces Autoupdate to always do a `full-update` rather than `partial` | | --autoupdater-endpoint= | --autoupdater-endpoint==https://verison.mydomain.com/ | Overrides default checking endpoint for the autoupdater | > **β³ Note:** By default will use as ``webui-url`` the [stremio-web-shell](https://github.com/Zaarrg/stremio-web-shell-fixes) web-ui hosted [here](https://zaarrg.github.io/stremio-web-shell-fixes/#/) which includes fixes to run smoothly as shell with qt6 and WebView2 ## π **Guide / Docs** If you want to build this app yourself, check the β[docs](https://github.com/Zaarrg/stremio-desktop-v5/tree/master/docs)β folder in this repository for setup instructions and additional information. ## β οΈ **Disclaimer** This project is not affiliated with **Stremio** in any way. This fork is provided solely for educational and lawful use. **It does not support piracy or any form of copyright infringement.** It is the userβs responsibility to ensure that any content accessed is fully compliant with the DMCA and all applicable copyright laws. The project maintainers do not condone or support any illegal activities. ## π€ **Support Development** If you enjoy this project and want to support further development, consider [buying me a coffee](https://ko-fi.com/zaarrg). Your support means a lot! β
β Made with β€οΈ by Zaarrg β