SuperiorOS

A clean, stable, and performance-focused Android ROM.

🧠 Credits

• AOSP
• LineageOS
• crDroid Android

⚙️ Requirements

| Resource | Recommended | |-----------|--------------| | Disk Space | ~400 GB | | RAM | 16 GB or higher | | OS | Linux (preferred) or macOS | | Build Environment | Setup using Akhil Narang’s scripts |

🧩 Sync Source

repo init -u https://github.com/SuperiorOS/manifest.git -b 16.2 --git-lfs
repo sync --force-sync

🏗️ Building SuperiorOS

Run the build script:

./build-superior.sh <devicecodename> [options]

Available Options

| Option | Description | | -------------------- | ---------------------------------------- | | -h, --help | Display this help message | | -c, --clean | Clean the entire tree before building | | -i, --installclean | Dirty build with installclean | | -t, --build-type | Specify build type | | -j, --jobs | Number of threads to use | | -m, --module | Build a specific module | | -s, --sign-keys | Specify path to sign key mappings | | -p, --pwfile | Path to sign key password file | | -d, --delta | Generate delta OTA from target_files zip | | -z, --imgzip | Generate fastboot flashable image zip |

📦 Downloads

| Platform | Link | | ---------------------- | ----------------------------------------------------------------------------------- | | 📦 SourceForge | Download Builds | | 🧭 GitHub Releases | Official Devices |

🌍 Translations

Want to help translate SuperiorOS? Join us on Crowdin.

🪲 Reporting Issues

When reporting bugs or crashes:

• Ensure you’re on the latest official build.
• Include a logcat or relevant logs.
• Mention your device codename and build version.

📊 Download Statistics

🧭 GitHub

🚀 SourceForge

| Period | Badge | | ----------- | ------------------------------------------------------------------------------------------------------------------- | | Daily | | | Weekly | | | Monthly | | | Total | |

🔗 Community Links

• 💬 Telegram Chat
• 📢 Telegram Channel

_{Built with ❤️ by the SuperiorOS Team & Community}