Usage Guide

Learn how to use roothide Bootstrap and configure your device

Getting Started

After installing roothide Bootstrap using TrollStore (see Building & Installation), you'll need to configure it for your needs. This guide will walk you through the essential features and usage.

Initial Setup

1. Launch the Bootstrap App

After installation, locate and launch the roothide Bootstrap app from your home screen. The app icon should be visible after successful installation via TrollStore.

2. Developer Mode (TrollStore 2.0.9+)

If you're using TrollStore version 2.0.9 or later, you can enable developer mode on-device. This provides enhanced functionality and is recommended for the best experience.

Follow the on-screen instructions in the Bootstrap app to enable developer mode if prompted.

Tweak Injection

By design, roothide does not inject tweaks into any applications by default. You must manually enable injection for each application you want to customize.

Enabling Tweak Injection

  1. Open the roothide Bootstrap app
  2. Tap on "App List" in the main interface
  3. You'll see a list of installed applications
  4. Toggle the switch next to each application you want to inject tweaks into
  5. The changes take effect immediately

Important Notes

  • SpringBoard Injection: Injection into com.apple.springboard or daemons is not possible with roothide Bootstrap by design. This is a security and stability feature.
  • Application-Specific: Each application must be individually enabled for tweak injection
  • Immediate Effect: Changes take effect immediately after toggling, but you may need to restart the target application

Using Tweaks

Compatibility

Tweaks not compiled or converted to roothide will not work out-of-the-box with roothide Bootstrap. You have two options:

Option 1: Use roothide-Compatible Tweaks

Install tweaks that have been specifically compiled or converted for roothide. These tweaks will work seamlessly with roothide Bootstrap.

Option 2: Convert Existing Tweaks

Use roothide Patcher to convert existing tweaks to be compatible with roothide. Refer to the FAQ for detailed instructions on using roothide Patcher.

Installing Tweaks

Tweaks can be installed through package managers like:

  • Sileo: Modern package manager with roothide support
  • Zebra: Alternative package manager
  • Manual Installation: Using .deb packages

Package Managers

roothide Bootstrap includes support for popular package managers. These are typically installed as part of the bootstrap or can be added separately.

Sileo

Sileo is a modern package manager designed for iOS. It provides a clean interface and full roothide support.

Zebra

Zebra is an alternative package manager that also supports roothide Bootstrap.

Adding Repositories

To install tweaks, you'll need to add repositories (repos) to your package manager:

  1. Open your package manager (Sileo or Zebra)
  2. Navigate to the "Sources" or "Repositories" section
  3. Tap "Add Source" or the "+" button
  4. Enter the repository URL
  5. Confirm the addition

Common Tasks

Enabling Tweaks for Specific Apps

To enable tweaks for a specific application:

  1. Open roothide Bootstrap app
  2. Go to App List
  3. Find your target application
  4. Enable the toggle
  5. Restart the application

Disabling Tweaks

To disable tweaks for an application:

  1. Open roothide Bootstrap app
  2. Go to App List
  3. Find the application
  4. Disable the toggle
  5. Restart the application

Managing Installed Tweaks

Use your package manager (Sileo or Zebra) to:

  • View installed tweaks
  • Update tweaks
  • Remove tweaks
  • Configure tweak settings

Best Practices

  • Enable Only What You Need: Only enable tweak injection for applications that actually need tweaks. This improves performance and stability.
  • Use Compatible Tweaks: Always use tweaks that are compatible with roothide or have been converted using roothide Patcher.
  • Keep Updated: Regularly update roothide Bootstrap and your tweaks for the latest features and security fixes.
  • Backup Before Changes: Before installing major tweaks or making significant changes, ensure you have backups.
  • Read Tweak Documentation: Always read the documentation for tweaks before installing them.

Troubleshooting

Tweaks Not Working

  • Verify that tweak injection is enabled for the target application in App List
  • Ensure the tweak is compatible with roothide or has been converted
  • Restart the target application after enabling injection
  • Check if the tweak requires a respring (not available in roothide)

App List Not Showing Apps

  • Ensure roothide Bootstrap has proper permissions
  • Try restarting the Bootstrap app
  • Check that your iOS version is supported

Package Manager Issues

  • Ensure package managers are properly installed
  • Refresh repository sources
  • Check repository URLs are correct

For more troubleshooting help, visit our FAQ page or join our Discord server.

Additional Resources