A curated collection of powerful Lua scripts for MPV Android — enhancing your media experience with smart automation, audio enhancement, and intuitive overlays.
AUTO CHAPTER SKIPPER FOR MPV ANDROID Automatically skips unwanted chapters so you never have to manually skip again.
| Chapter Type | Status |
|---|---|
| 🎬 Opening | ✅ Auto-Skipped |
| 🎞️ Intro | ✅ Auto-Skipped |
| 🎭 Outro | ✅ Auto-Skipped |
| 🏁 Ending | ✅ Auto-Skipped |
| 📜 Credits | ✅ Auto-Skipped |
| 👁️ Preview | ✅ Auto-Skipped |
📁 File: auto_skip(chapter skipper).lua
🔗 Gist: https://gist.github.com/Graywizard888/9ac8bdf1947063407d11079144b75474
MPV ANDROID DURATION OSD SCRIPT Shows a persistent, clean duration display so you always know where you are in your media.
- 📍 Persistent OSD anchored to the top-right corner
- 🕐 Clean and minimal format display
▶️ Always visible during playback
╔══════════════════════════╗
║ ▶ 1:23:45 / 2:00:00 ║ ← Top-Right Corner
╚══════════════════════════╝
📁 File: Duration_OSD (v1.3).lua
🔗 Gist: https://gist.github.com/Graywizard888/44c76b134d576cf299df8908672295c8
UP NEXT EPISODE OVERLAY SCRIPT FOR MPV ANDROID A sleek Netflix-style "Up Next" overlay that appears automatically near the end of each episode.
- 📅 Shows "Up Next" episode card when 2 minutes remain
- 🏁 Shows "Season Ended" with episode countdown if no next episode is available
- 🕐 Live countdown timer with a clock icon
- ➖ Separator line above the countdown for clean visual separation
- ⏯️ Properly handles seek / pause / resume transitions
- 🎨 Right-aligned OSD with colorful multi-line text
╔══════════════════════════╗
║ 📺 Up Next ║
║ ─────────────────────── ║
║ 🕐 Next in 0:01:45 ║
╚══════════════════════════╝
📁 File: Up_next(Episode overlay v5.5).lua
🔗 Gist: https://gist.github.com/Graywizard888/88d78790a86b2d905c02b82421e6db57
AUDIO ENHANCEMENT EQUALIZER FOR MPV ANDROID Professional-grade audio enhancement optimized for AAudio Backend (Android 8.1+), tuned for Movies & Anime content.
| Feature | Detail |
|---|---|
| 🔬 Audio Analysis | 3-second analysis before applying filters |
| 🔈 Channel Support | Mono · Stereo · 5.1 · 7.1 · Multi-channel |
| 🎚️ Equalizer | Professional 15-Band FireEqualizer |
| 📐 Band Types | Mixed: Octave + Slope + Q-Factor widths |
| 🎵 Bass Tuning | Moderate boost (max +2dB) on original frequencies |
| ⚡ Latency | AAudio-optimized low-latency timing |
| 🎛️ Audio Format | Native Float32 (AAUDIO_FORMAT_PCM_FLOAT) |
| 🔄 Resampling | No forced resampling — AAudio handles it natively |
| 🔃 Track Detection | Automatic track change detection |
| 🧹 Cleanup | Proper cleanup on file end / close |
| ⏯️ Pause Handling | Proper pause / resume handling |
| 🎧 Modes | Speaker / Earphone |
| 🧑💻 Earphone codec support | Aptx / Aptx HD |
15-Band FireEqualizer
┌─────────────────────────────────────────────────────────┐
│ Sub Bass Low-M Mid Hi-M Pres Air Bril Ext │
│ ████ ████ ████ ████ ████ ████ ████ ████ ████ │
└─────────────────────────────────────────────────────────┘
Optimized for Movies & Anime · AAudio Backend
📁 File: Audio_Enhancer(Industrial Grade Mode)v7.4.lua
🔗 Gist: https://gist.github.com/Graywizard888/ba9ce533c4117ae58af29ae3ec5ce71b
place this configuration in /storage/emulated/0/MpvConfig/mpv.conf
##########
# AUDIO #
#########
ao=aaudio
audio-pitch-correction=yes
audio-channels=auto-safe
volume-max=150
audio-format=float
# 1. Download the desired .lua script from the Gist links above
# 2. Place the script in your MPV scripts folder:
# Android path:
/storage/emulated/0/MpvConfig/scripts
# 3. Enable them in MpvEx app settings
Settings/Advanced/Manage lua scripts💡 Tip: You can install all scripts at once — they are fully compatible with each other!
| # | Script | Version | Type | Gist Link |
|---|---|---|---|---|
| 1 | auto_skip(chapter skipper).lua |
Latest | 🤖 Automation | 🔗 Open |
| 2 | Duration_OSD.lua |
v1.3 | 🖥️ Display | 🔗 Open |
| 3 | Up_next(Episode overlay).lua |
v5.5 | 📺 Overlay | 🔗 Open |
| 4 | Audio_Enhancer(Industrial Grade Mode).lua |
v7.4 | 🔊 Audio | 🔗 Open |
Made with ❤️ for the MPV Android Community
If these scripts helped you, consider ⭐ starring the gists!