Zerone-Laboratories / ztOS

# ztOS
**ALPHA-2** — Galaxy S9 (SM-G960N / starlte) build.
ztOS is a phone operating system: the **ztMETRO** shell (Windows Phone 8.1's
look and motion) on Arch Linux ARM and mainline Linux, with its own apps, an
updater and an SDK for apps in Python and Qt. The ztMETRO Shell and its components are written in C, and accelerated with OpenGL. Currently its ported for a Samsung Galaxy
S9 (starlte), and I am hoping to expand supports for more devices in the future :).
> This ROM is in very much Alpha, The installer is not tested on real hardware, open a issue in this github repo if you have any issues with it
>Your warranty is now void. I am not responsible for bricked devices, dead SD cards, thermonuclear war, or you getting fired because the alarm app failed. Please do some research if you have any concerns about features included in this ROM before flashing it! YOU are choosing to make these modifications, and if you point the finger at me for messing up your device, I will laugh at you.
**To install it:** `installer/ztos` (see installer/README.md).
The installer lets you choose between:
1. **Auto Download Prebuilt image and install** (fastest, uses GitHub Release images with default login `zerone` / `toor`)
2. **Build image in this PC and install** (custom user/password, builds via QEMU user emulation)
3. **Build image in this PC and store** (builds and exports the image without flashing)
**Jump to:** Screenshots · Status: what works · **Known quirks** (read before flashing) · What is where · The SDK · License
## Screenshots
From a Galaxy S9 running ztOS (taken from the live display with `scripts/phone-grab.sh`).
 Start 
 App list 
 Cellular + SIM 
 Sensors (ZrnDevTest) 
 About 
## What is where
| | |
|---|---|
| `installer/` | `ztos`, the installer: builds ztOS and installs it in QEMU or on the phone |
| `os/` | what makes the system ztOS: its packages, files (identity, session, updater, default tiles, fonts) and apps (Welcome, Updates) |
| `ztmetro/` | the shell, its toolkit (ZrnMetroCore), the apps written with it (Settings, ZrnDevTest, Phone, Messaging, People) and the system daemons |
| `sdk/` | the ztOS SDK: apps in Python and Qt (sdk/README.md) |
| `kernel/`, `initramfs/`, `scripts/` | the phone's boot image: mainline 7.1 with the Exynos 9810 drivers, the start-up program, flashing |
| `audio/`, `modem/`, `sensors/`, `power/`, `leds/`, `haptics/`, `firmware/` | the phone's hardware support, as loadable kernel modules |
| `rootfs/` | the phone's own system files (USB link, charger, fallbacks) |
| `stock/` | the phone's stock firmware and its EFS backups: never modified |
| `archive/` | everything else from bring-up (recordings, screenshots, logs); `archive/MANIFEST.txt` says where each came from |
| `build/`, `out/` | build inputs and outputs (not in the repository) |
## ztOS's parts
| Name | What it is |
|---|---|
| ztMETRO | the shell: Start, the app list, the action centre, the keyboard, the lock screen |
| ztOSCoreSensorFramework (`ztos