Skip to content

Repository files navigation

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: OffLoop 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.
Check & Update Latest Version Built-in non-blocking GitHub update checker accessible directly in the context menu or via shortcut. Checks for new releases and updates automatically with zero interruption.

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 (NormalBlurAmbient Glow)
l / م Cycle Loop Mode (OffPlaylist (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
Shift + u Check and update latest version
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
├── version.json           # Installed version metadata & changelog
├── update-rmn.ps1         # Automated update script
├── 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
│   ├── rmn-updater.lua    # GitHub update checker & manager
│   ├── 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

# Check for updates only
.\update-rmn.ps1 -CheckOnly

# Apply latest update automatically from GitHub
.\update-rmn.ps1

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

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

License

License: GPL v3

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

About

High-performance custom media player for Windows with OLED-tuned rendering, dynamic ambilight glow & smart episode tracking

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages