RMN-Player

A high-performance custom media player for Windows with OLED-tuned rendering, intelligent series tracking, dynamic ambient background lighting, and modern UI.

100% Offline • Zero Dependencies • Native Windows Integration

---

Key Features

Feature	Description
Organic 2D Diffused Ambilight & Blur	Real-time color-adaptive ambient halo / blurred extension for letterbox and pillarbox bars. 2D spatial diffusion on pure black canvas with zero crop and zero overhead when off.
Smart TV Show Autoloading	Intelligently identifies same-show episodes across naming styles (Georgie and Mandy, True Detective) and sorts chronologically while isolating single movies.
Clean Title Sanitizer	Displays clean video titles without website ads or release tags (e.g. ValaMovie.Com).
Unified 3-State Looper	Single smart button and key shortcut cycling: Off → Loop Playlist (All) → Loop Current Episode (One).
Dual EN / FA Keyboard Support	All keyboard shortcuts work seamlessly whether Windows keyboard is set to English or Persian.
Native File Dialog	Opens native Windows Explorer file picker for selecting media files asynchronously.
OLED True Black & Debanding	Native 10-bit dithered pipeline with libplacebo debanding for clean gradients and true blacks.
Fast Timeline Previews	High-speed hover thumbnails via thumbfast.
Modern Minimal UI	Elegant floating controls powered by uosc.

---

Quick Start

Installation

1. Download or clone this repository
2. Run Install-RMN.bat
3. Done!

# Or run via PowerShell:
.\rmn-installer.ps1

---

Keyboard & Mouse Shortcuts

All letter shortcuts are mapped for both English (EN) and Persian (FA) keyboard layouts:

Key (EN / FA)	Action
Right Click	Open context menu anywhere
Double Click / Enter	Toggle Fullscreen
Space	Play / Pause
→ / ←	Instant Non-Blocking Seek $\pm 3$ seconds (0ms latency, zero freezing)
Shift + → / ←	Seek $\pm 30$ seconds
Ctrl + → / ←	Save position & go to Next / Previous episode
Mouse Wheel / ↑ / ↓	Volume $\pm 5%$
b / ذ	Cycle Background Mode in Fullscreen (Normal → Blur → Ambient Glow)
l / م	Cycle Loop Mode (Off → Playlist (All) → Current Episode (One))
d / ی	Toggle OLED Deband filter (cycle deband)
m / ئ	Mute / Unmute audio
c / ز	Subtitles menu
v / ر	Toggle subtitle visibility
a / ش	Audio tracks menu
o / خ	Open Windows Explorer file dialog
u / ع	Open URL popup to stream links
s / س	Screenshot
Tab	Toggle UI visibility

---

Configuration

Configuration files are installed at %APPDATA%\RMN-Player\:

%APPDATA%\RMN-Player\
├── mpv.conf               # Video & audio rendering pipeline
├── input.conf             # Bilingual keybindings & mouse actions
├── episode-tracker.json   # Local episode tracking database
├── script-opts/
│   ├── uosc.conf          # Modern UI layout & tokens
│   ├── thumbfast.conf     # Thumbnail preview settings
│   └── autoload.conf      # Smart playlist settings
├── scripts/
│   ├── ambient-fill.lua   # Dynamic ambient lighting & blur engine
│   ├── autoload.lua       # Intelligent TV show detection & sorting
│   ├── episode-tracker.lua# Watched tracking & resume
│   ├── loop-cycle.lua     # Unified 3-state loop controller
│   ├── open-url.lua       # Online streaming input popup
│   ├── save-position.lua  # Resume playback manager
│   ├── thumbfast.lua      # Thumbnail engine
│   └── uosc/              # UI framework
└── fonts/                 # High-legibility UI typography

---

Command Line Options

# Standard Install / Update
.\rmn-installer.ps1

# Update Configuration Only (skip binary copy)
.\rmn-installer.ps1 -ConfigOnly

# Force Reinstallation
.\rmn-installer.ps1 -Force

---

License

GNU General Public License v3.0 - see LICENSE for details.