atvloadly

README

English | 中文

⚠️ Not supported on tvOS 17.0 and above systems. ⚠️

atvloadly is a web service that supports sideloading app on Apple TV. It uses AltServer as the underlying technology for sideloading and automatically refreshes the app to ensure its long-term availability.

Features

• Docker running (only supports Linux/OpenWrt platforms)
• Supports AppleTV pairing
• Supports automatic app refresh
• Supports use of multiple Apple ID accounts
• I18n support

Screenshots

Installation

😔 Only supports Linux/OpenWrt systems, does not support Mac/Windows systems.

1. The Linux/OpenWrt host needs to install avahi-deamon.

   OpenWrt：

   opkg install avahi-dbus-daemon
   /etc/init.d/avahi-daemon start
   

   Ubuntu；

   sudo apt-get -y install avahi-daemon
   sudo systemctl restart avahi-daemon
   

2. Please refer to the following command for installation, remember to modify the mount directory.

   docker run -d --name=atvloadly --restart=always -p 5533:80 -v /path/to/mount/dir:/data -v /var/run/dbus:/var/run/dbus -v /var/run/avahi-daemon:/var/run/avahi-daemon  ghcr.io/bitxeno/atvloadly:latest
   

   Image name: ghcr.io/bitxeno/atvloadly:latest, you need to use this full name with the domain in order to pull it down.

   The /var/run/dbus and /var/run/avahi-daemon of the host machine need to be shared with the docker container for use.

Getting Started

Preparation (very important‼)

• Dedicated Apple ID installation account, both free or developer accounts are acceptable (For security reasons, please do not use commonly used accounts for installation!)
• Login with the installed account on the iPhone (used to authorize trust in atvloadly, will be virtualized as a MacBook, failure to verify the authorization verification code within timeout will result in temporary account freeze! Password reset is required for recovery)

Operation process

1. Open the Apple TV settings menu, select Remote and Devices -> Remote App and Devices, enter pairing mode.
2. Open the web management page, normally it will display the pairable AppleTV.
3. Click on the AppleTV device to enter the pairing page and complete the pairing operation.
4. After successful pairing, return to the home page, where the connected AppleTV will be displayed.
5. Click on the connected AppleTV to enter the sideload installation page, select the IPA file that needs to be sideloaded, and click Install.

FAQ

1. How many apps can be installed with a free account?

Each Apple ID can activate up to 3 apps simultaneously. Installing more than 3 will cause previously installed apps to become unavailable.

1. Installation failure after system upgrade.

After upgrading the system, re-pairing is required. Generally, newly released systems are not supported. It is recommended to disable automatic system updates.

1. Can App-specific passwords be used for passwords? Is it more secure this way?

AltServer currently does not support it.

How to build

>> wiki

Donation

atvloadly is a free open source software that benefits from the open source community, if you appreciate my current work, you can buy me a cup of coffee ☕️.

Thanks for all the love and support ❤️

Disclaimer

• This software is only for learning and communication purposes. The author does not assume any legal responsibility for the security risks or losses caused by the use of this software.
• Before using this software, you should understand and bear corresponding risks, including but not limited to account freezing, which are unrelated to this software.