Download & Install

Windows portable build

1. Extract the ZIP package.
2. Place it in a stable path such as C:\DearScenarioPlayer\.
3. Avoid paths with spaces or unusual Unicode characters.
4. Right-click fix-firewall.cmd and run as administrator (allows inbound TCP/UDP for this folder's dearscenario-player.exe on Public and Private networks).
5. Run dearscenario-player.exe; if Windows Firewall still prompts, allow access.
6. Copy a prepared config.json into the extracted directory when required. See Configuration Reference.

The Windows installer Setup configures the same firewall rules automatically. Portable ZIP does not — use fix-firewall.cmd once per extract location (re-run after moving the folder; use remove-firewall.cmd before deleting an old extract). Configure auto-start through your deployment tooling when needed (Task Scheduler, a service wrapper, or managed policy).

Verify integrity

Compare the published .sha256 file with the downloaded ZIP before deploying to an offline or production machine.

First launch

1. A console window appears briefly, then the player window opens.
2. The Web Console should be reachable from the local network.
3. If LAN control fails on a fresh portable extract, run fix-firewall.cmd as administrator (see above). The same repair applies if you earlier clicked Cancel on the Windows Firewall prompt or allowed Private only.
4. Load a media file to confirm playback works.

DEB package

sudo apt install ./dearscenario-player_1.0.0_arm64.deb

After installation, launch the player with:

dearscenario-player

First launch

On first run, the player opens in fullscreen. The Web Console is available at:

http://<pi-ip>:18290

For Lite vs Desktop, systemd/DRM notes, hardware decode, and go-live checks, see Raspberry Pi Deployment. Also configure the control network before relying on remote control.