A custom Stremio + MPV build that makes anime look and feel amazing—even on modest hardware.
- 🧱 Stremio Community v5 Base: Fast, open-source, and actively maintained
- 🖥️ Windows Desktop App: Portable, self-contained, and install-free
- 🌐 WebView2 Engine: Always up-to-date with the latest Stremio Web UI
- 🔄 Built-in Autoupdate: No manual updates—just launch and go
- 🧠 Full MPV Integration: Native playback with full config access
- 🖥️ Hardware Decoding: Supports Vulkan, OpenGL, D3D, and HDR
- 🔊 Bit-Perfect Audio: Dolby Atmos, DTS-HD, and lossless passthrough
- 🎨 Anime4K Shader Presets: Custom chains for upscaling, line thinning, and denoise
- ⏩ SVP Motion Interpolation: Smooth playback with fallback logic and cleanup
- 🔄 Auto Profile Switching: Detects resolution, language, and HDR
- 🔡 Smart Subtitle Selector: Filters out karaoke, signs, and junk tracks
- ⏭️ Smart Skip: Detects and skips intros, outros, and previews
- ⚡ Reactive VF Bypass: Prevents lag during seeks by temporarily disabling filters
- 🧹 SVP Cleanup: Clears filters between episodes to prevent crashes
- 📦 Drag-and-Drop Playback: Supports any file MPV can handle
- 🔠 Local Subtitles: Add external subs (.srt, .ass) with drag and drop
- 🎨 Subtitle Styling: Customize fonts, colors, and positioning via MPV
- 🌀 Torrent Support: Play
.torrentfiles and magnet links directly
- ➕ One-Click Addon Install: No copy-pasting URLs
- 📦 AIOstreams Template: Helps pick the best source for your setup
- 💬 Discord Rich Presence: Show what you're watching in real-time
- 📺 Picture-in-Picture Mode: Multitask while watching
- 🖼️ Thumbnail Preview: Thumbfast support (partially functional)
- ⚙️ App Settings: Customize behavior like PauseOnMinimize, CloseOnExit, etc.
Why fuss with manual tweaks? Stremio Kai's scripts think for you, detecting content type and applying perfect settings automatically. It knows if you're binging anime or a movie, picks the right subtitles, and skips intros like Netflix—freeing you to relax.
This is what elevates the project from a simple configuration to a complete, intelligent system. Each component was custom-built or meticulously tuned to solve real-world frustrations and deliver the ultimate anime viewing experience.
The core of Stremio Kai is a visual pipeline engineered for anime, delivering breathtaking clarity and fluid motion without requiring a high-end PC.
This is the heart of the project's visual philosophy. It's a curated collection of advanced shaders and carefully tuned profiles that work together to upscale, sharpen, and denoise content in real-time. Forget blurry, low-resolution anime; this suite ensures every frame is clean, sharp, and perfectly optimized for your display, from vintage 480p classics to modern 1080p releases.
| Profile Name | Content Type | Core Function |
|---|---|---|
| [anime-sdr] | Standard Definition (SD) & High Definition (HD) Anime | Enables the full suite of enhancements: SVP motion smoothing, Anime4K upscaling, and the custom anime audio mix. |
| [anime-hdr] | High Dynamic Range (HDR) Anime | Builds on the anime profile but adds true HDR passthrough for vibrant colors an brightness on compatible displays. |
| [anime-old] | Legacy & Interlaced Anime (480i, 576i) | A special profile for older shows. It enables a high-quality deinterlacer (bwdif) to fix visual combing artifacts before sending it to the SVP engine. |
| [hdr] | HDR Movies & TV Shows | A minimalist profile designed for cinematic HDR content. It disables anime-specific shaders and enables pure HDR passthrough for a true-to-source experience. |
| [sdr] | SDR Movies & TV Shows | The default for all non-anime, non-HDR content. Uses high-quality scaling algorithms and a cinematic audio mix. |
You never need to touch these, but it helps to know how Stremio Kai selects and defines its view. Advanced users can fine-tune the specific settings for each of these profiles directly in the mpv.conf file.
A collection of advanced, real-time shaders designed to upscale, clean, and refine anime for high-resolution displays.
Bring your favorite anime into the 4K era with the powerful Anime4K shader suite pre-installed and expertly configured.
- Pre-Tuned Presets: No need to mess with individual shader files. Several high-quality shader chains have been curated into easy-to-use presets, accessible via simple hotkeys.
- Optional Denoise: A gentle denoise shader (denoise3.glsl) is enabled by default on anime profiles. It's a subjective touch that softens shadows and adds a subtle sense of depth. If you prefer a sharper image, it can be disabled with a single key press (see the cheatsheet below) or permanently through the mpv.conf file.
- Much of the anime we love wasn't created for modern 4K screens. When stretched to fit these displays, older or lower-resolution content can look soft, blurry, or washed out. You also see distracting artifacts like color banding in gradients and compression noise (mosquito noise) in dark areas, which pull you out of the experience.
A quick look at how Anime4K transforms the source frame using one of Stremio Kai’s custom presets.
No Filters vs Anime4K Eye Candy (HQ) + Denoise
🔍 Want to see all presets side-by-side? Check out the interactive comparison slider.
This system delivers a stable and natural viewing experience through a custom-engineered VapourSynth pipeline. Instead of crudely forcing all content to 60fps, it employs smart frame doubling to enhance motion authentically, transforming 24fps anime into a silky-smooth 48fps and boosting 30fps sources to 60fps. This advanced performance is built on a foundation of rock-solid stability. This custom pipeline has been painstakingly debugged to eliminate memory leaks and crashes, ensuring you can binge-watch an entire series without a single hiccup because high-quality visuals mean nothing if the player is unstable or unresponsive. These utilities ensure the experience is always smooth, stable, and under your control.
Forget choppy 24fps pans. This build integrates a heavily customized SVP (SmoothVideo Project) setup that provides an intelligent and stable frame interpolation experience. Designed for anime. Should work for other forms of content as well, but results can vary.
SVP Frame Interpolation
The core script that transforms standard video into a high-framerate, ultra-smooth visual experience.
Standard animation and film are shot at 24 frames per second (fps). While cinematic, this can cause noticeable judder and motion blur, especially in high-action scenes or smooth panning shots. The motion isn't as fluid as the eye can perceive, breaking immersion.
This script integrates the powerful SVP (SmoothVideo Project) engine directly into the player's video pipeline. It uses advanced algorithms to generate new, intermediate frames in real-time, targeting a fluid 48fps.
The result is exceptionally smooth, clear motion that removes distracting judder and allows you to see every detail, even during the most intense sequences.
Pushing video to an arbitrary 60fps from a 24fps source is a common mistake that can introduce motion artifacts. The ideal approach is to use an integer multiple of the original framerate.
By doubling 24fps to exactly 48fps (a 2x multiple), each original frame is given one perfectly timed, computer-generated frame in between. This maintains the original cadence and timing of the source material, resulting in a cleaner, more natural-looking smoothness. It's the technically correct choice for preserving motion integrity.
- 🧠 Intelligent Interpolation: Converts 24fps video to a pristine 48fps for superior motion clarity.
- 🎯 Anime-Tuned: The processing algorithm is specifically optimized for the visual characteristics of animation.
- 🤖 Smart Fallback Logic: Automatically detects if a video is already high-framerate (e.g., 60fps) and intelligently bypasses processing to prevent artifacts.
- ⚡ Performance Optimized: Tuned to deliver maximum smoothness without overburdening system resources on typical hardware.
- VapourSynth R72: The video processing framework used to apply the SVP filters.
📁 portable_config/
├── 📁 script-opts/
│ └── 📄 svp.conf ← For custom settings
└── 📄 svp_main.vpy ← The core motion engine script
This script is tuned for a "set it and forget it" experience. However, for those who wish to fine-tune performance, the optional svp.conf file can be adjusted. Do not modify these settings unless you understand their purpose.
num_threads = auto # Recommended. Allows the script to detect your CPU's capabilities.Translation: More threads can increase processing speed, but performance gains diminish significantly after 6 threads. The auto setting is almost always optimal.
max_cache_size = 2048 # Optimal for systems with 16GB of RAM or more.Translation: A larger cache can lead to smoother seeking in video files, but it consumes more system RAM.
DEBUG_OVERLAY = false # Keep this disabled for normal viewing.Translation: When enabled, this displays a real-time overlay with processing statistics. It is only useful for troubleshooting performance issues.
Be advised: real-time frame interpolation is one of the most demanding tasks you can ask of a CPU. While this script is highly optimized, it is still resource-intensive.
- Laptops: It is normal for your cooling fans to spin up significantly. This indicates the script is working as intended.
- Temperatures: Expect your CPU temperatures to rise. Ensure your system has adequate cooling.
This configuration was successfully tested on a modest laptop (i5-9300H CPU, GTX 1650 GPU, 16GB RAM) outputting to a 4K HDR display. This is a demanding scenario, and the script performed well. On standard 1080p displays, performance is excellent.
Drop these files in MPV, watch anime, enjoy buttery smooth animation that'll make you question why you ever watched anime any other way.
The perfect companion for binge-watching. This tiny, zero-configuration script prevents hangs and crashes between episodes by ensuring SVP is completely shut down and cleaned up before the next file loads.
SVP Cleanup Utility
Because playlists shouldn't crash between episodes.
You're binge-watching a series. An episode finishes, the screen goes black, and the next file is supposed to load. Instead... nothing. MPV hangs, becomes unresponsive, or flat-out crashes. You have to kill the process and restart, completely breaking your flow.
This often happens because SVP doesn't shut down cleanly, leaving leftover processes that interfere with loading the next video.
This is a tiny, zero-configuration "cleanup crew" script. Its only job is to run between files and make sure SVP has been completely torn down before the next video loads.
It's a fire-and-forget utility that dramatically improves the stability of watching sequential files (like in a playlist) with SVP active.
📁 portable_config/
└── 📁 scripts/
└── 📄 svp_cleanup.lua ← The Janitor
That's it. There is no configuration. It just works.
The script is brutally simple and effective:
- Detects End-of-File: It patiently waits for a video to finish playing.
- Checks for SVP: The moment the file ends, it checks if an SVP or VapourSynth filter was active.
- Takes Out the Trash: If SVP was running, the script forcibly clears the entire video filter chain.
- Waits a Beat: It imposes a 1-second delay, giving all the SVP processes enough time to fully terminate before mpv proceeds to load the next file.
This ensures that every new video starts with a perfectly clean slate, eliminating a major cause of instability.
If you ever watch multiple videos in a row with SVP enabled, drop this script into your folder. It's a tiny insurance policy against hangs and crashes.
Heavy filters like SVP can cause debilitating lag when seeking. This script acts like a performance clutch, instantly and temporarily disengaging the filter chain the moment you seek, allowing for instantaneous rewinds and fast-forwards.
Instant Seeker - Reactive Filter Bypass
Because seeking shouldn't require a coffee break.
You're watching a buttery-smooth, 60fps interpolated video thanks to SVP and other heavy filters. You miss a line of dialogue and tap the left arrow key to jump back 5 seconds.
...and the video freezes.
The audio skips back instantly, but the video stutters and hangs for what feels like an eternity as the CPU screams, trying to re-process everything. That "quick rewind" just shattered your immersion. Seeking is supposed to be instant, not a punishment for using high-quality filters.
This script is like a performance clutch for your video player. It's smart enough to know that seeking doesn't require complex video processing. The moment you seek, it temporarily disengages the heavy filters, letting you zip around the timeline instantly. Once you stop seeking, it seamlessly re-engages them.
The result? You get instant, lag-free seeking and the full quality of your video filters during normal playback. It’s the best of both worlds.
- 🧠 Reactive, Not Dumb: It doesn't just turn filters off and on. It validates its own actions against yours, so it never fights you if you manually toggle SVP.
- 💪 Rock Solid: Handles rapid-fire seeks (like holding down the arrow key) and seeking while paused without breaking a sweat.
- 🎯 Surgical Precision: It only targets the heavy filters you specify (like SVP) and leaves everything else alone.
📁 portable_config/
├── 📁 scripts/
│ └── 📄 reactive_vf_bypass.lua ← The Clutch
└── 📁 script-opts/
└── 📄 vf_bypass.conf ← The Target List
Edit vf_bypass.conf to tell the script which filters are "heavy" enough to be disabled during seeks.
# Keywords that identify your heavy filters (comma-separated)
# If a video filter contains any of these words, the script will manage it.
svp_keywords=SVP,vapoursynthMost users will never need to change this. The default SVP,vapoursynth covers 99% of motion interpolation setups.
Note: The 1.5-second restore delay is hardcoded in the script for maximum stability and to prevent race conditions. It's the sweet spot between responsiveness and reliability.
Think of playing a video with SVP like driving a car in first gear—lots of power, but not nimble.
- Pressure Detected: The moment you press a seek key, the script detects it.
- Clutch In: It instantly disengages the heavy video filters. The player is now in "neutral"—lightweight and incredibly responsive.
- Shift Gears: You can now seek backwards and forwards instantly, with zero lag or stuttering. If you keep seeking, the "clutch" stays in.
- Clutch Out: A moment after your last seek, the script smoothly re-engages the exact same filter chain. You're back in gear, enjoying buttery-smooth playback as if nothing happened.
The entire process is so fast, it's almost imperceptible. All you notice is that seeking finally works the way it's supposed to.
- Make sure your active video filter actually contains one of the keywords from
vf_bypass.conf(e.g., "SVP"). If it doesn't, the script will correctly ignore it. - Check the mpv console (
~key) for logs. The script is very talkative and will tell you if it's loading and what it's doing.
- This is extremely unlikely due to the script's validation logic. However, if it happens, it means another script or manual command is interfering. The logs will reveal the culprit. The script is designed to be defensive and will reset itself if it detects external changes.
This is a fire-and-forget script that fixes one of the most significant performance bottlenecks when using heavy video filters. Install it and enjoy a snappy, responsive player without sacrificing visual quality.
A short clip that showcases SVP’s frame interpolation in a fast-paced anime fight. See how motion transforms from choppy to fluid—especially during camera pans and impact frames. Click the thumbnail below to watch the full demo.
This is where Stremio Kai truly shines. A suite of custom-built scripts work silently in the background to automate the tedious parts of media playback, letting you focus on watching.
This script is the central nervous system of the entire configuration. It completely eliminates the need for manual profile switching by intelligently analyzing every file you play and applying the perfect profile for the content.
Automatic Profile Manager
Because your 4K HDR movies shouldn't look like 20-year-old anime (and vice-versa)
You've spent hours crafting the perfect mpv profiles: one for crisp, vibrant anime; another for cinematic, tone-mapped HDR movies; and a third with deinterlacing for that old show you downloaded.
But every time you open a file, you have to manually switch between them. Or worse, you try to build a complex profile-cond system that constantly breaks, gets into fights with itself, and picks the wrong profile half the time because of weird race conditions. It's a fragile, frustrating mess.
This script is the central brain your mpv config has been missing. It completely takes over the job of profile selection, analyzing every file on load using an advanced, multi-step process that thinks like a human. It applies the one, correct profile for what you're watching. No conditions, no fighting, no mistakes.
It's the set-it-and-forget-it system that finally makes your carefully tuned profiles work automatically, correctly distinguishing between anime, movies, and live-action dramas.
This script's sole purpose is to analyze the video file and apply the appropriate profile from the Visually Stunning Predefined Profiles table. It uses a powerful, two-tiered system to identify content with high accuracy and runs a lightning-fast check on every file, asking a series of questions to determine its exact nature and apply the perfect profile:
- Tier 1: High-Confidence "Fingerprint" Check
- First, it scans for metadata "fingerprints" that are strong indicators of anime. This includes things like:
- Styled subtitle formats (
.ass) - "Signs & Songs" subtitle tracks
- Anime-specific chapter names ("Part A", "Part B")
- Embedded font files
- Styled subtitle formats (
- If it finds any of these, it confidently applies an anime profile. This method is smart enough to correctly identify anime movies, specials, and even dubbed anime that would fool simpler checks.
- Tier 2: General Episodic Check (Fallback)
- If the "fingerprints" aren't found, the script falls back to a safer, more general check. It asks two questions:
- Does it have an Asian language audio track (Japanese, Chinese, etc.)?
- Is its duration under 40 minutes (like a typical TV episode)?
- If the answer to both is yes, it applies an anime profile. This reliably catches standard anime episodes while correctly excluding live-action Asian dramas, which are longer.
If a file matches neither tier, it receives the standard sdr or hdr profile.
📁 portable_config/
└── 📁 scripts/
└── 📄 profile-manager.lua ← The Brain
This script is smart, but it's not a mind reader. It needs profiles to apply. Make sure your mpv.conf contains the profiles it will look for:
[anime-sdr][anime-hdr][anime-old][hdr][sdr]
This is critical. The script is now in charge. Delete every profile-cond=... line from your mpv.conf. If you don't, the old system will fight with the new script and cause chaos.
This script has no .conf file, but it's still easy to configure. A configuration table has been placed at the very top of the profile-manager.lua file.
You can easily tweak the script's core logic without digging through the code:
- Add a new language for detection.
- Change the 40-minute duration threshold.
- Add new keywords to look for in chapter or subtitle titles.
Of course, the main way to configure is still by editing your profiles in mpv.conf. The script simply acts as the intelligent switch for the settings you've already defined.
Want your [anime] profile to be brighter? Edit [anime] in mpv.conf. Want your [hdr] profile to use different tone-mapping? Edit [hdr]. The script simply acts as the intelligent switch for the settings you've already defined.
When a video starts loading, the script patiently waits in the background.
- 🔍 Waits for Clues: It observes mpv's properties, waiting for all the necessary data (
track-listandvideo-params) to be fully populated. This crushes the race conditions that plague other methods. - 🧠 Runs Once: As soon as the data is ready, the script runs its decision tree logic exactly one time.
- ⚡ Takes Action: It applies the single best profile (e.g.,
apply-profile anime-hdr) and then goes to sleep until the next file is loaded.
| If the file is... | The script will apply... | Why? |
|---|---|---|
| 1080p Anime, Japanese audio, 24 min | [anime-sdr] |
Tier 2: Asian audio + short duration. |
| 2160p K-Drama, Korean audio, 60 min, HDR | [hdr] |
Tier 2: Fails duration check. Correctly not anime. |
| 1080p Anime Movie, Japanese audio, 120 min, ASS subs | [anime-sdr] |
Tier 1: Detects .ass subtitles, ignores long duration. |
| 720p Dubbed Anime, English audio, 24 min, "Signs" track | [anime-sdr] |
Tier 1: Detects "Signs" track, ignores English audio. |
| 2160p Hollywood Movie, English audio, HDR | [hdr] |
Fails both tiers. Correctly not anime. |
- Make sure the
profile-manager.luafile is in the correctscriptsfolder. - Check that you deleted all
profile-cond=lines frommpv.conf. This is the #1 cause of problems. - Open the mpv console (
~key) and look for logs prefixed with[profile-manager]. They will tell you exactly what the script is doing.
- Look at the log! The script now logs the exact reason for its choice.
- Open the mpv console (
~key) and look for the[profile-manager]logs. You will see a line like:Reason: Tier 1 (ASS Subtitle Format)Reason: Tier 2 (Asian Audio + Short Duration)Reason: Default (No Anime Detected)
- This tells you why it made its choice, allowing you to see if the file's metadata is the problem or if a tweak to the script's configuration table is needed.
Install it, clean your mpv.conf, and enjoy a player that is finally smart enough to use your profiles correctly. This is the robust, centralized logic that ends the profile wars for good.
Ends the nightmare of manually cycling through subtitle tracks. This script intelligently scans and selects the best subtitle track based on your preferences, automatically rejecting "Forced" or "Commentary" tracks.
Smart Subtitle Selector
An intelligent script to automatically select the correct subtitle track.
When playing media with multiple subtitle tracks, MPV's default behavior often selects an undesirable track, such as "Signs & Songs" or "Forced," leading to a frustrating user experience. The user must then manually cycle through all available tracks on every single file to find the main dialogue track.
This script replaces MPV's default logic with an intelligent, priority-based system. It analyzes the titles of all available subtitle tracks and automatically selects the one that best matches the user's configured preferences, ignoring commentary or utility tracks.
This provides a "set it and forget it" solution that ensures the correct dialogue track is selected automatically, every time.
The script ranks subtitle tracks based on a tiered priority system:
- Priority Tier: First, it searches for tracks containing keywords that indicate a primary dialogue track (e.g., "dialogue," "full").
- Normal Tier: If no priority tracks are found, it falls back to any standard subtitle track that isn't explicitly rejected.
- Rejected Tier: It actively ignores any track containing keywords that mark it as a utility track (e.g., "signs," "songs," "commentary").
Available tracks:
❌ English [Forced]
❌ English [Signs/Songs]
✅ English [Full Dialogue] ← This one gets picked!
❌ Commentary Track
📁 portable_config/
├── 📁 scripts/
│ └── 📄 smart_subs.lua
└── 📁 script-opts/
└── 📄 smart_subs.conf
For the script to take control, you must disable MPV's default subtitle selection logic. In your mpv.conf file, comment out or delete the following line:
# sid=autoThe script's behavior is controlled via smart_subs.conf.
# Languages to select, in order of preference.
preferred_langs = en,eng
# Keywords that identify a high-priority dialogue track.
priority_keywords = dialogue,full,complete
# Keywords that identify tracks to be ignored.
reject_keywords = signs,songs,commentary- For Multi-Language Users:
preferred_langs = en,eng,jp,jpn - For Anime Fans:
reject_keywords = signs,songs,commentary,forced,karaoke - For Movie Fans (with accessibility):
priority_keywords = dialogue,full,complete,sdh
- If the script isn't working:
- Ensure the
.luaand.conffiles are in the correct folders. - Confirm that
sid=autohas been removed frommpv.conf.
- Ensure the
- If the wrong track is selected:
- Check the track titles in your media file.
- Add any unwanted keywords (e.g., "Forced") to
reject_keywords. - Add any desired keywords to
priority_keywords.
- To see the script's decision-making process:
- Enable the MPV console (press
~). The script will log its actions, such asSubtitle Selector: Found a PRIORITY track. Activating subtitle track #2.
- Enable the MPV console (press
Install once, configure to your taste, then never think about subtitles again. The script just quietly does the right thing while you focus on actually watching your content.
Binge-watch like a pro. This script provides a configurable, Netflix-style system for skipping intros, outros, and previews, with a multi-layered detection system that uses chapter titles, positions, and even silence to know when to offer a skip.
Notify Skip
An automated system for skipping intros, outros, and previews.
During a binge-watching session, the flow between episodes is constantly interrupted by opening credits, ending credits, and previews. This forces you to manually skip forward, which is tedious, imprecise, and breaks immersion.
This script elevates your viewing experience by intelligently identifying skippable content and presenting a clean, non-intrusive toast notification, just like on major streaming services. It uses a sophisticated, multi-layered detection system to handle files with or without chapters, ensuring you can seamlessly move between episodes with a single keypress.
The script analyzes each file using a hierarchy of detection methods to ensure the highest possible accuracy.
-
Chapter-Based Detection (Primary Method) This is the most accurate mode, used on files with embedded chapters. The script analyzes the chapter list to find skippable segments.
- High Confidence: If a chapter has a descriptive title matching known patterns (e.g., "Intro," "Ending," "Outro"), it's considered a high-confidence match.
- Medium Confidence: If a chapter is untitled (e.g., "Chapter 1") but is in a common position for an intro, it's considered a medium-confidence match.
-
Intelligent Fallback (For Chapter-less Files) If a video file has no chapters, the script switches to its intelligent fallback mode.
- Time-Gated Scanning: To avoid interrupting actual content, this mode only scans for breaks during the first and last few minutes of the file, where intros and outros are expected.
- Silence Detection: Within these time windows, the script actively listens for periods of silence that typically precede or follow a skippable segment.
- Contextual Prompts: Based on when the silence is detected, it will generate a contextual notification (e.g., "Skip Intro" or "Skip Outro").
-
Proactive Notifications In all cases, the script's default behavior is to proactively display a skip notification, giving you the choice to act. For those who prefer a fully automated experience, an
auto_skipoption can be enabled for high-confidence (titled) chapters.
Chapters found:
✅ "Opening" → Skippable! Notification appears.
❌ "Part A" → Not skippable.
❌ "Part B" → Not skippable.
✅ "Ending" → Skippable! Notification appears.
✅ "Next Preview" → Skippable! Notification appears.
📁 portable_config/
├── 📁 scripts/
│ └── 📄 smart_skip.lua
└── 📁 script-opts/
└── 📄 smart_skip.conf
The script's behavior is controlled via smart_skip.conf. These settings are read directly from the script's code:
opening_patterns=OP|Opening|Intro
ending_patterns=ED|Ending|Outro
preview_patterns=Preview|Coming Up
# Auto-skip detected intro/outro chapters
auto_skip=no
# Maximum duration for skippable chapters (seconds)
# Chapters longer than this will never be marked as skippable
max_skip_duration=200
# Set the time limit for untitled Chapter 1 to 4 minutes (240 seconds)
max_intro_chapter_duration=240
# Time window for manual skip (seconds)
# Allow skip when skippable chapter starts within this time
skip_window=3
# Silence detection settings (for files without chapters)
# Maximum noise level in dB to consider as silence
quietness=-30
# Minimum silence duration in seconds to trigger skip
silence_duration=0.5
# Show OSD notification when skippable content is detected
show_notification=yes
# Duration to show notification in seconds
notification_duration=30- If it's not skipping anything:
- Ensure the
.luaand.conffiles are in the correct folders. - Check the MPV console (
~key) for any error messages. - The video file may not contain any chapters or silent periods for the script to detect.
- Ensure the
- If it tries to skip the whole episode:
- This is prevented by the
max_skip_duration=200safety feature in the script, which stops it from ever skipping more than approximately 3 minutes.
- This is prevented by the
This script merges and modernizes concepts from two foundational scripts. Full credit goes to the original authors:
Go right to your favorite part! This script provides a polished, pop-up notification that gives you precise, one-press control to skip content exactly when you want. It’s a quality-of-life upgrade that makes your player feel less like a tool and more like a premium service.
ThumbFast is an additional script that is included to provide video preview thumbnails when you hover over the seek bar.
Note: There is a known visual bug where the thumbnails may not align perfectly with the timeline. This is a limitation of the script and currently has no fix.
⚠️ System Requirements & User Advisory
This project is engineered to deliver the best visual quality possible on modest hardware, but "optimized" does not mean "zero-impact." High-quality, real-time video processing is demanding. Please read the following before you begin.
- ✅ Minimum Specs: i5/Ryzen 5 (4+ cores), 8GB RAM, and a dedicated GPU (GTX 1050 / RX 560 or better) are recommended for a smooth 1080p experience.
- 🌡️ Expect Heavy CPU Usage: The motion smoothing (SVP) feature is extremely CPU-intensive. It is normal for your CPU temperatures to rise and for your cooling fans to spin up significantly (💨). This is the sound of the system working as intended. Ensure your PC or laptop has adequate cooling.
- 🎯 Benchmark: This build was developed and tested on a laptop with an i5-9300H CPU, GTX 1650 GPU, and 16GB of RAM outputting to a 4K display. This proves the system can run well even on modest hardware, but your mileage may vary.
Typical resource consumption during 4K playback with all features active.
- 🛑 CRITICAL: HDR Content is for HDR Displays Only. The HDR profiles are configured for true HDR passthrough. If you play an HDR video on a standard (SDR) monitor, the colors will look grey, washed-out, and incorrect. This is by design. You must choose video sources that match your display's capabilities. The AIOstreams add-on can help you filter content correctly.
- 🎨 A Note on Color Calibration: All visual profiles were tuned on a calibrated display. If your monitor is not calibrated, the final image may look different from the intended result. Visuals are subjective and will vary based on your screen.
- You may receive a warning from Windows Defender, flagging the application with a generic name like
Wacatac. - This is a FALSE POSITIVE. The detection is triggered simply because the app's original icon was modified, a change that heuristic-based security software can view as suspicious. The application is completely safe to use.
- A submission has been made to Microsoft to have the application whitelisted. In the meantime, you can safely resolve this by adding an exclusion for the Stremio Kai folder in your antivirus settings.
- 🔌 This is a "Plug-and-Play" Build: The scripts and configurations have been custom-built to work together out of the box. The goal is to provide a seamless experience with minimal user tinkering.
- 🔬 For Advanced Users:
While most default settings are optimal, power users can adjust
.conffiles for each script. Only modify these settings if you understand what they do. This is a personalized setup, and while it's designed to be universal, unique hardware or software combinations may lead to unpredictable issues.
-
Before making any permanent changes, you can first identify which feature hinders your experience. While watching anime content, you can quickly disable the SVP frame rate by pressing F12. That's the most heavy thing. Check and see if it works fine without it, shaders aren't supposed to be that heavy. If it's still bad, press F4 to disable the Anime4K shaders.
-
To permanently disable the features, you need to go into
/Stemio Kai/portable_config/and openmpv.confin Notepad (just drag and drop into an open Notepad). Then, look for the lines starting withvf=andglsl-shaders=and either delete them, or put a # before them. Save and restart Stremio Kai and they will be permanently deleted.
Stremio Kai is a completely self-contained, portable system. All dependencies—SVP, VapourSynth, MPV, shaders, and scripts—are included and pre-configured. No separate installation is required.
Grab the latest Stremio.Kai.vX.X.7z file from releases.
- Unzip the entire contents of the 7z archive to a location of your choice on your computer (e.g., C:\Program Files\Stremio Kai or D:\PortableApps\Stremio Kai).
- Double-click stremio.exe. That's it. Log in to your Stremio account and enjoy.
4. (Optional) Use the provided AIOstreams Template
- To help you identify the right video source, this package includes a pre-configured template for the AIOstreams addon. This template formats the search results to clearly display critical information like resolution, HDR format (HDR10+, DV), audio type (Atmos), and file size, so you can pick the best source for your display with confidence. It would look like this:
How to set up AIOstreams and use the template
The template file is included in the Stremio Kai package. To use it, you'll need to configure one of the AIOstreams addons. Below are two of the most popular ones.
- Navigate to one of the AIOstreams configuration pages:
- Click the Import button and select the template file provided with Stremio Kai.
- Click Install to Stremio if you don't have it installed, or Save to apply the template, if you're already using the addon.
AIOstreams Custom Formatter Settings
{service.cached::istrue["⚡"||"🐢"]}{stream.resolution::exists["{stream.resolution}"||""]}
{stream.filename::exists["🎬 {stream.filename}"||"{stream.title::title}"]}
{stream.folderName::exists["📁 {stream.folderName}"||""]}
{stream.visualTags::exists["📺 {stream.visualTags::join(' • ')}"||""]}{stream.quality::exists[" • {stream.quality}"||""]}
{stream.audioTags::exists["🎧 {stream.audioTags::join(' • ')}"||""]}{stream.languages::exists["📣 {stream.languageEmojis::join(' · ')}"||""]}
{stream.size::>0["📦 {stream.size::bytes}"||""]} {stream.seeders::>=0["🌱 {stream.seeders}"||""]}
{addon.name::exists["📡 {addon.name}"||""]}
Stremio Kai is designed to work perfectly out of the box, but power users have full control. Use these hotkeys to adjust the visuals on the fly.
| Key | Action | Description |
|---|---|---|
| Tab | Smart Skip | Skips the current intro/outro when prompted. |
| F12 | Toggle SVP Motion Smoothing | Manually enables or disables frame interpolation. |
| Ctrl+F1 | Anime4K: Optimized | A balanced preset for great quality and performance. |
| Ctrl+F2 | Anime4K: Eye Candy (Fast) | A higher-quality preset with a minor performance cost. |
| Ctrl+F3 | Anime4K: Eye Candy (HQ) | The highest-quality preset for powerful machines. |
| Ctrl+F4 | Clear All Shaders | Instantly removes all active GLSL shaders. |
| Ctrl+F10 | Toggle High Denoise | Toggles the default subjective denoise filter. |
| F9 | Cycle Denoise Filters | Cycles through other, weaker denoise filters. |
| F8 | Toggle ICC Profile | Toggles automatic ICC color profile correction. |
For a full list of all custom shortcuts, please consult the
input.conffile. For even more, check the mpv manual.
- 🧪 Actively Tested: Stability and performance validated across long viewing sessions
- 🧼 uBlock Extension Removed: Prevented infinite loading loop during app startup
- 🔧 Project is feature-complete and stable—no major development planned.
- Future updates will focus on bug fixes or meaningful feature requests that align with the project’s vision.
- 🖼️ ThumbFast Timeline Misalignment: Thumbnail previews may not align properly; no current fix available
⚠️ 10-Bit Video Incompatibility: Processing 10-bit video files can cause visual artifacts (e.g., black dots) or interpolation failures.- ❌ This is a core limitation of the underlying 8-bit SVP engine; no script-level fix is available.
- ℹ️ This is a harmless visual-only issue and poses no risk to computer hardware.
- 🧠 SVP Memory Leaks: Previously caused stutters after extended playback
- ✅ Mitigations and fallback logic have been implemented
- 🔍 Issue appears resolved in latest tests, but will be monitored and documented if it resurfaces
- 🐛 Bug Reports & Feature Requests: Please open an issue on GitHub
- 💬 Feedback Welcome: Suggestions that improve usability or performance are appreciated
1. Is there a version for Linux or macOS?
- Currently, Stremio Kai is Windows-only. The project is built upon the Stremio Community v5, and I am dependent on its developer for cross-platform support. While a Linux/macOS version has been announced, there is no ETA. Once that foundation is available, I can begin the work of porting Stremio Kai.
2. What if I don't like the upscaling or motion smoothing?
- This project is designed to be a highly opinionated "it just works" setup, but it is not a locked box. Every visual and performance enhancement—from Anime4K upscaling to SVP motion smoothing—is fully configurable and can be disabled.
- If you are a purist who prefers the original, unaltered look of an anime, you can easily achieve that. The settings are controlled in the mpv.conf file. If you're not comfortable editing it yourself, please open a discussion. I will personally guide you on how to tailor the experience to your exact preferences.
3. How does the "anime detection" work? Will this affect other content?
- The system uses an advanced, multi-step process to accurately identify anime and separate it from live-action content.
- First, it looks for common "fingerprints" in the file's metadata, such as styled subtitles, "Signs & Songs" tracks, or anime-specific chapters. This allows it to detect many anime files, including movies and dubbed versions, regardless of audio language.
- If those aren't found, it falls back to checking for a combination of an Asian language audio track and a short, episode-like duration.
- This new system has two important consequences:
- Live-Action Content: This logic is specifically designed to fix the misidentification of other Asian content. Live-action dramas and movies (like K-dramas or J-dramas) will now be correctly identified and receive the standard visual profiles.
- Dubbed Anime: Because the system can detect anime using more than just the audio language, many dubbed anime files will now be correctly identified automatically.
4. I have a decent PC, why does it run like crap?
- This app was designed to run 1080p anime content, not native 4K, on low and mid range computer specs. Anime4K is supposed to bring you the quality of 4K content, or even better, for 1080p sources. Although, if you have a high end PC, it should run great even with 4K content, it is still recommended to use 1080p content.
Stremio Kai is an independent, fan-driven project and is not affiliated with the official Stremio team or any third-party plugin developers. This software is provided “as is,” without warranties of any kind. The maintainers do not endorse or support illegal streaming or distribution of copyrighted content. Users are solely responsible for ensuring their usage complies with all applicable laws and regulations in their jurisdiction. Use responsibly and at your own discretion.
This project stands on the shoulders of giants and wouldn't be possible without their incredible work.
- A massive thank you to Zaarrg for creating the original stremio-community-v5, which provides the essential MPV integration that this entire project is built upon.
- Credit and thanks to the brilliant team behind bloc97/Anime4K for their amazing upscaling shaders.
Stremio Kai is a personal project developed over the years, born from a simple frustration: nothing out there offered the anime viewing experience I wanted. So I built it myself. This latest version—with full Stremio integration and upgraded plugins—is the most extensive work I’ve done on it. While I don’t consider myself a developer, I’ve learned to shape existing tools into something I genuinely love using.
If Stremio Kai made your setup smoother and you’d like to support my work, you can buy me a coffee.
Thanks for the kind gesture!
Crypto (USDT TRC-20):
TE4LPfv6tgYbucSxrUsagSN9DiPimBVrwX
✨ Built with love for the series that keep us up all night. Enjoy the view. ✨
- Alt