Update README for MediaBMS rebrand

Generic media player support, not just YouTube Music.
Includes DED controls table, HOTAS callbacks, build instructions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: gilgonore

README.md

@@ -1,72 +1,101 @@
-# BMS YouTube Music Bridge
+# MediaBMS
 
-Emula Winamp para que Falcon BMS pueda controlar YouTube Music desde el ICP/DED.
+Control your music from the cockpit. MediaBMS bridges Falcon BMS's Crew Entertainment System with any modern media player.
 
-## Como funciona
+Works with **YouTube Music**, **Apple Music**, **Spotify**, and any app that integrates with Windows media controls.
 
-1. Crea una ventana "fake" con la clase `Winamp v1.x` que BMS busca
-2. Recibe los comandos IPC que BMS envia (play, pause, next, prev, etc.)
-3. Reenvía esos comandos a YouTube Music usando `WM_APPCOMMAND` de Windows
+## How it works
 
-## Requisitos
+MediaBMS emulates Winamp by creating a hidden window with the `Winamp v1.x` class that BMS looks for. When BMS sends playback commands through the ICP/DED, MediaBMS translates them into Windows Media Session API calls, controlling whatever media player you have running.
 
-- Windows 10/11
-- Python 3.8+
-- Falcon BMS 4.37+
-- YouTube Music abierto en el navegador
+```
+Falcon BMS  --->  MediaBMS (Winamp emulation)  --->  Your media player
+  ICP/DED          WM_USER / WM_COMMAND               Windows Media API
+```
 
-## Instalacion
+## Features
 
-```bash
-pip install -r requirements.txt
-```
+- Play / Pause / Stop (stop pauses without losing your queue)
+- Next / Previous track
+- Per-app volume control (only changes your music player volume, not the game)
+- Track title and artist displayed in the DED
+- Runs silently in the system tray
 
-O simplemente ejecuta `run.bat` que instala todo automaticamente.
+## Download
 
-## Uso
+Grab `BMSBridge.exe` from [Releases](https://github.com/gilgonore/MediaBMS/releases) -- no Python or dependencies needed.
 
-1. Abre YouTube Music en tu navegador (Chrome, Edge, Firefox)
-2. Ejecuta `run.bat` o `python bms_bridge_tray.py`
-3. Inicia Falcon BMS
-4. En el cockpit, usa el ICP para ir a la pagina ENTERTAINMENT en el DED
-5. Controla la musica con los comandos del ICP
+## Usage
 
-## Comandos del DED
+1. Open your music player and start playing something
+2. Run `BMSBridge.exe` (a blue icon appears in the system tray)
+3. Start Falcon BMS
+4. In the cockpit: **LIST > M-SEL 0 > M-SEL 0** to open the Entertainment page
 
-Segun el manual de BMS (pagina 104), los controles son:
+### DED Controls
 
-- **DCS UP/DOWN**: Navegar en la playlist
-- **INC/DEC**: Volumen
-- **RTN**: Play/Pause
+| Control | Action |
+|---------|--------|
+| DCS UP | Next track |
+| DCS DOWN | Previous track |
+| DCS SEQ | Toggle pause |
+| INC / DEC | Volume up / down |
+| DCS RTN | Exit entertainment page |
 
-## Archivos
+### Keyboard / HOTAS Callbacks
 
-- `bms_bridge.py` - Version con ventana visible (para debug)
-- `bms_bridge_tray.py` - Version con system tray (recomendada)
-- `media_controller.py` - Controlador de YouTube Music
-- `winamp_constants.py` - Constantes de la API de Winamp
-- `run.bat` - Script de ejecucion
+These callbacks can be mapped in your BMS key file (section 6.07 WINAMP):
+
+- `WinAmpNextTrack` / `WinAmpPreviousTrack`
+- `WinAmpTogglePlayback` / `WinAmpTogglePause`
+- `WinAmpStartPlayback` / `WinAmpStopPlayback`
+- `WinAmpVolumeUp` / `WinAmpVolumeDown`
+
+## Requirements
+
+- Windows 10 or 11
+- Falcon BMS 4.37+
+- Any media player (YouTube Music, Apple Music, Spotify, etc.)
 
-## Logs
+## Setup
 
-Los logs se guardan en `bms_bridge.log` para debug.
+Make sure `g_bPilotEntertainment` is set to `1` in your BMS config file. See the BMS Technical Manual for details.
+
+## Building from source
+
+```bash
+py -m venv venv
+venv\Scripts\pip install -r requirements.txt
+venv\Scripts\pip install pycaw winrt-runtime winrt-Windows.Media.Control winrt-Windows.Foundation pyinstaller
+venv\Scripts\pyinstaller bms_bridge.spec --clean
+```
+
+The executable will be in `dist/BMSBridge.exe`.
 
 ## Troubleshooting
 
-**BMS no detecta el bridge:**
-- Asegurate que el bridge este corriendo ANTES de iniciar BMS
-- Verifica que no haya otra instancia de Winamp corriendo
+**BMS doesn't detect MediaBMS:**
+- Make sure MediaBMS is running BEFORE you start BMS
+- Check that Winamp is not running (BMS can only talk to one Winamp window)
+
+**Music doesn't respond to commands:**
+- Make sure your media player is open and has played at least one song
+- The player can be minimized but must be running
+
+**Volume doesn't change:**
+- MediaBMS controls per-app volume. Check your system volume mixer to confirm
+
+**No track info in DED:**
+- Track info updates every 2 seconds
+- Some players may take a moment to report metadata
 
-**La musica no responde:**
-- Asegurate que YouTube Music este abierto y activo en el navegador
-- La ventana del navegador debe estar abierta (puede estar minimizada)
+## Tested with
 
-**El titulo no aparece en el DED:**
-- El titulo se lee de la ventana del navegador
-- Formato esperado: "Cancion - Artista - YouTube Music"
+- YouTube Music (Chrome)
+- Apple Music (Windows app)
 
-## Referencias
+## References
 
-- [Reddit thread original](https://www.reddit.com/r/falconbms/comments/1f05hyd/bms_crew_entertainment/)
+- [BMS Crew Entertainment discussion](https://www.reddit.com/r/falconbms/comments/1f05hyd/bms_crew_entertainment/)
 - [Winamp SDK](https://github.com/hugovk/winamp)
-- [BMS User Manual - Pagina 104](https://www.falcon-bms.com/)
+- [YASB media widget](https://github.com/amnweb/yasb) (inspiration for Windows Media Session API approach)