Skip to content

dxcool222/aether-tv

Repository files navigation

tvOS Tweaker

A GUI application for injecting tweaks into tvOS applications (IPA/TIPA files).

Features

  • Modern dark-themed user interface
  • Support for injecting DEB or DYLIB files into IPA/TIPA files
  • Automatic dependency management (Homebrew, ldid, optool)
  • Detailed logging for troubleshooting
  • Automatic extraction of DYLIB files from DEB packages

Requirements

  • macOS
  • Python 3.6+
  • Homebrew (will prompt if not installed)
  • ldid (automatically installed via Homebrew if missing)
  • optool (automatically installed if missing)

Installation

  1. Clone or download this repository
  2. Install the required Python packages:
pip install -r requirements.txt

Usage

  1. Launch the application:
python tvos_tweaker_ui.py
  1. Click "Select tvOS App" to choose your IPA/TIPA file
  2. Click "Select Tweak" to choose your DEB or DYLIB file
  3. Click "Inject" to start the injection process
  4. The output file will be saved in the same directory as the input IPA/TIPA with "_tweaked" added to the filename

Troubleshooting

Common Issues

Python Not Found

If you see an error about Python not being found, make sure you have Python 3.7 or later installed. You can download it from python.org.

PyQt6 Installation Failed

If PyQt6 fails to install automatically, you can install it manually with:

pip3 install --user PyQt6 packaging

Homebrew Installation Issues

If Homebrew installation fails, you can install it manually by following the instructions at brew.sh.

ldid Not Found

If ldid is not found, you can install it manually with:

brew install ldid

Permission Denied

If you see "Permission Denied" errors when running the launcher script, make it executable with:

chmod +x Launch_Aether_TV.command

Credits

  • Special thanks to Nitro TV for help with ElleKit
  • Thanks to all contributors and testers

License

This project is licensed under the MIT License - see the LICENSE file for details.

About

A tool for tweaking Apple TV apps

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors