Skip to content

elementalmasterpotap/mpc-be-ambient-shaders

Repository files navigation

MPC-BE Ambient Glow — Software Ambilight for MPC-BE




⬇ MPC-BE.Ambient.Lighting.v1.2.4.zip


🇬🇧 English

Software Ambilight for MPC-BE — fills black bars with color glow from the frame edges.

Not just a blur. Full post-processing pipeline: vivid colors, cinematic tone mapping, film glow, vignette, chromatic aberration. The detector finds black bars automatically — no manual setup needed.

Designed for 4:3 content hard-encoded into 16:9 containers (pillarbox) — the most common case for classic TV shows and retro content.

Installation

Run ProfessionalLighting_Setup.exe — dark window, click Install, done.

Or via console:

install.cmd
.\install.ps1            # with menu
.\install.ps1 -NoPrompt  # silent mode

Shaders install to %APPDATA%\MPC-BE\Shaders\.

Enabling in MPC-BE

View → Shader → Post-Processing

Select ProfessionalLighting_SM3_Ready.hlsl, click OK. Effect applies instantly, no restart needed.

Video renderer must be set to madVR — the shader requires madVR for correct post-processing. Settings → Video → Video Renderer → madVR

Nightly build of MPC-BE recommended — stable releases sometimes have shader bugs.

What the shader does

Effect What you see
Ambilight fill Frame edge colors spread across black bars
Vibrance Vivid saturated colors — not grey, not washed out
ACES tone mapping Cinematic brightness compression: no blown highlights
Warm glow Film halo at the border between video and bars
Vignette Subtle corner darkening
Chromatic aberration Slight R/B shift toward corners — like a real lens
Vertical gradient Top of bars slightly darker, bottom warmer — depth
Lens dirt Procedural texture: barely visible, adds grain

Dark scene — glow suppressed automatically, bars stay black. No bars — no effect. The detector doesn't guess.

Customization

Want warmer, cooler, brighter, softer — see VIBE.md. It maps "I want..." to which constants to change. Describe what you want to an AI assistant, it edits the shader, you deploy and check.

Requirements

  • Windows
  • MPC-BE 1.5.6+ (nightly build recommended)
  • DirectX 9.0c+
  • GPU Shader Model 3.0+

Uninstall

Via ProfessionalLighting_Setup.exe → Uninstall button, or:

.\uninstall.ps1

Rollback

# To previous deploy (saved automatically on each install):
cp docs/ProfessionalLighting_SM3.prev.hlsl shaders/ProfessionalLighting_SM3.hlsl
.\install.ps1 -NoPrompt

# To stable baseline:
cp docs/ProfessionalLighting_SM3.backup.hlsl shaders/ProfessionalLighting_SM3.hlsl
.\install.ps1 -NoPrompt

Development

🇷🇺 Русский

Программный Ambilight для MPC-BE — заполняет чёрные полосы цветным свечением с краёв кадра.

Не просто размытие. Полноценная постобработка: живые цвета, кино-компрессия яркости, плёночный ореол, виньетка, хроматическая аберрация. Детектор сам видит где полосы — ничего настраивать вручную не нужно.

Заточен под 4:3 контент, жёстко закодированный в 16:9 контейнер (pillarbox) — самый частый случай для классических сериалов и ретро-контента.

Установка

Запустить ProfessionalLighting_Setup.exe — тёмное окно, кнопка «Установить», готово.

Или через консоль:

install.cmd
.\install.ps1            # с меню
.\install.ps1 -NoPrompt  # тихий режим, для скриптов

Шейдеры устанавливаются в %APPDATA%\MPC-BE\Shaders\.

Включение в MPC-BE

View → Shader → Post-Processing

Выбрать ProfessionalLighting_SM3_Ready.hlsl, нажать OK. Эффект применяется сразу, без перезапуска.

Рендер видео должен быть madVR — шейдер требует madVR для корректной постобработки. Настройки → Видео → Рендер видео → madVR

Рекомендуется ночной билд MPC-BE — в стабильных релизах иногда баги с шейдерами постобработки.

Что делает шейдер

Эффект Что видишь
Ambilight-заливка Цвет с краёв кадра растекается по чёрным полосам
Vibrance Живые насыщенные цвета — не серые, не выцветшие
ACES tone mapping Кино-компрессия яркости: нет пересветов, нет серой каши
Тёплое свечение Плёночный ореол у шва между видео и полосой
Виньетка Лёгкое затемнение углов
Хроматическая аберрация Лёгкое R/B расхождение к углам — как настоящая линза
Вертикальный градиент Верх полос чуть темнее, низ теплее — глубина
Lens dirt Процедурное пятнение: почти невидимо, но добавляет фактуру

Тёмная сцена — свечение подавляется автоматически, полосы остаются чёрными. Нет полос — нет эффекта. Детектор не гадает.

Кастомизация

Хочешь теплее, холоднее, ярче, мягче — смотри VIBE.md. Там маппинг «хочу...» → какие константы менять. Описываешь желаемое AI-ассистенту, он правит шейдер, ты деплоишь и смотришь.

Требования

  • Windows
  • MPC-BE 1.5.6+ (рекомендуется ночной билд)
  • DirectX 9.0c+
  • GPU Shader Model 3.0+

Удаление

Через ProfessionalLighting_Setup.exe кнопка «Удалить», или:

.\uninstall.ps1

Откат

# К предыдущему деплою (автоматически сохраняется при каждой установке):
cp docs/ProfessionalLighting_SM3.prev.hlsl shaders/ProfessionalLighting_SM3.hlsl
.\install.ps1 -NoPrompt

# К эталонной стабильной версии:
cp docs/ProfessionalLighting_SM3.backup.hlsl shaders/ProfessionalLighting_SM3.hlsl
.\install.ps1 -NoPrompt

Разработка