NeoFreeBird / app

# NeoFreeBird
 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. You can also build it yourself by following the instructions below.
# Supporting the Project
I welcome all help on NeoFreeBird! Translations, bug fixes, and new features are all welcome. If you do see any issues with the app, feel free to open an issue and follow the templates provided. I also have a Ko-Fi linked in the repo if you wish to support me directly, but by no means is it required! NeoFreeBird will always be open-source and free to use.
# Compiling NeoFreeBird
## 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 repository:
 [code] 
4. Make the build script executable:
 [code] 
5. Run the script with your preferred option:
 [code] 
Available options:
 [code] 
## 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.
 [code] 
Result: `NeoFreeBird-sideloaded.ipa` inside `packages`.
## Build for TrollStore
Follow the same steps as sideloading, then run:
 [code] 
Result: `NeoFreeBird-trollstore.tipa` inside `packages`.
## Build for Rootless Jailbreaks
Just run:
 [code] 
Result: `com.bandarhl.bhtwitter_4.2_iphoneos-arm64.deb` inside `packages`.
## Build for Rootful Jailbreaks
Just run:
 [code] 
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 rebuilds the app's asset catalogs, and resvg, which rasterizes a pack's `svgs/` glyphs into them. Both are downloaded automatically if they aren't in `PATH` (or set `NFB_SCAR` / `NFB_RESVG` to a binary). The Pillow package they need is installed automatically into a cached venv on first use. T