Skip to content

README.md

Latest commit

 

History

History
124 lines (91 loc) · 3.72 KB

README.md

File metadata and controls

124 lines (91 loc) · 3.72 KB

NeoFreeBird-BHTwitter

the ultimate way to tweak your Twitter/X experience.

Forked from BHTwitter.

Features

  • Download media: Save videos and GIFs directly from Tweets.
  • Custom tab bar: Personalize your navigation.
  • No search history: Keep your searches private.
  • No topic Tweets: Remove irrelevant topics from your feed.
  • No video captions: Clean up your video player.
  • Lock Twitter: Secure the app with Face ID, Touch ID, or a passcode.
  • Custom fonts: Change the font to match your style.
  • Better DM search: Unlock advanced Direct Message filters.
  • High-quality media: Always upload and view in the best quality available.
  • Undo Tweet: Add a delay to fix mistakes before posting.
  • Change theme: Choose colors to match your mood.
  • Change app icon: Fresh icons to suit your theme.
  • Twitter Circles: Full support included.
  • Copy profile details: Easily copy bios, usernames, and more.
  • Save Tweets as images: Long-press to export Tweets cleanly.
  • Hide Spaces bar: Make your timeline cleaner.
  • Left-to-right layout: Force LTR layout even for RTL languages.
  • Open links externally: Use Safari or your default browser.
  • Translate bios: View bios in your preferred language.
  • Original Tweet layout: Revert to the classic Tweet style.
  • Voice Tweets & DMs: Enable hidden voice features.
  • Block promoted Tweets: Remove ads from your feed.
  • Confirm likes, Tweets, and follows: Add confirmation prompts to avoid mistakes.
  • FLEX debug tool: Tools for developers to debug easily.
Screenshot 1 Screenshot 2 Screenshot 3
Screenshot 4

How to Build

Build Locally

  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/actuallyaridan/NeoFreeBird-BHTwitter
cd NeoFreeBird-BHTwitter
  1. Make the build script executable:
chmod +x ./build.sh
  1. Run the script with your preferred option:
./build.sh [OPTIONS]

Available options:

--sideloaded: For sideloading.
--rootless: For rootless jailbreaks.
--trollstore: For TrollStore users.
(no option): For rootful jailbreaks.

Build via 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.

Build 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-BHTwitter-sideloaded.ipa inside packages.

Build for TrollStore

Follow the same steps as sideloading, then run:

./build.sh --trollstore

Result: NeoFreeBird-BHTwitter-trollstore.tipa inside packages.

Build for Rootless Jailbreaks

Simply run:

./build.sh --rootless

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

Build for Rootful Jailbreaks

Just run the script without any flags:

./build.sh

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