First

First files

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!