Using an HDMI Encoder with ah4c:appletv capturing from an AppleTV running the Cox Contour App

[mnwxman132]

Im using : docker desktop 4.42.1 (196648)

I saw the PSA you linked and got very excited. There is an option to select enable host networking. However, according to CHatGPT, when I asked it

On the docker desktop dashboard under resources\network there is a radio button to "enable host networking". would that work?

ChatGPT replied..

---

Unfortunately no, not on macOS. Here’s the key reason:

macOS does not support true host networking in Docker

Even though Docker Desktop for Mac shows a checkbox for “Enable host networking,” it’s only effective on Linux. On macOS, this option is ignored, and host networking is silently disabled due to how Docker runs using a lightweight Linux VM under the hood (via qemu or virtiofs).

So:

• Checking “Enable host networking” on macOS does not actually enable it.
• Docker containers still run in a VM with their own private network.
• This means containers cannot natively access the Mac’s Tailscale network or LAN broadcast services like mDNS.

Workaround Options

To work around this on macOS:

1. Run pyatv from macOS directly (as you’ve done — this works).
2. Bridge your Docker container to a custom network with specific routing (complicated).
3. Run Tailscale inside the container, giving it its own tailnet IP (advanced).
4. Use Tailscale Subnet Router from another LAN device, so Docker can reach .1.x devices like Apple TV indirectly (clean and safe, but needs another node).

Let me know which direction you’d prefer — especially if keeping Docker portable is still a priority.

---

Im still going to try this anyway, perhaps ChatGPT has developed an ego, and is locked to its opinion.....

[chDVRuser]

@mnwxman132

Im still going to try this anyway, perhaps ChatGPT has developed an ego, and is locked to its opinion.....

[bnhf]

@mnwxman132 I'm pretty certain host networking is not required. Though I've never used ah4c:pyatv in production, I did test it a number of times using an AppleTV on my network with standard bridge networking.

If you look at the pairing script @ChannelSam used, and his Docker Compose, you'll see he's not using host networking either:

@ChannelSam

atvpair.sh

#! /bin/bash

#docker exec -it ah4c scripts/atv/spectrum/atvpair.sh <appletv_ip>

streamerIP="$1"

mv /root/.android/.pyatv.conf /root 2>/dev/null || echo "No existing .pyatv.conf found"

atvremote -s $streamerIP --protocol companion pair

mv /root/.pyatv.conf /root/.android && echo ".pyatv.conf moved to persistent directory"

The command both of us used to pair devices is shown in the script as a comment.

His Docker Compose:

@ChannelSam

version: '3.9'
services:
  ah4c:
    image: bnhf/ah4c:${TAG}
    container_name: atvtuner
    hostname: atvtuner
    dns_search: ${DOMAIN} # Specify the name of your LAN's domain, usually local or localdomain
    ports:
      #- ${ADBS_PORT}:5037 # Port used by adb-server
      - ${HOST_PORT}:7654 # Port used by this ah4c proxy
      #- ${WSCR_PORT}:8000 # Port used by ws-scrcpy
    environment:
      - IPADDRESS=${IPADDRESS} # Hostname or IP address of this ah4c extension to be used in M3U file (also add port number if not in M3U)
      - NUMBER_TUNERS=${NUMBER_TUNERS} # Number of tuners you'd like defined 1, 2, 3 or 4 supported
      - TUNER1_IP=${TUNER1_IP} # Streaming device #1 with adb port in the form hostname:port or ip:port
      - TUNER2_IP=${TUNER2_IP} # Streaming device #2 with adb port in the form hostname:port or ip:port
      - TUNER3_IP=${TUNER3_IP} # Streaming device #3 with adb port in the form hostname:port or ip:port
      - TUNER4_IP=${TUNER4_IP} # Streaming device #4 with adb port in the form hostname:port or ip:port
      - ENCODER1_URL=${ENCODER1_URL} # Full URL for tuner #1 in the form http://hostname/stream or http://ip/stream
      - ENCODER2_URL=${ENCODER2_URL} # Full URL for tuner #2 in the form http://hostname/stream or http://ip/stream
      - ENCODER3_URL=${ENCODER3_URL} # Full URL for tuner #3 in the form http://hostname/stream or http://ip/stream
      - ENCODER4_URL=${ENCODER4_URL} # Full URL for tuner #4 in the form http://hostname/stream or http://ip/stream
      - STREAMER_APP=${STREAMER_APP} # Streaming device name and streaming app you're using in the form scripts/streamer/app (use lowercase with slashes between as shown)
      - USER_SCRIPT=${USER_SCRIPT} #User startup script that runs at startup located in scripts directory

      - CHANNELSIP=${CHANNELSIP} # Hostname or IP address of the Channels DVR server itself
      - ALERT_SMTP_SERVER=${ALERT_SMTP_SERVER} # The domainname:port of the SMTP server you'll be using like smtp.gmail.com:587. This is for sending ah4c alerts if tuning fails.
      - ALERT_AUTH_SERVER=${ALERT_AUTH_SERVER} # The auth server for the e-mail you'll be using like smtp.gmail.com
      - ALERT_EMAIL_FROM=${ALERT_EMAIL_FROM} # The e-mail address you'd like your ah4c failure alert e-mails to show as being from.
      - ALERT_EMAIL_PASS=${ALERT_EMAIL_PASS} # Gmail and Yahoo both support the creation of app-specific e-mail passwords, and this is the way to go! It's NOT recommended to use your everyday e-mail password.
      - ALERT_EMAIL_TO=${ALERT_EMAIL_TO} # The e-mail address you'd like your alert e-mails sent to.
      #- ALERT_WEBHOOK_URL=""
      - LIVETV_ATTEMPTS=${LIVETV_ATTEMPTS} # For FireTV Live Guide tuning only, set maximum number of attempts at finding the desired channel
      - CREATE_M3US=${CREATE_M3US} # Set to true to create device-specific M3Us for use with Amazon Prime Premium channels -- requires a FireTV device
      - UPDATE_SCRIPTS=${UPDATE_SCRIPTS} # Set to true if you'd like the sample scripts and STREAMER_APP scripts updated whether they exist or not
      - UPDATE_M3US=${UPDATE_M3US} # Set to true if you'd like the sample m3us updated whether they exist or not
      - TZ=${TZ} # Your local timezone in Linux "tz" format
    volumes:
      - ${HOST_DIR}/scripts:/opt/scripts # pre/stop/bmitune.sh scripts will be stored in this bound host directory under streamer/app
      - ${HOST_DIR}/m3u:/opt/m3u # m3u files will be stored here and hosted at http://<hostname or ip>:7654/m3u for use in Channels DVR - Custom Channels settings
      - ${HOST_DIR}/adb:/root/.android # Persistent data directory for adb keys
    restart: unless-stopped

TAG=appletv
DOMAIN=localdomain
ADBS_PORT=
HOST_PORT=7654
WSCR_PORT=
IPADDRESS=192.168.1.101:7654
NUMBER_TUNERS=2
TUNER1_IP=192.168.1.54
TUNER2_IP=192.168.1.55
ENCODER1_URL=http://192.168.1.41:8090/stream3
ENCODER2_URL=http://192.168.1.41:8090/stream4
STREAMER_APP=scripts/atv/spectrum
USER_SCRIPT=scripts/tuners_stop_delay.sh
CHANNELSIP=http://192.168.1.20:8089
ALERT_SMTP_SERVER=
ALERT_AUTH_SERVER=
ALERT_EMAIL_FROM=
ALERT_EMAIL_PASS=
ALERT_EMAIL_TO=
LIVETV_ATTEMPTS=2
CREATE_M3US=false
UPDATE_SCRIPTS=false
UPDATE_M3US=false
TZ=America/New_York
HOST_DIR=/srv/5ab84941-c842-42b9-9bce-80979edd927d/Pool/_AppData/atvtuner

Note that host mode is not in use.

[mnwxman132]

@bnhf @ChannelSam

Just wanted to poke in and report back to you both. I have a proof of concept working tuner for the cox contour app with some hardcoded logic up and running end to end with channels.

Some early observations are that

1: Olivetin is freakin awesome. The "find grace note IDs" has already payed huge dividends. Cant thank you enough for all you do @bnhf

2: The manual pairing and tuning using mimicked button keypress works, but is highly dependent on each individual apps like spectrum, or cox, or some others individual UI. With spectrum, it looks like you are using streamlink —edit I meant deep links- @ChannelSam , so the tuning is quick

3: For those go us using

atvremote --storage-filename /root/.android/.pyatv.conf -s 10.10.11.42 up
atvremote --storage-filename /root/.android/.pyatv.conf -s 10.10.11.42 down

type commands the tuning is slow and inefficient, and at times can be limiting if future expansion is needed.

3: Ive already tested a simple python script that can allow alphanumeric entry for tuning to reduce the slow key press wait times. This will allow for future expansion and quicker channel tuning and flipping live.

4: As I integrate this more and fine tune the scripts, it may be possible to make a stable "generalized Apple TV tuning model" for ANY app that is installed. Im jumping ahead of myself, but I could see it happen. It would be a series of Python and ah4c scripts combined. Have to think this through more,

My new shorter term goal is to write stable python bmitune, prebmitune (if needed) and stopbmitune Iiff needed) scripts. that can call the more advanced alphanumeric entries for channel tuning using the cox search bar. This will be my next proof of concept phase. Im currently moving logic blocks around where the more advance calls are made.

Thanks to you both and have a great 4th. I need a break. ChatGPT does have an ego, and a short memory as well.

[ChannelSam]

@mnwxman132

Thanks for the update.
I am not sure if you are aware of some of this or not so I will take a mention it.
The links I am using to "tune" the channels on ATV4k are called deeplinks...This is the same thing that ADBTuner uses to tune channels on android devices if that device supports adb debugging and the particular app supports deeplinks.

What I posted was my beginning script for tuning because I am trying to do some different things that complicate the script for no reason. With a few changes using "Case" in your scripts you can have different commands that could tell bmitune to use a specific tuner for that channel, use specific commands only for some channels. The current ATV version of ah4c doesn't support android adb so you would have to spin those up on a second instance with android support. If you look at the firetv scripts installed automatically you can see an example of using "Case"

If you haven't investigated whether Cox has deeplinks you can use a few things to give you clues.
If you are looking at the Cox app and watching a channel on a computer, phone or tablet does it allow you to "cast it" directly to your tv/appletv/android tv.
Another way to know is if the Cox app intergrates with the ATV main menu, tv providers. If you see menu items at the top showing what is currently on cox tv channels allowing you to click on them AND go directly to that channel THAT is a deeplink.

Where it gets extra complicated is that they may support deeplinks on some devices and not on others. One example of this is Spectrum...It supports deeplinks on ATVs but NOT on Roku devices (Rokus were going to be my original low cost solution to tune spectrum channels). And spectrum is not available at all on Firetv or Android devices (I assume because they can't agree who deserves to get more money from their customers. lol)
Do some searching about deeplinks on the forum where it talks about finding them.

You don't need separate entries for each command in atvremote it supports multiple commands and delays separated by spaces.
Example:

/usr/local/bin/atvremote --storage-filename /root/.android/.pyatv.conf -s $streamerIP up up up delay=2000 left left delay=1000 select

Good Luck, Keep us informed.

[mnwxman132]

@ChannelSam

If you haven't investigated whether Cox has deeplinks you can use a few things to give you clues

Thanks. I’ll research further. I think I said something about streamlinks in my last post, but I meant deep links.

I spent a lot of time when I first got my linkPi playing with an android firestick and also an onn device. As well as the iPhone cox contour app, and diving into its apk file for deeplinks. Then later also chrome capture. I ran into many many different authorization issues of different manifestations on different approaches and tuner platforms Between NBC affiliates and COX it just made more sense to use the native contour app on the ATV in my case. Very very stable with no authorization hiccups for many months now.

But thanks for the tips. I’ll investigate adding the multiple commands in each case. Perhaps when my head is back in it next week I may poke you again if you don’t mind for and example syntax if I can’t figure it out with ChatGPT. And I’m gonna revisit the deep link search on the ATV the way you suggested.

Thanks for sharing and supporting me and others!!

I’m gonna eventually summarize all my pitfalls that a I ran into in a new preface to this thead, so others can benefit and build their own stuff too. Just need a break for now.

Thank you for paying it forward. Appreciate it. I’ll do the same

[bnhf]

@ChannelSam

That's all I can think of right now...

@ChannelSam I was just adding your scripts/atv/spectrum files to the repo, and I noticed you didn't include prebmitune.sh. Could you post that one too please?

[mnwxman132]

@bnhf I just poked around in my development environment to take a look at my scripts. The docker compose and env are very straight forward based on your templates. I have a bunch of python scripts that are running in my tuner container that are called from bmitune and stopbmitune. I created an alphanumeric tuner, that works on the appletv that could potentially work in other applications that dont support deeplinks. The alphanumeric approach is relatively fast and much more flexible instead of mimicking remote control pad keypresses - depending on the situation. However, right now it is hardcoded strictly for the cox application, and it works as long as the application is in the correct search menu. Thats where an OCR or other watchdog might make sense. And to preserve decent tuning times it may or may not make sense to have this watchdog running all the time in a separate container that can be called by all the various tuners in multiple stacks. I need to take some time to think about this all further.

In the meantime thinking slightly ahead, how would you like me to post these scripts once there a little more cleaned up for others to use?

I could post here on this thread, or post them on GitHub or we could direct message? At the moment, these are not ready for prime time, but very workable here for me - If that makes sense. There would be a mix of shell scripts and python scripts etc

[bnhf]

@mnwxman132

I could post here on this thread, or post them on GitHub or we could direct message?

What would you think about PM'ing me the scripts as they are now (which I won't share), so I can see what we're talking about -- and how things might work as far as including them in the container.

To date the scripts have always been in bash, so there may be a few new things to consider on my end.

Ultimately the idea would be to add them to the ah4c repo, just in case anyone wants to build from source.

[ChannelSam]

I don't run any prebmitune.sh code.
It is just a script with no run instructions...

premitune.sh

#!/bin/bash

# Nothing needed in this file!

[bnhf]

@ChannelSam

I don't run any prebmitune.sh code.
It is just a script with no run instructions...

It needs to be included though; ah4c doesn't work without its scripts, even if they're "no op".

[benmarks]

If I am understanding this thread correctly, does this setup only support the Cox and Spectrum AppleTV apps? If so, is there any potential to support other apps like the DirecTV app?

[ChannelSam]

@benmarks
This version of ah4c with the appletv tag is just a special version of ah4c that has had python and pyatv installed in the image.

This allows us to control Atv's as our "tuners"
It can "support" any app that is installed on an ATV "tuner". How easy it is to control any particular app would depend on THAT specific app. If it supports deeplinks then you should be able to directly start each channel directly. If it doesn't then you might need to send a series of directional/select commands instead.

Specifically for Directv, You might find it makes alot more sense to use an android dongle or directv android box and the regular version of ADBTuner or ah4c instead.

[benmarks]

I see, ok thanks. I currently have ah4c + Osprey box, but the Osprey is the only non-Apple device in my environment, so I was hoping there might be a viable ah4c + AppleTV option. But, I don't have the skillset to modify what's outlined in this thread for another app.

[ChannelSam]

@benmarks

I think I have read somewhere that nothing tunes as fast as the ospreys since they are basically running the directv app constantly...

If you decide you want to try with an ATV we can do some experiments with one of the AppleTVs you already have without setting anything up in channels just to test deeplinks/tuning. I would be happy to help walk you through it...

Basically we would install/run a new container using bnhf/ah4c:appletv image.

then we would use the "Exec Console" in the new ah4c docker container to "register" your test ATV so we can manually send commands using "pyatv/atvremote" to see what commands we need to use for launching/closing directv links on ATVs.

You should be able to do all this without intergrating anything into Cdvr or even using an encoder as long as you can see the hdmi output on the ATV.
Just tag me with @ChannelSam so I see it if you decide to try.