Atem_Bitfocus_Companion/README.md

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
• ATEM Software Control (til oprettelse af makroer)
• Mix It Up Bot installeret: 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.

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)

---

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."

---

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
• Mix It Up Bot
• Blackmagic ATEM Mini Pro

---

License

Feel free to fork, modify, and share!