Files
Atem_Bitfocus_Companion/README.md
Thomas eb8404f831 Update README.md
Logo add
2025-04-23 13:19:06 +02:00

115 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
![Logo](git_logo.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 ATEMs 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!