diff --git a/Logo.png b/Logo.png new file mode 100644 index 0000000..1449e23 Binary files /dev/null and b/Logo.png differ diff --git a/README.md b/README.md new file mode 100644 index 0000000..e0d1b8f --- /dev/null +++ b/README.md @@ -0,0 +1,112 @@ +# ATEM Mini Pro + Mix It Up Bot Integration + +Denne guide viser, hvordan du integrerer **ATEM Mini Pro** med **Mix It Up Bot** via **Bitfocus Companion**, inkl. brug af makroer og billed-i-billede (PiP)-effekter. + +--- + +## Forudsætninger +- ATEM Mini Pro (på samme netværk som din PC) +- Bitfocus Companion installeret: [bitfocus.io/companion](https://bitfocus.io/companion) +- ATEM Software Control (til oprettelse af makroer) +- Mix It Up Bot installeret: [mixitupapp.com](https://mixitupapp.com) + +--- + +## Trin 1: Opret en Makro i ATEM Software Control + +1. Åbn **ATEM Software Control** og gå til **Macros** fanen. +2. Klik **Create New Macro**, navngiv den fx `Start PiP`. +3. Klik **Record** og: + - Vælg et input (fx kamera 1) + - Aktivér DVE for PiP + - Justér størrelse og placering +4. Klik **Stop** og derefter **Save**. + +![ATEM Macro Setup](images/atem_macro_setup.png) + +> Gentag for `Stop PiP` makroen, som slår DVE fra eller skjuler PiP. + +--- + +## Trin 2: Tilføj ATEM Mini i Companion + +1. Åbn Companion (http://localhost:8000). +2. Gå til **Instances** > **Add by Category** > vælg **Blackmagic Design ATEM**. +3. Indtast ATEM’s IP (fx `192.168.1.100`). + +--- + +## Trin 3: Opret Knapper i Companion til Makroer + +1. Gå til **Buttons**, fx side 1: + +### Start PiP +- Bank 1/1 +- Navn: `Start PiP` +- **Press Action:** + - Action: `atem: Run Macro` + - Vælg makro nr. (fx 1) + +### Stop PiP +- Bank 1/2 +- Navn: `Stop PiP` +- **Press Action:** + - Action: `atem: Run Macro` + - Vælg makro nr. (fx 2) + +![Companion Button](images/companion_button.png) + +--- + +## Trin 4: Aktiver HTTP Server i Companion + +1. Gå til **Settings** > **HTTP Server**. +2. Slå **Enable HTTP Server** til (standardport er `8000`). +3. Brug disse links til test: + - Start PiP: `http://[Companion_IP]:8000/press/bank/1/1` + - Stop PiP: `http://[Companion_IP]:8000/press/bank/1/2` + +--- + +## Trin 5: Opsæt Mix It Up Kommandoer + +### !pip +1. Gå til **Commands** > **Channel Commands** > **Add Command** +2. Navn: `!pip` +3. Tilføj en **Web Request Action**: + - Method: `GET` + - URL: `http://[Companion_IP]:8000/press/bank/1/1` +4. Tilføj en **Chat Message Action**: "Billed-i-billede aktiveret!" + +### !pipoff +1. Opret ny kommando `!pipoff` +2. Web Request URL: `http://[Companion_IP]:8000/press/bank/1/2` +3. Chatbesked: "Billed-i-billede deaktiveret." + +![Mix It Up Webhook](images/mixitup_webhook.png) + +--- + +## Test det! + +- Skriv `!pip` i chatten for at aktivere PiP. +- Skriv `!pipoff` for at deaktivere det. + +--- + +## Ekstra Kommandoer + +- **!kamera1, !kamera2** – Brug Companion knapper til input-skift. +- Tilføj cooldowns eller permissions i Mix It Up for at begrænse adgang. + +--- + +## Links +- [Bitfocus Companion](https://bitfocus.io/companion) +- [Mix It Up Bot](https://mixitupapp.com) +- [Blackmagic ATEM Mini Pro](https://www.blackmagicdesign.com/products/atemmini) + +--- + +## License +Feel free to fork, modify, and share! \ No newline at end of file