Creepso/stremio-community-v5
1
0
Fork 0
mirror of https://github.com/Zaarrg/stremio-community-v5.git synced 2026-05-07 18:49:52 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
stremio-community-v5/README.md
Salim Mohamed 97bdec77d5 Expanded App section with comprehensive guide
2025-06-03 22:10:01 -07:00

23 KiB
Raw Blame History

Stremio Web Desktop Logo

🌌 Stremio Desktop
Community

Stremio Desktop app with the latest Stremio web UI v5, built with WebView2

C++ WebView2 MPV Win32

Scoop Chocolatey Streaming Torrents

🌟 Features

  • 🚀 Latest Technology: Built with WebView2 to provide the newest features and best performance
  • 🌐 Latest Web Ui: Always up-to-date with Stremio Web v5
  • 🎞️ Native Playback: Integrated Player for native 4K playback, hardware decoding, and fastest video performance
  • 🔍 Video Upscaling: Upscaling support for anything mpv supports
  • 🎥 Full MPV Support: Full MPV support use any hwdec, gpu-api or gpu-context like d3d, opengl and vulkan
  • 🌈 HDR Support: Full HDR Support thanks to fully supported mpv and any other mpv feature
  • 🔊 Dolby Atmos Support: Support for all mpv advanced audio features.
  • 🖼️ Picture in Picture: Picture in Picture Mode Support
  • 🌑 Dark Mode: Windows Dark mode support
  • 💬 Discord Rich Presence: Show what you're watching in real-time on your Discord profile
  • 🖼️ Thumbnail Preview: ThumbFast support to allow for preview thumbnails when seeking
  • 📁 Local File Playback: Play any file MPV and ffmpeg supports, just use open with 'stremio' or drag and drop
  • 🔡 Local Subtitles: Add any Subtitle file using drag and drop while playing a video
  • 🎨 Advanced Subtitles Styles: Style subtitles any way you like using mpv configuration
  • 📌 Advanced Auto Selection: Select multiple default Subtitle, Audio tracks as well as Subtitle Keywords to prioritize and filter out unwanted languages
  • 🌀 Torrent Support: Play any local .torrent file or any magnet: link
  • 📺 Chromecast Support: Cast Videos to your Chromecast
  • ➕ Easy Addon Install: Just use the install Button like stremio v4, no need to copy paste urls
  • 💼 Portable Version: Fully portable version including WebView2.
  • ⚙️ App Settings: Customize options like CloseOnExit, PauseOnMinimize, and PauseOnLostFocus and more.
  • 🔄 Built-in Autoupdate: Built-in autoupdater. No need to always download from GitHub.
  • 📦 Scoop and Chocolatey: Support for Scoop and Choco for ease of use.

Stremio Web Desktop Screenshot

🎭 Comparison

  • A side-by-side visual comparison of various features and enhancements in Stremio Desktop v5. Due to this being screenshots, HDR appears over-exposed.

Upscaler Comparison

Stremio Web Desktop Screenshot

Anime4k + Auto HDR vs Offical Stremio v5.

Thumbnail Previews

Descriptive Alt Text

Best on local files using thumbfast. Size can be adjusted.

Discord Rich Presence

Discord Rich Presence Example

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 
      # 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 
      # 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.

  1. 🚀 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

    • ✅ Included by default.
    • 🔢 Use CTRL+1 - CTRL+6 to enable shaders.
    • ❌ Use CTRL+0 to disable.

  • 🎨 AnimeJaNai

    • ❌ Not included by default.
    • 📥 Download from the Stremio-Desktop-v5 release tab 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

⏳ 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

🔍 Mpv Addons

  • 🎥 ThumbFast
    • 🔧 Go in the Stremio-Dekstop-v5 Repo to utils/mpv/thumbfast or direct-link 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

✨ 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.

  • ⚙️ 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 not installed – Most common startup issue
        • 🔄 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: 
        vo=gpu
# Try one of these GPU settings:
gpu-api=vulkan
# OR
gpu-api=opengl
      • WebView2 GPU conflicts: Run from Command Prompt: 
        cd %localAppData%\Programs\LNV\Stremio-5\
set WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--disable-gpu
stremio.exe
      • Alternative WebView2 fixes: 
        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
      • 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.

  • 🎹 Usage example of mpv.conf for DV Content:

    # 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: 
    # 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: 
      # 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: 
          # 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 web-ui hosted here 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” 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. Your support means a lot! ☕

Support me on Ko-fi

⭐ Made with ❤️ by Zaarrg ⭐