Theos DEB Compiler Assistant

Generate Makefile and control files for iOS jailbreak package compilation

Project Configuration

Basic Information

Build Settings

Generated Makefile

Save as 'Makefile' in project root

Generated Control File

Save as 'control' in layout/DEBIAN/

Quick Command Reference

Build Commands

make Compile project
make package Build DEB package
make install Install to device
make do Build + Package + Install

Utility Commands

make clean Clean build files
make update-theos Update Theos
make stage Stage files
make debug Build with debug symbols

When to Use Theos DEB Compiler

New Tweak Development

Starting a new iOS jailbreak tweak project and need proper Makefile and control file configuration with correct architecture targets and dependencies for modern jailbreaks.

Rootless Migration

Converting existing rootful tweaks to support rootless jailbreaks like Dopamine or Palera1n. Automatically updates architecture settings and installation paths for iOS 15+ compatibility.

Package Publishing

Preparing DEB packages for distribution on Cydia, Sileo, or other package managers. Generate proper control files with maintainer information and dependency declarations.

Troubleshooting Build Issues

Fixing compilation errors related to incorrect Makefile settings, missing dependencies, or architecture mismatches. Compare your configuration against properly generated templates.

Swift Tweak Development

Building iOS tweaks using Swift instead of Objective-C. Automatically includes necessary Swift runtime libraries and proper framework linkage in your configuration files.

Learning Theos Development

Understanding proper Theos project structure and configuration as you learn iOS jailbreak development. See correct examples and understand the purpose of each configuration option.

Frequently Asked Questions

What is Theos DEB Compiler Assistant?

Theos DEB Compiler Assistant is a free online tool that helps iOS jailbreak developers generate proper Makefile and control file configurations for building DEB packages using Theos. It provides templates for both rootless and rootful jailbreaks, ensuring correct architecture targets and dependency settings.

How do I compile a DEB package with Theos?

To compile a DEB package: First, set up your project with proper Makefile and control file using our generator. Then run 'make package' in your project directory to build and create the DEB file. Use 'make install' to deploy to your device, or 'make do' to compile, package, and install in one command. The DEB file will be created in the packages directory.

What's the difference between rootless and rootful jailbreaks?

Rootless jailbreaks (iOS 15+) install tweaks to /var/jb/ instead of system directories for enhanced security. They require arm64e architecture target, while rootful jailbreaks use arm64. Rootless also has different dependency declarations and installation paths. Our tool automatically configures the correct settings based on your jailbreak type selection.

Is this Theos compiler tool free to use?

Yes, this tool is completely free with no restrictions. Generate unlimited Makefile and control file configurations for your Theos projects. No registration or account required. Download and use the generated files in your commercial or open-source projects without any limitations.

What iOS versions does this support?

This tool supports configuration generation for iOS 13 through iOS 26 (the latest version), including both rootful jailbreaks like Checkra1n and Unc0ver, and rootless jailbreaks like Dopamine and Palera1n. Select your target iOS version from the dropdown to ensure proper SDK settings and compatibility flags are included in your configuration.

Can I use this for Swift-based tweaks?

Yes, our tool fully supports both Objective-C and Swift tweak projects. When you select Swift as your programming language, the generator automatically includes necessary Swift runtime libraries, proper framework linkage, and additional compilation flags required for Swift development with Theos.

How do I fix 'Could not find deb package' error?

This error typically means the package wasn't built successfully. First, ensure your Makefile includes 'include $(THEOS)/makefiles/common.mk' at the bottom. Run 'make clean' to remove old build files, then try 'make package' again. Check that your PROJECT_FILES variable includes all necessary source files and that there are no compilation errors in your code.

Where can I download the generated configuration files?

After configuring your project settings and clicking 'Generate Configuration Files', use the download buttons above each output area. Save the Makefile to your project root directory and the control file to layout/DEBIAN/control. Make sure the DEBIAN directory exists and the control file has no file extension. You can also copy the content directly using the copy buttons.

Recommended Tools

💬 User Comments

Share your thoughts and feedback about this tool

Please login to leave a comment

No comments yet. Be the first to share your thoughts!

×

Rate this tool

Select a rating