====== mpv-control ======

Video and image display application for escape rooms. Plays video files, shows images, and plays audio in fullscreen on a dedicated screen — a monitor, TV, or projector connected to a mini-PC.

Controlled via HTTP REST API from Node-RED on the [[main_pc|Main PC]].

**Status:** Production.

===== Key Features =====

  * Fullscreen display of video, images, and audio on a dedicated screen
  * Works with monitors, TVs, and projectors — any display connected via HDMI
  * Any video format and resolution supported (hardware-dependent)
  * Simple HTTP GET API — easy integration with Node-RED

===== Supported Formats =====

  * **Video:** MP4, MKV, AVI
  * **Images:** JPG, JPEG, PNG, BMP
  * **Audio:** MP3, WAV

===== How It Works =====

mpv-control runs on a dedicated mini-PC (BeeLink) connected to a display. The application controls the MPV media player via IPC socket. Node-RED sends simple HTTP GET requests to trigger playback.

Files are loaded paused by default — a separate play command starts the playback. This allows precise synchronization with other room events.

===== HTTP API =====

All endpoints use **GET** method. Default port: **3000**.

^ Endpoint ^ Description ^
| ''/files'' | List all media files in the media directory (JSON tree) |
| ''/load?file=<path>'' | Load a file (paused by default) |
| ''/play'' | Start or resume playback |
| ''/pause'' | Pause playback |
| ''/stop'' | Stop playback |
| ''/forward'' | Seek forward 10 seconds |
| ''/backward'' | Seek backward 10 seconds |

===== Hardware =====

  * **Computer:** BeeLink mini-PC with HDMI output to the display
  * **Display:** Any monitor, TV, or projector connected via HDMI
  * **Media directory:** ''/home/er/media'' — upload media files here
  * **Startup:** Automatic — the application starts on boot, no manual intervention needed

→ **[[products:mpv-control-api|Full API reference]]**

===== Web UI =====

A built-in web interface is available at ''http://<ip>:3000'' for manual testing — file browser with playback controls. During normal operation, everything is controlled from Node-RED.