NeoFreeBird-BHTwitter (tweak)

The ultimate way to tweak your Twitter/X experience.

Compiling NeoFreeBird-BHTwitter

Using your computer

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

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

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 "Build and Release NeoFreeBird-BHTwitter."
4. Click "Run workflow" and provide:
   • Deployment format: rootful, rootless, sideloaded, or trollstore.
   • 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.

Note

These builds are considered beta
This repo is meant for NeoFreeBird, which builds this for specific versions of Twitter. You can of course build this for your own app without using the main NeoFreeBird app, but please note your build will not be supported by the NeoFreeBird team if you do.

Note

This repo is forked from BHTwitter.
It will merge patches upstream to BHTwitter when it's considered mostly done.