• merge to main after checks and passing / build
• integrate root /Makefile into /infra/ system and methodology
• continue building of Cdaprod/cdapkg (working copy iphone)
• clean up minio deployment
• clean up tailscale apikey
• reinstitute traefik with tailscale (production networking)

Welcome to your new broadcast control room -- powered by containers, coffee, and code.
I’m Cdaprod, and this repo is my blueprint for a local-first, software-defined, multi-cam live production pipeline.

Here’s a cinematic + DevOps-style analogy to explain what I’ve built:

Streamed Intro Script

"Well I’m here, and you’re watching this video -- so that means one thing: it worked..."

                 [ iPhone | Nikon | MacBook ]
                          |
                          v
                 ┌─────────────────────┐
                 |     NGINX RTMP      |
                 |  (Live Ingest Apps) |
                 └─────────┬───────────┘
                           v
               ┌───────────────────────────┐
               |      Composite Scene      |
               |    (FFmpeg Scene Mixer)   |
               └─────────┬────────────┬────┘
                         |            |
                   [ RTMP ]        [ HLS ]
                     /                 \
            YouTube, Twitch     Web players, Dash.js

• Multiple RTMP Applications: Handle streams from different sources (iphone, nikon, macbook).
• Composite Scenes: Combine multiple streams into a single output for professional broadcasting.
• Portrait Mode Support: Perfectly scales iPhone portrait streams (9:19.5 aspect ratio).
• Placeholder Image: Automatically displays a "We’ll Be Right Back" image when idle.
• HLS Output: Multi-quality streams for adaptive playback.
• Health Checks and Monitoring: Stay on top of your server's health and stream status.

1. Docker: Install Docker on your system.
2. Docker Compose: Ensure Docker Compose is available.

1. Clone the Repository:

   git clone https://github.com/yourusername/local-docker-rtmp-server.git
   cd local-docker-rtmp-server

2. Add Your Placeholder Image:

   • Place your branded image (cdaprod-be-right-back.jpeg) in the public/assets directory. Make it snazzy! 🎨✨

3. Build and Start the Server:

   docker-compose up --build

• RTMP: rtmp://192.168.0.21:1935/stream/<stream-key>
• HLS: http://192.168.0.21:18080/hls/<stream-key>.m3u8

• Statistics: http://192.168.0.21:18080/stat
• Health Check: http://192.168.0.21:18080/health

• Device IPs:

  • iPhone: 192.168.0.10
  • MacBook: 192.168.0.9
  • Nikon: 192.168.0.187
  • RTMP Server: 192.168.0.21

• Stream Keys: Make them unique and secure (e.g., iphone-live, nikon-pro).

• Placeholder: Your custom "We’ll Be Right Back" image streams when idle. 🎨

The following endpoints are triggered by the RTMP server (nginx.conf.template):

• /on_publish?app=...&name=...&addr=...&clientid=...
• /on_publish_done?app=...&name=...&addr=...&clientid=...

Both events are enriched and forwarded to RabbitMQ (stream_events queue).

• Stream Missing:

  • Check device IPs in nginx.conf.
  • Ensure stream key matches.

• Placeholder Not Displaying:

  • Verify the image path in public/assets.

• High Resource Usage:

  • Optimize FFmpeg settings or upgrade hardware.

• Add More Devices:

  • Add applications in nginx.conf.
  • Update composite FFmpeg rules.

• Adjust Quality:

  • Modify resolutions and bitrates in FFmpeg settings.

• Update IPs:

  • Adjust allow publish rules in nginx.conf.

Stream keys uniquely identify streams. Append them to the RTMP URL like this:

rtmp://192.168.0.21:1935/<application>/<stream-key>

• Found an issue? Open an issue or make a PR. 🚀
• Need help? Find me on socials. Let’s chat! ✌️