![Logo](git_banner.png)

# 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!
