NeoFreeBird-BHTwitter

The ultimate way to tweak your Twitter/X experience.

Twitter Branding

       

X Branding

       

Preview

Features

Downloading

Go to the Releases page to download the latest version of NeoFreeBird-BHTwitter. You can also build it yourself by following the instructions below.

Compiling NeoFreeBird-BHTwitter

Using your computer

1. Install Theos.

Note for Linux users: the current toolchain that ships with Theos is too outdated to build successfully ("Undefined symbols for architecture arm64"). Download the latest toolchain for your distro from here and replace $THEOS/toolchain/linux with its contents.

2. Install cyan if you want sideload or TrollStore builds.
3. Clone the NeoFreeBird-BHTwitter repository:

git clone --recursive https://github.com/orionblur/NeoFreeBird
cd NeoFreeBird

4. Make the build script executable:

chmod +x ./build.sh

5. Run the script with your preferred option:

./build.sh [OPTIONS]

Available options:

--sideloaded: for sideloading.
--trollstore: for TrollStore users.
--rootless: for rootless jailbreaks.
--rootfull: for rootful jailbreaks.
--help: for help

Using GitHub Actions

1. Fork this repository.
2. Open the "Actions" tab and enable workflows.
3. Choose "Release".
4. Click "Run workflow" and provide:
   • A decrypted IPA URL for sideloaded/TrollStore builds.
   • Any value for rootful/rootless builds.
5. Check the "Releases" tab once the build completes.

Examples

Build for Sideloading

1. Get a decrypted IPA for Twitter/X.
2. Rename it to com.atebits.Tweetie2.ipa and move it to the packages folder.

./build.sh --sideloaded

Result: NeoFreeBird-sideloaded.ipa inside packages.

Build for TrollStore

Follow the same steps as sideloading, then run:

./build.sh --trollstore

Result: NeoFreeBird-trollstore.tipa inside packages.

Build for Rootless Jailbreaks

Just run:

./build.sh --rootless

Result: com.bandarhl.bhtwitter_4.2_iphoneos-arm64.deb inside packages.

Build for Rootful Jailbreaks

Just run:

./build.sh --rootfull

Result: com.bandarhl.bhtwitter_4.2_iphoneos-arm.deb inside packages.

Rebranding

rebrand.sh applies name and icon branding to an IPA. This can be done before or after patching with the tweak.

Resource packs work on both macOS and Linux via scar, which is downloaded automatically if it isn't in PATH (or set NFB_SCAR to a binary). The Pillow package they need is installed automatically into a cached venv on first use. There is a GitHub Actions workflow if you'd rather not run it locally.

./rebrand.sh [-t | --twitter-branding] [--resource-pack ZIP] [-o OUTPUT] IPA

At least one branding option is required:

-t, --twitter-branding: sets the app's display name to Twitter.
--resource-pack ZIP: applies a theme pack ZIP.

By default the IPA is rebranded in place. Pass -o/--output to write a rebranded copy instead:

./rebrand.sh -t --resource-pack theme.zip -o packages/Twitter-rebranded.ipa packages/NeoFreeBird-sideloaded.ipa