A clean, ad-free Android 13 GSI built on AOSP with PixelOS-style UI, Lawnchair launcher, and 8 original customization modules.
Pure · Fast · No telemetry · No commercial bloatware
ZephyrOS is a community-driven Android 13 Generic System Image (GSI) that brings a Pixel-style experience with original customization features tailored for Chinese users.
- Material You theming with Breeze green accent (
#2EB872) - Rounded corners on QS tiles, dialogs, notifications, volume panel
- Pixel-style lock screen clock and power menu
- Themed AOSP apps (Dialer, Messaging, Contacts, Calendar, Calculator, Clock)
Replaces AOSP Launcher3 with Lawnchair (Apache 2.0) for a richer desktop experience.
| Module | Chinese Name | Key Features |
|---|---|---|
| ZephyrStatus | 清风状态栏 | Icon drag-reorder, net speed chip, weather chip, capsule notification preview |
| FlowNotify | 流光通知 | Smart grouping, heads-up duration, notification history, smart DND |
| ZephyrGesture | 清风手势 | 5-level edge swipe sensitivity, three-finger screenshot, one-handed mode |
| ImmersiveFlow | 全面屏手势 | Pill style (thin/thick/hidden), corner swipe actions, swipe-down for notifications |
| AppVault | 应用管家 | App locker, app hiding, app dual, app freezer, install source tracking |
| PowerCore | 续航引擎 | Deep doze, wakelock monitor, charge scheduling, app standby limits |
| PrivacyGuard | 隐私卫士 | Permission dashboard, camera/mic indicator, clipboard alert, network firewall |
| ThemeStudio | 主题工坊 | Color palette, font switcher, icon pack, corner radius adjustment |
- Boot animation: Original Python-generated "Breeze Flow" animation (75 frames)
- Wallpapers: 6 original vector wallpapers (Breeze / Grove / Steam / Dewdrop / Horizon / Mint)
- Fonts: OFL-licensed font integration (Roboto / Varela Round / Noto Sans CJK)
- ❌ No ads of any kind
- ❌ No third-party commercial promotions
- ❌ No telemetry or remote data collection
- ❌ No pre-installed closed-source bloatware
- ✅ All features originally implemented
| Item | Value |
|---|---|
| Android version | 13 (android-13.0.0_r83) |
| Build target | aosp_arm64-userdebug (GSI) |
| API level | 33 |
| Architecture | arm64-v8a |
| Build system | GitHub Actions (Ubuntu 22.04) |
| Build time | ~4.5 hours |
| Output size | ~1.5 GB (system.img) |
- Fork or clone this repository
- Go to Actions tab → Build ZephyrOS GSI → Run workflow
- Wait ~4.5 hours
- Download
system.imgfrom Artifacts
Requires: 64-bit Linux, 64GB free disk, 16GB RAM
git clone https://github.com/lululuhu/ZephyrOS.git
cd ZephyrOS
bash build_local.sh
⚠️ Warning: Flashing a GSI will wipe your system partition. Backup your data first. Your device must support Project Treble and have an unlockable bootloader.
# Reboot to bootloader
adb reboot bootloader
# Flash GSI to system partition
fastboot flash system system.img
# Reboot
fastboot reboot- Any Treble-enabled device (most devices released after 2018)
- A/B partition scheme devices
- Verify with Treble Info app before flashing
ZephyrOS/
├── .github/workflows/ # GitHub Actions CI
├── build/ # Build scripts
│ ├── build_gsi.sh
│ ├── optimize_disk.sh
│ ├── setup_env.sh
│ └── sign_gsi.sh
├── frameworks/base/
│ ├── patches/ # Framework patches (status bar, gesture)
│ └── packages/SystemUI/ # ZephyrOS SystemUI hooks
├── manifest/ # Local manifest (Lawnchair, PixelOS icons)
├── packages/apps/
│ ├── ZephyrParts/ # 8 customization modules
│ └── ZephyrWallpapers/ # 6 original wallpapers
└── vendor/zephyr/
├── bootanimation/ # Original boot animation generator
├── config/ # Branding, licenses
├── fonts/ # OFL font integration
├── icons/ # PixelOS icon pack overlay
├── launcher/ # Lawnchair configuration
└── overlay/ # SystemUI/Settings/app themes
ZephyrOS is licensed under Apache License 2.0.
See LICENSE for the full license text.
| Component | License | Source |
|---|---|---|
| AOSP | Apache 2.0 | android.googlesource.com |
| Lawnchair | Apache 2.0 | github.com/LawnchairLauncher/lawnchair |
| PixelOS icons | Apache 2.0 | github.com/PixelOS-AOSP |
| Roboto font | Apache 2.0 | github.com/googlefonts/roboto |
| Varela Round font | OFL 1.1 | fonts.google.com |
| Noto Sans CJK | OFL 1.1 | github.com/notofonts/noto-cjk |
ZephyrOS stands on the shoulders of giants. We gratefully acknowledge:
- Android Open Source Project — the foundation
- Lawnchair Launcher — the launcher
- PixelOS — icon design inspiration
- Google Fonts — Roboto, Varela Round, Noto Sans CJK
- 🐛 Bug reports: GitHub Issues
- 💡 Feature requests: GitHub Discussions
- 🔀 Contributions: Pull requests welcome!
ZephyrOS · 清风系统 · Pure Android, reimagined
Copyright © 2024-2026 ZephyrOS Project Contributors