Zenith Launcher — the handbook
The complete user manual: every gesture, every menu, every button, every setting.
how to read this
Zenith names things the way it draws them. A folder is a star that opens another ring. Going back is retracing your own line. The vocabulary is consistent, so once you have the words, the app explains itself.
Conventions in this manual
| Written as | Means |
|---|---|
| settings › system | A path through menus. Open settings, then the row named system. |
| hold | Press and keep your finger down without lifting. Never a quick tap. |
| slide | Move the finger that is already down. The gesture has not ended. |
| lift / release | Take the finger off the glass. This is what commits an action. |
| dwell | Stop moving and wait, finger still down, for a set number of milliseconds. |
| dp | Density-independent pixels — Android's screen unit. 1 dp ≈ 1/160 inch, identical physical size on every phone. |
| gold | Requires the one-time Zenith Gold unlock. Everything else is free forever. |
| default | What the setting is before you touch anything. |
The glyphs, and what each one is
Zenith writes in symbols rather than words wherever a symbol will do. These are the ones you will meet on screen.
- ✦the starZenith's signature. Marks the app, confirms a choice, and sits at a ring's heart.
- ✛addTop dock button. Puts a new star on the ring.
- ◈iconSecond dock button. Changes the picture on the touched star.
- ✎editThird dock button. Opens the star editor for the touched star.
- −removeBottom dock button. Takes the touched star off the ring.
- ⚙︎settings cornerLower-left. Tap it, or hold that corner, to open settings.
- ‹backLatched-mode button, lower right. Folds one ring shut.
- ◉activateLatched-mode button, lower right. Opens the selected star.
- ◎re-placeMove an existing star to a new angle and orbit.
- ☄cometA notification drifting across the sky, waiting to be caught.
- ⤢resizeOn a floating widget's title bar — cycles three sizes.
- ⋮moreRow menu, used in the talisman list.
- ›deeperA row that opens something: a settings page, or a folder in list mode.
- ⟂overriddenThis control is being forced by an accessibility setting elsewhere.
The mental model in four sentences
- The sky is empty on purpose. Nothing is drawn until you touch it, so there is no grid to arrange and no drawer to scroll.
- Where you start the hold matters. The screen can be split into up to 9 regions, and each region keeps its own constellation.
- Only the top ring exists. When you descend into a folder, the ring you came from vanishes, leaving one chevron marker at the exact point your line came from — trace back into it to fold the ring shut.
- Releasing is committing. Lift on a star to open it, lift on empty sky to dissolve everything and change nothing.
install & first run
Zenith works the moment it is installed, but it is meant to be your home app. Setting it as the default launcher is what makes the home button return you to the sky — and it is what unlocks app shortcuts and Direct.
Installing
- Install the app Zenith Launcher requires Android 8.0 or newer. It runs on phones and tablets; portrait is the designed orientation.
- Open it once The first launch shows a five-step welcome. Every step can be skipped and repeated later.
- Make it home Either accept step 2 of the welcome, or go to settings › system › set zenith as default launcher →. On Android 10+ this opens the system's "default home app" chooser.
The welcome walkthrough, step by step
Each card has one primary button and usually a skip. Granted permissions are detected live — if you enable something in system settings and come back, the card updates itself and shows enabled ✦.
| Step | Card | What it asks for | Skippable |
|---|---|---|---|
| 0 | welcome to zenith | Nothing. States the privacy position and the core gesture. Button: begin. | — |
| 1 | make zenith your home | Default-launcher role, so the home button returns to the sky. | yes |
| 2 | zenith actions | The optional accessibility service that performs lock / shade / recents / quick tiles / screenshot / power. | yes |
| 3 | notification comets | Notification access, so notifications drift by as catchable comets. | yes |
| 4 | weather & your real sky | Coarse location, for the weather readout and the My Sky background. | yes |
| 5 | how should the sky begin? | A choice, not a permission: starter ring ✦ or bare sky. | — |
What "starter ring" actually places
It fills region 1 with up to seven everyday apps at the compass points, plus a media folder at 6 o'clock. Only apps you actually have installed are placed; anything missing simply leaves that point empty.
| Position | Angle | App chosen |
|---|---|---|
| top | 0° | Phone / dialler |
| upper right | 45° | Messaging |
| right | 90° | |
| lower right | 135° | Gallery / Photos |
| bottom | 180° | media folder — YouTube, YT Music, Spotify, TikTok, VLC (whichever are installed) |
| lower left | 225° | Calendar |
| left | 270° | Clock / alarms |
| upper left | 315° | Tasks |
settings › system › guidance › replay welcome → runs the whole walkthrough again. reset hints next to it re-arms the one-time tips.
First-time hints
The first time you use a feature, a single card explains it and disappears for good once tapped. There are eight, and they fire on the event, not on a timer.
| Fires when | Titled | Tells you |
|---|---|---|
| the sky first appears | two things to know | Where settings live, and how to see every app. |
| your first ring blooms | a ring is born | Keep holding, slide onto a star, lift to open. |
| a folder ring blooms | descend into a folder | Rest to descend; trace back to the ✦ at the heart to return. |
| the add sheet opens | the corner dock | What ✛ ◈ ✎ − do while you hold. |
| deep sky opens | the deep sky | Every app, searchable, search box at the bottom. |
| the star index opens | the star index | Letter groups, slide to a group then an app. |
| a talisman casts | a talisman cast | Where to inscribe your own. |
| settings opens | the settings corner | The lower-left corner is the way in. |
Turn them off entirely with settings › system › guidance › first-time hints.
If the sky is empty
Before anything is placed, Zenith writes two lines near the bottom of the screen: "press and hold — a ring of stars will bloom / slide to ✛ to place your first app" and "hold the lower-left corner for settings". They vanish the moment the sky has any content.
the core gesture
One finger, one continuous motion: hold · bloom · slide · lift. Everything the launcher does is a variation on it, and no part of it requires precision — the ring blooms exactly where your finger already is.
The whole gesture
- Press and hold on empty sky A faint spark grows under your fingertip. After the hold delay (220 ms by default) the spark blooms into a ring of stars centred on your finger.
- Slide outward onto a star The star under your finger brightens, swells slightly, and its name appears above it. A small haptic tick marks each new star you cross.
- Lift to open it The star goes supernova — a shockwave ring and sparks — and the app opens.
- Or lift on empty sky Everything dissolves. Nothing was changed, nothing was launched.
Do not lift until you mean it. The whole gesture is one press; lifting is the commit. If you get lost mid-gesture, slide back to empty sky and lift — that is always the safe exit.
Descending into a folder
A folder star wears a tiny orbit of its own — a centre point with three moons circling it. Sliding across a folder does nothing; you must rest on it.
- Rest on the folder star Hold still on it for the bloom delay (330 ms by default). This dwell exists so you can circle a ring freely without opening every folder you pass.
- Its ring blooms around it The ring you came from vanishes. The folder star stays at the new ring's heart, so you can still see what you opened.
- Keep going as deep as you like Rings nest without limit.
- To go back, retrace your line A chevron marker sits at the previous ring's centre — the exact point your finger came from. Slide back into it and this ring folds shut.
Every timing, with its range
| What | Default | Range | Where to change it |
|---|---|---|---|
| Ring opens after a hold | 220 ms | 120–450 ms | settings › rings & effects › hold delay (120–600 ms in accessibility › extended) |
| Folder ring blooms after a dwell | 330 ms | 150–1200 ms | settings › accessibility › extended |
| Double-tap window | 340 ms | 200–700 ms | settings › accessibility › extended |
| Dwell-to-select (rest to launch) | 900 ms | 400–2500 ms | settings › accessibility › motor |
| Ring bloom animation | 240 ms | fixed | — |
| Ritual step spacing | 650 ms | fixed | — |
| "Breathe" pause before opening | 2600 ms | fixed | per star, in the ✎ editor |
| Veil rest-to-unseal | 4000 ms | fixed | — |
What the launcher is doing at each moment
Useful when explaining why something did or did not happen. Zenith is always in exactly one of these states.
| State | You are | Ends when |
|---|---|---|
| idle | Not touching, sky bare | You touch down. |
| pending | Finger down, hold not yet complete | The hold delay passes (ring opens, or the corner/edge action fires), or you move far enough to become a flick. |
| flick | Moving fast before the hold landed | You lift — the stroke is judged as a flick, a drawn circle, or a talisman. Abandoned after 900 ms. |
| active | A ring (or list panel) is open under your finger | You lift. |
| all apps | The Star Index semicircle is open | You lift on an app, or on empty space. |
| comet | You caught a notification comet and its menu is open | You lift on a menu row, or off it to let the comet fly on. |
What each release does
| Lift on… | Result |
|---|---|
| An app star | Launches the app. |
| A shortcut star | Runs the app shortcut (needs Zenith to be the default launcher). |
| A widget star | Opens the widget as a floating, draggable window. |
| A folder star | Nothing — folders open by dwelling, not by release. (Unless it is a ritual folder, which launches everything inside.) |
| The star at the ring's heart | Opens that star — this is how you launch a "hybrid" star that also holds children. |
| ✛ | Opens the add sheet for the ring (or for the star under your finger). |
| ◈ | Opens the icon picker for the last star you touched. |
| ✎ | Opens the star editor for the last star you touched. |
| − | Removes the last star you touched. |
| Empty sky | Everything dissolves, leaving a fading ghost of your stroke. |
List mode — the same gesture, in words
The big switch at the top of settings turns every ring into a cascading text panel. The tree, the dock, the corners and the timings are identical; only the drawing changes.
| ✦ icon mode default | ☰ list mode | |
|---|---|---|
| What blooms | A ring of stars around your finger | A text panel beside your finger, on whichever side has room |
| Selecting | Slide onto a star | Slide down the rows; the row under your thumb highlights |
| Going deeper | Dwell on a folder star | Dwell on a folder row — a child panel cascades clear of the parent |
| Dwell time | folder-bloom delay (330 ms) | hold delay (220 ms) |
| Going back | Trace into the chevron at the previous ring's heart | Move to a different row — deeper panels collapse instantly |
| Adding a star | Live placement on the ring, then the add sheet | The add sheet opens directly; angle and orbit are chosen for you |
| Row markers | — | › folder · ▣ widget · ↗ shortcut |
the sky's furniture
A handful of fixed things live on the screen around the constellation. Knowing where each sits — and that every one of them can be turned off — is most of what "finding your way around Zenith" means.
Everything that can appear, and where
| Element | Where | When visible | Turn off at |
|---|---|---|---|
| ⚙︎ settings corner | Lower-left corner | Only when idle — it hides while a ring is alive so it never sits over the − button | settings › system › show ⚙︎ settings corner |
| Clock / date / battery / event / weather | Any of 9 anchor positions | Always, above the ring canvas — tapping it opens the matching app, not a ring | settings › sky overlays |
| Corner hints | 4 tiny dots, 14 dp in from each corner | Only for corners with an action assigned | settings › rings & effects › show corner & edge hints |
| Edge hints | Short dashes at the middle of each edge | Only for edges with an action assigned | same switch as corner hints |
| Region borders | Hairlines on the region grid | Only while you are holding, and only with more than one region | settings › regions & star index › show region borders while holding |
| The dock ✛ ◈ ✎ − | Column up the left edge, 60 dp in | While a ring is open. ✛ always; ◈ ✎ − appear once you have touched a star | settings › rings & effects › show dock buttons |
| Latched ◉ / ‹ | Lower right, stacked | Only with latched buttons on | settings › accessibility › latched buttons |
| Floating widgets | Wherever you dragged them | Until closed with ✕ | — |
| Comets | Drifting across the sky | With notification access and comets on | settings › system › comets · notifications |
| Status bar | Top of screen | Android's own | settings › system › hide status bar |
Exact dock geometry
All four dock buttons sit on the same vertical line, 60 dp from the left edge, measured up from the bottom of the screen. They never move, so the path to them becomes muscle memory.
| Button | Height above bottom | Radius | Colour role |
|---|---|---|---|
| ✛ add | 246 dp | 28 dp | theme "add" colour |
| ◈ icon | 182 dp | 24 dp | theme "icon" colour |
| ✎ edit | 118 dp | 24 dp | theme "edit" colour |
| − remove | 54 dp | 24 dp | rose — the removal colour |
Corner and edge hit zones
| Zone | Size | Notes |
|---|---|---|
| Corner | 52 × 52 dp | Each of the four corners. A hold started here runs that corner's action instead of opening a ring. |
| Edge band | 18 dp wide | The strip along each edge between the corners. Corners win where they overlap. |
| Right-edge index drag | 26 dp | Only when "drag in from the right edge" is on. Drag inward 36 dp to open the Star Index. |
| Star hit target | 1.4 × star size | Multiplied again by the accessibility touch-target slider (1.0–2.5×). |
Zenith never claims the screen edges away from Android. The system back swipe always wins at the left and right edges, which is why left/right flicks ship unassigned and why the drawn circle is the reliable way to reach the Star Index.
rings, stars & orbits
A ring is a folder's contents drawn as a circle. Every star on it has an angle (where around the circle) and an orbit (how far out). Those two numbers are the whole layout system.
The four kinds of star
| Type | Drawn as | Release does | Notes |
|---|---|---|---|
| app | The app's icon inside a disc | Launches the app | The most common star. |
| folder | A tiny orbit: centre point + three slowly circling moons | Nothing (dwell to descend) | Holds other stars. Nest without limit. |
| shortcut | The shortcut's icon | Runs an app shortcut — "new message", a saved playlist, a bookmark | Requires Zenith to be the default launcher. |
| widget | A small square outline with a dot | Opens the widget as a floating window | Drag its title bar to move, ⤢ for size, ✕ to close. |
Two special behaviours any star can wear
- Hybrid parent — an app, shortcut or widget star that also has children. It wears a faint extra band. Dwell on it to bloom its ring; release on it to launch it. Both, from the same star.
- Ritual — a folder flagged in the ✎ editor. It wears a double band, and releasing on it activates everything inside, in order, 0.65 s apart. A morning routine as one release.
Angle — where around the ring
Angles are shown the way you would describe them out loud: 0° is straight up, and they increase clockwise. 90° is the right, 180° the bottom, 270° the left. This is the convention used in the placement screen and read aloud by TalkBack.
Orbit — how far out
Orbit is a multiplier on the base ring radius, not a fixed level. Drag a star nearer or further and it lands on quarter steps; if a sibling already sits at a nearby distance, it magnetises onto that sibling's orbit so rings never end up with two circles a hair apart.
| Property | Value |
|---|---|
| Base radius | 150 dp default · 80–280 dp |
| Orbit multiplier range | 0.4× – 6× |
| Snap step | 0.25× |
| Sibling magnet | Wins only when genuinely nearer than the nearest quarter step |
| Rendered circles | One faint orbit line per distinct orbit in use, plus the 1× ring always |
A ring blooms exactly where you touched, even near an edge — it is never nudged back on-screen. Stars placed at extreme angles or far orbits can therefore fall off the edge if you start the hold in the wrong place. That is the intended trade-off: the ring is always centred on your finger, so it is always reachable from where you already are. If a star has drifted out of reach, move it with ◎ re-place.
Navigating a deep constellation
| To… | Do this |
|---|---|
| Open a ring | Hold empty sky. |
| Go deeper | Rest on a folder star for the bloom delay. |
| Go back one level | Trace inward into the chevron marker at the previous ring's centre. |
| Launch the folder you're standing in | Touch the star at the current ring's heart and lift (works for hybrids and rituals). |
| Leave without doing anything | Slide to empty sky and lift. |
| Circle a ring without opening folders | Keep moving. Dwell is what opens things, so motion is always safe. |
What changes how a star looks
| Control | Lives in | Effect |
|---|---|---|
| star size | settings › rings & effects | 26 dp default · 18–36 dp |
| star style | settings › background & light | app icons · monochrome (true desaturation) · text only · inverted mono |
| labels | settings › rings & effects | off · on hover · always. Text-only style forces labels on. |
| light color | ✎ star editor | Picks from the current theme's palette. Mono themes flatten every star to the one light. |
| show label / show icon | ✎ star editor | Per star, independent of the global setting. |
| custom icon | ◈ picker | Overrides everything for that one star. |
| usage as light | settings › background & light | Stars you launch often glow brighter, up to +30%. |
| line thickness · star glow | settings › rings & effects | Stroke weight and halo of stars and orbit lines. |
A star's label normally sits below it, but jumps above the star whenever it is under your finger — your hand covers everything below the touch point.
the in-gesture dock
Four buttons up the left edge, visible only while you hold. They are how the sky is built without ever leaving the gesture — no long-press menus, no edit mode to enter and exit.
The four buttons
| Button | Acts on | Release does | Second-finger tap does |
|---|---|---|---|
| ✛ add | The star under your finger, else the open ring | Opens the add sheet | Starts live placement — your held thumb now positions the new star |
| ◈ icon | The last star you touched | Opens the icon picker | Same, and ends the gesture |
| ✎ edit | The last star you touched | Opens the star editor | Same, and ends the gesture |
| − remove | The last star you touched | Removes it | Removes it and keeps the ring open — prune several stars in one hold |
✛ is always there while a ring is open. ◈ ✎ − only appear once you have touched a star, because until then they have nothing to act on.
While your finger is on −, the star about to go is circled in rose and named beside the button: "remove Instagram". Slide off the button and nothing is removed.
Live placement — the ✛ flow in detail
This is the part worth learning properly. Sliding onto ✛ without lifting does not open a menu — it hands your thumb the new star.
- Slide onto ✛, keep holding The ring's stars fade out and guide circles appear: faint quarter-step rings, brighter rings where siblings already sit, brightest on the orbit you are on.
- Move your thumb A ghost star with a crosshair follows you around the ring, snapping to quarter steps and magnetising onto sibling orbits. A live readout above it reads 135° · 1.25× — release to choose.
- Release where you want it The spot is locked in. Only now does the add sheet open.
- Pick what goes there Choose an app, folder, widget, shortcut or Direct item; it lands exactly on the spot you marked, with no second placement step.
Which ring does ✛ add to?
Deliberately, the target is the star under your finger at the moment you reach ✛, if there is one — that is how you add inside a star and make a hybrid parent. Otherwise it is the open ring. To be sure you are adding to the ring, route your finger around any star that lies between you and the dock.
There is nothing to position, so ✛ skips placement entirely and opens the add sheet immediately. Angles are chosen for you.
adding things
The add sheet has six tabs. The first five put something new on the ring; the sixth edits what is already there.
The six tabs
| Tab | What it lists | Tapping a row |
|---|---|---|
| Apps | Every installed app, with a search field at the top | Places that app as a star |
| Folder | A name field | create ✦ makes an empty folder star that opens its own ring |
| Widgets | Every installed widget provider, alphabetical, with its package underneath | Binds the widget (may show a system permission screen and the widget's own setup screen), then places it |
| Shortcuts | Apps first; tap one to see the shortcuts it publishes | Places that shortcut as a star |
| Direct | Everything other apps have sent into Zenith with "add to home screen" | Places it as a star |
| Edit | The current ring's contents as a list | See below |
Work-profile apps are listed and launchable from Deep Sky and the Star Index (marked · work), but they cannot be placed on a ring, and talismans cannot target them.
Direct — the inbox for things other apps send you
When you use "add to home screen" in any app — a Chrome bookmark, a file, a note, a playlist, a contact — Android hands it to whichever app is your home screen. Zenith accepts it silently, shows a small toast (✦ name → direct), and files it. Nothing appears on your sky until you place it. Interrupting you mid-task with a placement screen would be the wrong moment to ask.
- The list is newest-first and keeps everything pinned since install.
- Label and icon are captured at the moment it arrives, so an entry never goes blank later.
- A row shows used by 2 stars if you have already placed it more than once.
- forget drops it from this list only. Stars already using it keep working, because the shortcut stays pinned underneath.
- Requires Zenith to be your default launcher — Android only sends pins to the active home app.
The Edit tab
| Control | Does |
|---|---|
| The colour dot | Tap to cycle that star through the theme palette |
| The name | Tap to rename inline; ✓ commits |
| ◎ | Re-place — opens the placement screen for that star |
| ✕ | Removes the star (and releases any widget it held) |
The placement screen
When a spot was not already chosen with live placement, Zenith shows a full-screen placement step. The circle drawn here is the real orbit at true scale, so what you set is exactly what gets rendered.
- Drag anywhere — the star follows your finger around the circle. Distance from the centre changes the orbit; angle around it changes the angle.
- Existing stars are shown faintly, with their names, so you can see the gap you are filling.
- The readout at the bottom gives the angle in degrees (0° up, clockwise) and the orbit as a multiplier and in dp.
- place ✦ commits. cancel abandons — and if a widget was being bound, its binding is released too, so nothing is left dangling.
Widgets, in full
- ✛ › Widgets › pick a provider Android may ask permission to bind the widget the first time.
- Configure it If the widget has its own setup screen, it opens now.
- Place it Either it lands on the spot you already marked, or the placement screen opens.
- Open it Release on its star and it appears as a floating window.
| Part | Does |
|---|---|
| Title bar | Drag to move. The position is remembered. |
| ⤢ | Cycles three sizes: 260×170, 340×240, 400×380 dp. |
| ✕ | Closes the window. The star stays on the ring. |
Android widget IDs are device-local. A star chart backup carries the widget's star, but on a new device the widget must be re-bound — remove the star and add it again.
the star editor ✎
Everything about one star, in one panel. Reach it by touching the star during a hold and then sliding onto ✎.
the star editor ✎
Everything about one star, in one panel. Reach it by touching the star during a hold and then sliding onto ✎.
| Control | Type | Applies to | What it does |
|---|---|---|---|
| name | text field | all | Renames the star. Saves as you type. |
| light color | swatch row | all | Picks from the current theme's palette. Mono themes will flatten it on screen. |
| show label | switch | all | Hides this star's name even when labels are on globally. |
| show app icon | switch | app · shortcut | Off draws a bare coloured point instead of the icon. |
| breathe before opening | switch | app · shortcut | Adds a 2.6 s pause with a pulsing circle before the app opens. Tap during it to stay. A deliberate speed bump for apps you open too automatically. |
| ritual | switch | folder | Releasing on this folder activates everything inside, in order, 0.65 s apart. The star wears a double band. |
| haptic signature | 8-slot timeline | all | Tap a slot to cycle still · small · big. You feel this pattern as your finger crosses the star, so a constellation can be navigated by feel. |
| ▶ feel | button | all | Plays the pattern. |
| clear | button | all | Empties the pattern back to silence. |
| preset → | button | all | Cycles four ready-made patterns: pulse · triple tick · swell · double knock. |
| uninstall app from device… | link | app | Hands off to Android's uninstall dialogue. |
| ◎ re-place | button | all | Opens the placement screen to move the star to a new angle and orbit. |
| − remove | button | all | Takes the star off the ring. Children go with it. |
| done ✦ | button | all | Closes. Everything was already saved. |
Give the stars you use blind — the phone in a pocket, the app you open while walking — distinct signatures. Combined with spoken labels, a whole ring becomes navigable without looking.
icons ◈
Three layers decide what picture a star wears. Each one overrides the one below it.
The ◈ picker
| Section | Contains | Notes |
|---|---|---|
| zenith set | Eight bundled glyphs: star · moon · sun · comet · orbit · spark · eye · rune | Free. Tap one and it applies immediately. |
| icon packs (name) | Tapping the pack's name asks that pack for its own icon for this app | One tap, done — if the pack has no entry for the app it says so. |
| browse all → | The pack's entire library, in the pack's own categories, searchable | Use this when the pack has no automatic match, or you want a different picture entirely. |
| choose image… gold | Any picture from your phone, with a pinch-and-drag round crop | Saved as a 512 px circular PNG in Zenith's own storage. |
| reset icon | Removes the custom icon | Only shown when there is one to remove. |
Setting one pack for everything
settings › background & light › icon set lists system icons, then any official Zenith packs, then every other installed pack. Applying a pack is free — Zenith sells icon packs, so it would be strange to charge you for using one. Per-star ◈ choices still override the pack.
Zenith detects packs that publish the standard hooks used by Nova, ADW and Lawnchair, plus its own. A pack with no entry for a given app falls back to that app's real icon rather than a blank.
deep sky & the star index
Two ways to reach an app that is not on any ring. Deep Sky is a searchable list; the Star Index is the same set of apps arranged as a semicircle you can slide through without lifting.
Deep Sky — every app, searchable
How to open it: hold the lower-right corner (the default), flick up, or assign it anywhere in settings › gestures.
- The list appears first and is scrollable immediately; the search box sits at the bottom, so you can browse without the keyboard ever appearing. Tap the box only when you want to type.
- Tap an app to launch it.
- Work-profile apps are listed and marked · work.
- A ✦ zenith settings entry is always at the top of the list. It is deliberate: no matter how you reassign the corners, there is always one guaranteed way back into settings.
Long-press an app in Deep Sky
| Item | Does |
|---|---|
| open | Launches it. |
| view app info | Opens Android's app info page. |
| ◈ set icon | Dresses the app, not one star — the picture then shows in Deep Sky, the Star Index, and every star that has no icon of its own. |
| inscribe talisman for this | Jumps straight into drawing a sigil bound to this app. |
| hide from deep sky | Removes it from this list. Unhide it later in settings › star chart. |
| uninstall… | Hands off to Android's uninstall dialogue. |
The Star Index — all apps, without lifting
The index blooms as a semicircle anchored to the right edge of the screen, at the height where your gesture started. It is built for one continuous motion: slide to a letter group, slide outward to an app, lift.
Four ways to open it
| Trigger | Default | Set at | Notes |
|---|---|---|---|
| Draw a quick circle anywhere on the sky | on | settings › regions & star index | The most reliable one — no system gesture competes with it. |
| A corner, edge, flick or double-tap set to star index | unassigned | settings › gestures | Any position can do it. |
| Drag in from the right edge | off | settings › regions & star index | Off by default because Android's back gesture owns the edges. |
| A dedicated region | none | settings › regions & star index | Holding anywhere in that region shows the index instead of a ring. |
Using it
- Letter groups bloom on the inner arc Between 3 and 8 groups, sized so each holds roughly 15 apps, with boundaries snapped to letter changes — so you get A–C, D–G, and so on, never a letter split across two groups.
- Slide onto a group Its apps bloom in outer arcs — up to 9 in the first arc, 12 in the second, the rest in a third.
- Slide onto an app It swells and its name appears to its left.
- Lift to launch Or release on a group to leave the index open and drive it by tapping instead.
What a "quick circle" is
So it is never triggered by accident, the stroke has to actually be a circle: drawn fast (before the ring blooms), at least ~140 dp of travel, closing back near where it started, turning roughly a full revolution, and at least 50 dp across in both directions. Any size, anywhere on screen, either direction.
gestures & actions
Thirteen positions on the screen can each be bound to a built-in action — or to any app or shortcut on the phone. This is where Zenith stops being a launcher and starts being a control surface.
The thirteen positions
| Group | Positions | How it fires | Defaults |
|---|---|---|---|
| corners | ↙ bottom-left · ↘ bottom-right · ↖ top-left · ↗ top-right | Hold inside the 52 dp corner square | settings · deep sky · shade · lock |
| edges | ← left · → right · ↑ top · ↓ bottom | Hold on the 18 dp band between the corners | all unassigned |
| flicks | ↑ up · ↓ down · ← left · → right | A quick swipe on empty sky: at least 55 dp within 330 ms | deep sky · shade · none · none |
| double-tap | ◎◎ on the sky | Two taps within the double-tap window, close together | lock |
The action roster
Every position offers the same list. Tap a chip to assign it.
| Action | Does | Needs |
|---|---|---|
| — none | Nothing. A hold here opens a ring instead. | — |
| settings | Opens Zenith's settings. | — |
| deep sky | The searchable all-apps list. | — |
| star index | The all-apps semicircle. | — |
| shade | Pulls down the notification shade. | Zenith actions (falls back to a system API on some builds) |
| quick tiles | Opens quick settings. | Zenith actions |
| lock | Locks the screen. | Zenith actions · Android 9+ |
| recents | Opens the recent-apps switcher. | Zenith actions |
| screenshot | Takes a screenshot. | Zenith actions · Android 9+ |
| power menu | Opens the power dialogue. | Zenith actions |
| back | Performs system back. | Zenith actions |
| home | Performs system home. | Zenith actions |
| seal the sky | Draws the Sky Veil immediately. | — |
| app or shortcut | Opens anything on the phone. | — |
Binding an app to a position
Tap the app or shortcut chip and a picker opens. Choose an app, or drill into an app to pick one of its shortcuts. The chip then wears what it opens — ✦ Spotify — so the row reads as what it does. Tapping the chip again always reopens the picker; that is the only way to change what is bound.
On phones using gesture navigation, Android's back swipe wins over left/right flicks. That is why they ship unassigned. Corners, the drawn circle, and up/down flicks are always reliable.
Zenith actions — the assistive service
Lock, shade, recents, quick tiles, screenshot, power, back and home are system-level actions that no ordinary app can perform. Zenith offers them through a minimal accessibility service called Zenith actions.
- It is configured to read nothing from your screen. It only performs the actions you assign.
- It is entirely optional — every other part of the launcher works without it.
- Turn it on at settings › system › enable zenith actions →, which deep-links to Zenith's own accessibility toggle.
- If you trigger one of these actions without the service, Zenith shows a short message and opens accessibility settings for you.
talismans
A talisman is a shape you draw. Draw it fast on the sky and it casts — opening an app, running an action, or blooming a ring. It is swipe-to-type for launching.
Inscribing one
- Open settings › talismans Then ✎ inscribe new talisman. (Or, from Deep Sky, long-press an app › inscribe talisman for this — the target is then pre-chosen.)
- Draw your shape One continuous stroke, anywhere on the black sheet. It must be at least a few points long to register.
- Draw it again The first attempt shows faintly behind you as a guide. Two samples let Zenith learn your hand rather than one perfect stroke.
- Name it and bind it Three tabs: apps (searchable), actions (the action roster), rings (any folder in your sky, listed by its full path).
- Done It appears in the talisman list immediately, ready to cast.
If your new shape draws too much like an existing one, a warning appears while you are still binding: "⚠ draws like 'X' — priority order will decide which casts". You can redraw, or accept it and settle the conflict with order.
Casting one
Draw the shape fast on empty sky — before the hold delay elapses and a ring blooms. Speed is the whole trigger: a slow press becomes a ring, a fast stroke becomes a glyph. While you are drawing fast, the comet trail switches to the talisman ink colour, so you can see which mode you are in.
- The stroke must travel at least ~90 dp to be considered.
- It is matched against every inscribed talisman; a match must score above 0.80 similarity.
- List order is priority. When two talismans score within a whisker of each other, the one higher in the list wins. Only a clearly better score can take a cast from a higher-priority talisman.
- A successful cast flashes the glow colour outward from the centre of your stroke, leaves a ghost of the glyph, and rings a shockwave.
- Casting a talisman bound to a ring opens that ring in place, staying open without your finger — you then tap the stars to drive it. This is the one way to reach a ring that lives nowhere on your sky.
Managing them
| Control | Does |
|---|---|
| talismans active | Master switch. Off means no fast stroke ever casts. |
| The numbered list | Each row shows the number (its priority), the name, and what it targets. |
| ▶ | Replays the glyph as an animated drawing, looped — useful when you have forgotten a shape. |
| ⋮ re-inscribe | Redraw the shape, keeping the name and target. |
| ⋮ move up / move down | Changes priority. Up = wins ties. |
| ⋮ delete | Removes it. |
| ✎ inscribe new talisman | Starts a new one. Free allows 3; beyond that it becomes ✦ more talismans with gold. |
Make each glyph structurally different — a spiral, a Z, a triangle, a hook — rather than variations on one shape. Orientation matters (matching tolerates roughly ±28° of rotation), so an L and a rotated L are genuinely different glyphs.
Colours
settings › background & light › light colors holds two talisman colours: talisman ink (the stroke while you are drawing fast) and cast glow (the flash when a sigil lands).
comets
Notifications, but as weather. A new notification crosses your sky as a gold comet with its title trailing behind it. Catch it, or let it pass.
Turning them on
- settings › system › comets · notifications The switch "notifications drift by as comets" is on by default.
- Grant notification access Tap enable comet feed →, which deep-links to the toggle for Zenith comets. Until this is granted, the switch has nothing to show.
- That is all The status line then reads "comet feed connected ✦".
Catching one
- Hold on the comet's head Press and keep holding on the bright point, not the tail. A ring tightens around it to show it is armed.
- Its flight freezes After the hold delay, the comet stops and a small menu appears beside it.
- Slide to a row and lift open · dismiss · snooze 30 min.
- Or lift off the menu The comet resumes its flight exactly where it paused. Nothing is dismissed.
How they behave
- Each comet flies for roughly 11–17 seconds, entering from either side, at its own height, size, slope and speed — no two look alike.
- They fade in as they enter and fade out as they leave.
- Ongoing notifications (music players, downloads) are ignored, as are Zenith's own.
- A notification with no title and no text produces no comet.
- Nothing is stored. The title is drawn on screen and forgotten; it is never written to disk and never transmitted.
the sky veil
A curtain drawn over the launcher when the screen sleeps. A drawn sigil lifts it. It is a privacy screen for your constellation — not device security.
Setting it up
- settings › system › sky veil Turn on "veil when the screen sleeps".
- Choose the key any talisman (the default) accepts any sigil you have inscribed; or pick one specific talisman as the only key.
- Optionally seal it by hand Assign the seal the sky action to a corner, edge, flick or double-tap to draw the veil whenever you like.
Getting back in
| Method | How | Always available? |
|---|---|---|
| Draw your sigil | Draw the unseal talisman anywhere on the veil. It must score above 0.78 — slightly more forgiving than a normal cast. | Only if you have inscribed at least one talisman. |
| Rest one still finger | Press and hold, barely moving, for 4 seconds. A ring fills around your finger as it counts. It opens the instant the ring completes. | Yes — always. This is the guaranteed way in. |
A refused sigil always speaks, even with every label turned off: "the sky does not know that sign". A failed attempt is never indistinguishable from a dead screen.
The settings page states the unseal method in capitals before you ever need it, and if you have no talismans inscribed it says so plainly and offers to take you to the inscribe screen.
What the veil shows
By default: the clock, a one-line hint, and — with My Sky on — the real night sky behind it. Back cannot lift it.
regions
The screen can be divided into up to nine areas, and each remembers its own root ring. Where you start the hold decides which constellation appears — a work set on the left, a play set on the right, without switching anything.
How the grid is laid out
| Regions | Grid | Shape |
|---|---|---|
| 1 | 1 × 1 | The whole screen default |
| 2 | 1 col × 2 rows | Top half / bottom half |
| 3 | 1 × 3 | Three horizontal bands |
| 4 | 2 × 2 | Quarters |
| 5–6 | 2 cols × 3 rows | Six cells (with 5, the last two merge) |
| 7–8 | 2 cols × 4 rows | Eight cells (with 7, the last two merge) |
| 9 | 3 × 3 | A full nine-square |
Regions are numbered left to right, then top to bottom, starting at 1.
The region editor
settings › regions & star index › ✦ edit region layout opens a full-screen editor.
- The slider at the bottom sets how many regions exist (1–9). Free is capped at 2; reaching past opens the Gold sheet.
- The dividers are draggable — grab a line anywhere along its length and move it. Lines run edge to edge, so regions can never gap or overlap. Each line stops 8% short of its neighbours.
- The big numbers show which region each cell is.
- done ✦ saves the count and the divider positions; cancel discards.
The other two region controls
| Control | Default | Does |
|---|---|---|
| show region borders while holding | on | Draws faint hairlines on the grid whenever you are holding, so you can see which region you are in. Never shown at rest. |
| open from a region | — | Chips numbered 1…n. Pick one and holding anywhere in that region opens the Star Index instead of that region's ring. — means none. |
Reducing the region count hides the higher regions but keeps their constellations. Raise the count again and they are exactly as you left them.
skies
A sky is a complete, separate setup — its own constellations, its own regions, its own background and theme. Switching skies is one tap. gold beyond the first.
Managing skies
They live at the top of the settings main page, just under the mode switch.
| Control | Does |
|---|---|
| Tap a name | Switches to that sky. The current one is snapshotted first, so nothing is lost. |
| ✦ marker | Marks the sky you are in. |
| ✎ | Rename inline; ✓ commits. |
| ✕ | Deletes that sky and its constellation file. Only shown for skies you are not currently in — you can never delete the ground you are standing on. |
| + new sky | Creates one and switches to it immediately. |
What belongs to a sky, and what is shared
This table matters. Change something in the left column and only the current sky changes; change something in the right column and every sky changes.
| Per sky | Shared across every sky |
|---|---|
| The constellation tree itself | Corner, edge, flick and double-tap actions |
| Icon mode / list mode | Bound apps & shortcuts for those positions |
| Region count and dividers | Hold delay and all accessibility timings |
| The index region | Haptic feedback |
| Background colour, image, dimming, My Sky | Hidden apps |
| Theme and accent colour | Default icon pack |
| Ring radius and star size | Status-bar visibility, orientation |
| Labels, sparks, trails, glow, twinkle | Sound settings |
| Clock / date / weather overlay and its position | All accessibility options |
| Talisman ink and cast glow colours | The talismans themselves |
| Star style, usage-as-light, battery, next event | Comets, the veil, onboarding & hints |
settings — full reference
Every page, every control, in the order they appear on screen.
Getting in, and getting around
- Three ways in: tap the ⚙︎ in the lower-left corner · hold that corner · open Deep Sky and tap ✦ zenith settings.
- Back walks up one level: from a sub-page to the main list, and only from the main list does it leave settings.
- Every change applies immediately. There is no save button anywhere.
- · close · at the bottom of the main page dismisses the sheet, as does tapping the dimmed area above it.
The main page
| Item | What it is |
|---|---|
| ✦ ICON MODE / ☰ LIST MODE | The big two-way switch. Rings of stars, or cascading text lists. Per sky. |
| skies | Create, rename, delete and switch complete setups. The one section with no sub-page. |
| the twelve pages | Listed below, each with a one-line hint under its name. |
The twelve pages
| # | Page | Hint shown | Covers |
|---|---|---|---|
| 1 | talismans | inscribe · playback · priority order | §12 |
| 2 | system | default launcher · status bar · zenith actions | below |
| 3 | gestures | corners · edges · flicks · double-tap | §11 |
| 4 | regions & star index | layout editor · all-apps triggers | §15 |
| 5 | background & light | colors · wallpaper · icon set | below |
| 6 | rings & effects | sizes · labels · sparks · trails | below |
| 7 | the sky's voice | astral tones · ambient drone · scale | §18 |
| 8 | accessibility | dwell · latched · magnify · spoken · haptics | §19 |
| 9 | sky overlays | clock · date · weather · position | below |
| 10 | star chart | backup · hidden apps · reset | §20 |
| 11 | privacy & permissions | no spyware · what each permission does | §21 |
| 12 | about | black syntax · friend castle · version | below |
2 · system
| Control | Default | Does |
|---|---|---|
| set zenith as default launcher → | — | Opens Android's home-app chooser. Replaced by "zenith is your default launcher ✦" once it is. |
| hide status bar | off | Hides Android's status bar; swipe down to reveal it temporarily. |
| show ⚙︎ settings corner | on | The visible gear in the lower left. Off leaves the sky completely bare — hold the corner to get back here. |
| orientation | portrait | portrait · landscape · rotate. Zenith is designed for portrait; landscape keeps identical star sizing on a wider, shorter screen, so very low stars can fall past the bottom edge. |
| zenith actions | off | Status line plus enable zenith actions →. Powers lock, shade, recents, quick tiles, screenshot, power, back, home. |
| zenith gold | free | In this build, a demo switch so both experiences can be tried side by side. Play Billing replaces it at v1.0. |
| ✉ send feedback | — | Opens your mail app to [email protected]. |
| crash report | — | Only appears if a crash was logged. It is stored locally and private; send crash report attaches it to an email you choose to send, discard deletes it. |
| first-time hints | on | The one-time explanation cards. |
| reset hints | — | Makes all eight hints unseen again. |
| replay welcome → | — | Runs the five-step walkthrough again. |
| sky veil | off | See §14. |
| comets · notifications | on | See §13. Needs notification access to show anything. |
5 · background & light
A live preview card sits at the top and re-renders with every change below it — background, a sample stroke at your chosen thickness and glow, a sample star, and the four dock colours.
| Control | Default | Does |
|---|---|---|
| theme | clean | Eight themes; see the table below. Picking one restyles the accent, talisman ink, cast glow and star palette at once — the colour pickers below still fine-tune on top. |
| background | black | Seven swatches, from pure black through near-blacks to paper white. |
| my sky gold | off | Renders the real night sky above you as the background. See below. |
| choose image | — | Any picture as a wallpaper. clear image removes it. |
| image dimming | 0.35 | 0–0.9 · only shown with an image set |
| icon set | system icons | System · Zenith packs · other installed packs. Free. |
| star style | app icons | app icons · monochrome (true desaturation, artwork kept) · text only · inverted mono (for light skies). |
| usage as light | off | Stars you launch often glow brighter — up to about +30%. |
| accent | #E8E8E6 | Rings, labels, clock, trails. |
| talisman ink | pale gold | The stroke colour while drawing fast. |
| cast glow | pale gold | The flash when a sigil lands. |
| background (picker) | black | The full colour table — neutrals plus 12 hues × 6 intensities. |
The eight themes
| Theme | Character | Tier |
|---|---|---|
| clean | Starlight on black, six-colour star palette. The default. | free |
| mono | Every glow flattened to the one light. | free |
| pastel | Mint, lilac, pink and blue at high value. | free |
| rainbow | Six saturated hues across the dock and palette. | gold |
| daytime | Warm — amber, sky blue, apricot. | gold |
| mono inverted | Ink on paper: near-black light on a light sky. Switching to it flips the background to paper white automatically, and switching away flips it back. | gold |
| iridescent | Oil on water — the entire colour set drifts through the spectrum on a ~40 second cycle. Alive even when nothing is happening. | gold |
| neon | Tron: electric cyan grid with hot orange counterlight on a near-black core. | gold |
My Sky gold
With this on, your background is the actual night sky above your location, right now — around 45 named bright stars plus a field of roughly 520 more, placed by local sidereal time and latitude, redrawn every minute so the sky slowly turns. Constellation lines are drawn as hairlines when both ends are above your horizon: Orion, the Big Dipper, Cassiopeia, the Southern Cross and the Summer Triangle.
| Gesture | Does |
|---|---|
| Two-finger pinch | Zoom, 0.6× to 6× |
| Two-finger drag | Pan across the celestial sphere |
| Two-finger twist | Tilt / roll the view. A horizon line appears once you tilt away from straight up. |
| Three-finger tap | Recentre on the zenith |
Without location permission it draws a plausible mid-northern sky; grant the weather permission for your true coordinates.
6 · rings & effects
| Control | Default | Range | Does |
|---|---|---|---|
| orbit radius | 150 | 80–280 dp | How far the 1× ring sits from your finger. |
| star size | 26 | 18–36 dp | Star radius. Also scales the touch target. |
| hold delay | 220 | 120–450 ms | How long a press must last before a ring blooms. |
| labels | on hover | off · on hover · always | When star names are drawn. |
| haptic feedback | on | — | The ticks as you cross stars and the thump when a ring opens. |
| birth sparks | on | — | Particles when stars are born, launched or removed. |
| spark intensity | gentle | twinkle · gentle · lively · 🎆 sparkler gold | How many particles and how fast they fly. |
| light trails & comet | on | — | The tail that follows your finger. |
| trail sustain | 450 ms | 0 – permanent | 0 = a twinkle at the touch only; the maximum keeps the whole stroke until you lift. |
| trail thickness | 4 | 2–10 dp | Core width of the finger trail. |
| trail glow | 10 | 0–25 | Halo around the trail. 0 = none. |
| line thickness | 1.8 | 0.5–5 dp | Stroke of orbit rings and star outlines. |
| star & orbit glow | 10 | 0–25 | Halo around stars and orbits. |
| ✨ twinkle gold | 0 | 0–100 | Tiny four-point sparkles shimmering around your fingertip. |
| show dock buttons | on | — | The ✛ ◈ ✎ − column. |
| show corner & edge hints | on | — | The dots and dashes marking assigned positions. |
9 · sky overlays
| Control | Default | Does |
|---|---|---|
| position on screen | top centre | A 3×3 grid of anchors. The whole block moves together. |
| clock | on | Large, extra-light. Tap it to open your alarms app. |
| 24-hour time | off | Applies to the clock, the veil clock and event times. |
| date | on | "Thu, Jul 23". Tap it to open your calendar. |
| battery | off | ⚡︎ and a percentage. Tap to open battery usage. |
| next calendar event | off | ◷, the time and the title of your next event in the coming 24 hours. Asks for calendar permission when switched on. All-day events are skipped. |
| weather | off | A weather glyph and the temperature. Asks for coarse location when switched on. Tap it to refresh. Refreshes itself every 30 minutes. |
| celsius | on | Off gives Fahrenheit. Only shown with weather on. |
The overlay block sits above the ring canvas, so tapping the clock opens the clock rather than blooming a ring.
12 · about
The version number, the credits — developed by black syntax · published by friend castle — links to friendcastle.org and the studio's other apps, the Open-Meteo credit for weather and sky data, the contact address [email protected], and the privacy policy.
the sky's voice
Every sound Zenith makes is synthesised on the fly — there are no audio files in the app. A star's note comes from where it sits on its ring, so tracing the same path twice plays the same phrase, and a practiced route becomes a melody you know by ear before you know it by sight. gold
the sky's voice
Every sound Zenith makes is synthesised on the fly — there are no audio files in the app. A star's note comes from where it sits on its ring, so tracing the same path twice plays the same phrase, and a practiced route becomes a melody you know by ear before you know it by sight. gold
| Control | Default | Does |
|---|---|---|
| ✧ sound | off | The master switch. Sound should never be a surprise, so it starts silent. |
| volume | 50 | 0–100 |
| stars | on | A note as each star takes your finger. |
| rings | on | Opening, descending, folding shut — three distinct figures. |
| opening | on | The bright triad when something launches. |
| talismans & comets | on | A wide ringing fifth for a cast; one high glint for a caught comet. |
| ambient | off | Three detuned low tones breathing against each other, under everything. |
| tuning | open | open major pentatonic · deep minor pentatonic · floating lydian. Pentatonic means no two stars can ever clash. |
| hear a star / launch / cast | — | Three preview buttons. |
Zenith never requests audio focus — a launcher has no business pausing your music. It follows your media volume, and it stops the sound engine entirely the moment the launcher leaves the screen, so no audio thread runs behind another app. The ambient drone only plays while the sky is visible.
accessibility
Zenith is a gesture launcher, which makes reachability a real design problem rather than a checkbox. Every option here is optional, off by default, and never paywalled.
Motor & touch
| Control | Default | Does |
|---|---|---|
| dwell to select | off | Rest on a star and it launches on its own, no lift required. A countdown arc closes around the star as it fills. |
| dwell time | 900 ms | 400–2500 ms |
| latched buttons | off | The single most important option for anyone who cannot hold a finger down. See below. |
| touch target size | 1.0× | 1.0–2.5× — enlarges every star's hit area without changing how it looks. |
Latched mode, in full
With latched buttons on, the sustained hold disappears from the launcher entirely:
- Hold once to open a ring Then lift. The ring stays open.
- Tap stars to select them Each tap arms that star.
- Tap ◉ to open it Lower right. On a folder, ◉ descends into it instead.
- Tap ‹ to go back Below ◉. It folds one ring shut, and closes the session at the root.
Vision
| Control | Default | Does |
|---|---|---|
| magnifier | off | The hovered star swells to nearly twice size and comes to the front, ignoring its neighbours. |
| spoken labels | off | Speaks each star's name aloud as your finger reaches it, using the device's text-to-speech. |
| high contrast | off | Forces pure white light everywhere. This overrides your accent colour, and the colour setting says so. |
| star label text size | 100% | 70–250% |
| clock & overlay text size | 100% | 60–200% |
| remove glows | off | Strips every halo. Overrides the trail-glow and star-glow sliders. |
Motion, timing & haptics
| Control | Default | Does |
|---|---|---|
| reduce motion | off | Calms the comet trail, sparks, shockwaves and the hover pulse. Overrides the sparks and trails switches. |
| ring opens after | 220 ms | 120–600 ms — the same hold delay, with a wider range here. |
| folder ring blooms after | 330 ms | 150–1200 ms |
| double-tap window | 340 ms | 200–700 ms |
| per-star haptics | — | Set in each star's ✎ editor. With spoken labels, a ring becomes navigable by feel and sound alone. |
When an accessibility option forces another setting, the forced control dims and says so: "⟂ overridden by reduce motion". Nothing silently disagrees with itself.
TalkBack & screen readers
The launcher is drawn on a bare canvas, which a screen reader cannot see. So when — and only when — a touch-exploration reader such as TalkBack is running, Zenith lays an invisible, focusable list of the current region's stars over the sky. It has no visual footprint and receives touches only through the accessibility framework.
Each entry is announced as a direction to draw toward, which is how a blind user learns a constellation:
what TalkBack reads
"45 degrees, Instagram, app" · "180 degrees, far orbit, media, folder, 5 inside" · "270 degrees, Messages, app, inside a folder"
Angles use the spoken convention: 0° is straight up, increasing clockwise. Orbit distance is called out as near, outer or far when a star is off the default ring.
star chart & backups
A star chart is your whole sky in one JSON file — constellations, settings, talismans and your custom icons. It is written only when you ask for it, to a place you choose, and Zenith never uploads it anywhere.
Exporting
- settings › star chart › export ✦
- Choose where to save it Android's file picker opens, pre-named zenith-star-chart.json.
- That's the whole backup Keep it, sync it, or send it to a friend — a star chart is shareable by design.
Importing
import… opens the file picker; choose a star chart and it is applied immediately, replacing your constellations and settings.
| Travels | Does not travel |
|---|---|
| Every region's constellation tree | Widgets — their stars import, but Android widget IDs are device-local, so each must be re-bound on the new device |
| All settings | Your wallpaper image — a content URI does not survive a device change; pick the image again |
| Talismans, with their drawn shapes | The Gold entitlement |
| Custom star icons, embedded as image data and rebuilt on the new phone | — |
Hidden apps
Apps hidden from Deep Sky (long-press › hide from deep sky) are listed here, each with an unhide button. The section only appears when something is hidden.
Erase all rings
erase all rings… empties every region in the current sky. It is a two-tap confirmation — the button changes to tap again to erase all rings — and any widgets held by those stars are released. Settings, talismans and other skies are untouched.
Export a star chart first if there is any doubt. It takes ten seconds and it is the only way back.
privacy & permissions
No spyware. No accounts. No servers. Zenith has nowhere to send your data and never will — the apps you open, your notifications, your location. There is no "us" to send it to.
The one thing that ever leaves your phone
If you turn on weather or My Sky, your location — rounded to about the nearest kilometre — is sent to the public Open-Meteo weather service. No account, no identifier, nothing else. Leave weather off and Zenith never makes a network request at all.
What each permission does
| Permission | Used for | What happens to the data |
|---|---|---|
| location (coarse) | Weather, and placing the real night sky | Rounded before use. Never stored. Never sent anywhere but that one weather request. |
| notification access | Comets | Titles are drawn on your screen and forgotten. Never stored, never transmitted. Off = nothing is read. |
| accessibility (Zenith actions) | Lock, shade, recents, quick tiles, screenshot, power, back, home — and screen-reader / haptic navigation | Configured to read nothing from your screen. It only performs the actions you assign. |
| calendar (read) | The "next event" line under the clock | Read and shown on-device. Never sent. |
| vibrate | Haptic feedback | — |
| internet | The weather request, and nothing else | Used only when you enable weather or My Sky. |
Where your data lives
Constellations, settings, talismans and custom icons all sit in Zenith's private storage on your device. A star chart is written only when you export one. Uninstalling removes everything.
The full policy is at zenith.blacksyntax.com/privacy.
free & gold
The rule Zenith holds to: every feature is usable for free. Gold caps quantity and depth — it never walls a feature away. All accessibility, all backups, and comets are free forever.
Exactly where the free limits sit
| Thing | Free | Gold | What you see at the limit |
|---|---|---|---|
| Regions | 2 | 9 | The slider stops at 2 and the Gold sheet opens. |
| Talismans | 3 | unlimited | The inscribe button reads ✦ more talismans with gold. |
| Skies | 1 | unlimited | + new sky opens the Gold sheet. |
| Themes | clean · mono · pastel | all eight | Locked themes are burnt-gold with a ✦. |
| Spark intensity | twinkle · gentle · lively | + 🎆 sparkler | The top chip is burnt-gold. |
| Twinkle | — | 0–100 | The slider is gold and inert. |
| My Sky | — | ✓ | The row is gold and marked gold. |
| Your own images as icons | — | ✓ | ✦ choose image… opens the Gold sheet. Bundled glyphs and icon packs stay free. |
| Sound | silent | ✓ | The master switch is gold and marked gold. |
b0.8 is a demo build: Gold is a free switch in settings › system › zenith gold so both experiences can be tried side by side. Play Billing replaces the switch at v1.0. Nothing you build under one is lost when you toggle the other.
troubleshooting
Sorted by what the person actually says, not by which subsystem is involved.
"Nothing happens when I hold the screen"
- You may be in a corner or an edge. The four corners (52 dp) and the edge bands (18 dp) run their assigned action instead of opening a ring. Start the hold nearer the middle.
- You may be moving. Movement before the hold lands turns the touch into a flick or a talisman attempt. Hold still.
- The hold delay may be long. Check settings › rings & effects › hold delay.
- That region may be the Star Index region. Check settings › regions & star index › open from a region.
"The ring opens but it's empty"
That region has no stars yet — it says "slide to ✛ to add" under the ring. Slide onto ✛, place the star, and pick what it opens. Remember each region keeps its own ring: a full region 1 does not fill region 2.
"Folders open when I don't want them to" / "won't open at all"
Folders open on a dwell, not a pass. Raise folder ring blooms after if they open while you are circling; lower it if resting feels slow. It lives in settings › accessibility › extended.
"I can't get back to the previous ring"
Trace your finger back into the small chevron at the previous ring's centre — the exact point your line came from. If you have overshot, slide to empty sky, lift (nothing happens), and start again.
"I turned off the gear and now I can't find settings"
Three ways back, in order of reliability:
- Hold the lower-left corner — the default settings anchor.
- Open Deep Sky (hold the lower-right corner, or flick up) and tap ✦ zenith settings, which is always the first row.
- Open Zenith from your app drawer if another launcher is still installed.
"App shortcuts don't work"
Android only gives shortcuts to the active home app. Set Zenith as your default launcher in settings › system, then return to the Shortcuts tab. The same applies to Direct.
"Lock / shade / recents / screenshot do nothing"
Those need the Zenith actions accessibility service. settings › system › enable zenith actions →. Lock and screenshot additionally need Android 9 or newer.
"No comets appear"
- Grant notification access — settings › system › enable comet feed →. The status line must read comet feed connected ✦.
- Only new notifications become comets. Existing ones do not.
- Ongoing notifications (music, downloads) are skipped by design, and so are Zenith's own.
- You have to be looking at the sky — comets live on the home screen, not over other apps.
"My talisman won't cast"
- Draw faster. Speed is the trigger. If a ring blooms, you were too slow.
- Draw bigger. Very short strokes are ignored.
- Check the master switch — settings › talismans › talismans active.
- Check for a lookalike. If two glyphs are similar, the one higher in the list wins; use ⋮ move up, or re-inscribe one as a clearly different shape.
- Watch the ink colour. The trail turns talisman-ink while you are drawing fast enough to cast.
"I'm locked behind the veil"
Press one finger anywhere and hold perfectly still for four seconds. A ring fills around your finger, and the veil lifts the instant it completes. This always works, with or without any talisman inscribed.
"A star is off the edge of the screen"
It was placed at an orbit or angle that falls outside the screen from where you start that hold. Open the ring, touch the star if you can reach it and use ✎ › ◎ re-place — or find it in ✛ › Edit, which lists every star on the ring regardless of where it sits, and use ◎ there.
"An icon didn't change"
Higher layers win. A star with its own ◈ icon ignores the app-level icon, which in turn ignores the pack. Clear the star's icon with reset icon to let the layer below show through.
"The widget says 'widget unavailable'"
Its binding is gone — usually after restoring a backup on a different device, or after the widget's app was reinstalled. Remove the star and add the widget again from ✛ › Widgets.
"Weather shows · · ·"
It has no reading yet. Check that location permission was granted, that the device has a recent location fix, and that you have a connection. Tap the weather line to force a refresh.
"Left/right flicks never fire"
Android's back gesture owns the screen edges and Zenith never fights the system. Use a corner, an up/down flick, or the drawn circle instead.
instructing a user
This chapter is written for whoever is doing the explaining — a support reply, a friend on the phone, or an assistant answering a question. Each entry is the question as people actually ask it, followed by wording that can be read out verbatim.
Five rules for explaining Zenith
- Always say where the finger starts. "Press and hold in the middle of the screen" is a complete instruction; "open the menu" is not.
- Always say whether to lift. Most Zenith mistakes are lifting too early. Say "keep holding" out loud at every step that needs it.
- Use the app's own words. hold · slide · lift · rest · trace · draw · cast · inscribe. They match what is written on screen and in the hints.
- Give the escape first. Tell people that lifting on empty sky cancels everything before you ask them to try anything.
- Name the corner, not the icon. "The lower-left corner" survives every theme and settings change; "the little grey gear" does not.
Answers, ready to read out
how do I open an app?
Press and hold anywhere in the middle of the screen. Keep your finger down — a ring of your apps appears around it. Without lifting, slide onto the app you want, then lift your finger. If you change your mind, slide to an empty part of the screen and lift; nothing happens.
how do I add an app to my home screen?
Hold the middle of the screen until the ring appears. Still holding, slide down to the ✛ button on the left edge. A ghost star now follows your thumb — move it to where you want the app, near or far from the centre, then lift. A list opens: tap Apps, find the one you want, and tap it. It lands exactly where you left the mark.
how do I make a folder?
Same as adding an app, but on the list choose the Folder tab, type a name, and tap create ✦. To put things inside it: hold the sky, rest your finger on the folder star for a moment until its own ring opens, then slide to ✛ and add as normal.
how do I remove something?
Hold the sky, slide onto the star you want gone — just touching it is enough — then slide down to the − button at the bottom left. It will circle the star in pink and say "remove ⟨name⟩". Lift to confirm. If you want to remove several, tap the − with a second finger instead of lifting; the ring stays open.
where are the settings?
Press and hold the very bottom-left corner of the screen — right in the corner, not near it. Settings open. There is also a small ⚙ in that corner you can just tap. And if you ever can't find it: open the app list (hold the bottom-right corner) and tap zenith settings at the top.
how do I see all my apps?
Two ways. Hold the bottom-right corner for a searchable list — the search box is at the bottom so you can scroll first. Or draw a quick circle anywhere on the screen for the Star Index, where apps sit in letter groups you can slide through without lifting your finger.
how do I change the background?
Settings — hold the bottom-left corner — then background & light. There is a row of colours, a choose image button for your own picture, and a dimming slider once an image is set. The theme chips at the top change the colour of the stars themselves.
how do I go back?
Inside a folder, trace your finger back to the small mark at the centre of where you came from — the ring folds shut. To leave entirely, slide to any empty part of the sky and lift.
can I have different home screens?
Two ways, and they answer different questions. Regions split one screen into areas — holding the top half gives one set of apps, the bottom half another. Skies are entirely separate setups, switched from the top of settings, each with its own apps, layout and colours.
it keeps opening folders while I'm looking around
Folders open when you rest on them, so keep your finger moving while you look. If it is still too eager, go to settings › accessibility › extended and raise folder ring blooms after.
I can't hold my finger down that long
Turn on latched buttons in settings › accessibility. After that you hold once, lift, and the ring stays open — tap the stars to pick one, tap ◉ to open it, and ‹ to go back. Both buttons sit at the bottom right. You can also turn on dwell to select, which opens whatever you rest on.
how do I back it all up?
Settings › star chart › export ✦, then choose where to save the file. That one file holds your whole sky — apps, layout, settings, talismans and custom icons — and you can share it with someone else. Widgets are the only thing that has to be set up again on a new phone.
what is a talisman?
A shape you draw to open something. You inscribe it once in settings › talismans — draw the shape twice, then choose what it should open. After that, drawing that shape quickly on the home screen opens it straight away. The trick is speed: a slow press opens the ring, a fast stroke casts the sigil.
is it collecting my data?
No. Zenith has no servers, no accounts and no analytics — there is nowhere for it to send anything. The single exception is if you switch on weather, which sends your location, rounded to about a kilometre, to a public weather service. Every permission is optional and the launcher works without any of them.
Decision tree — "it isn't working"
| Ask | If yes |
|---|---|
| "Where on the screen are you pressing?" | A corner or edge → that position has an action assigned; press nearer the middle. |
| "Are you lifting your finger before anything appears?" | Yes → tell them to keep holding for about a second. |
| "Is your finger moving while you press?" | Yes → movement turns it into a flick or a drawn glyph. Hold still. |
| "Does a ring appear, but empty?" | Yes → that region has nothing in it yet. Add via ✛, or check whether they built their sky in a different region. |
| "Is Zenith your default home app?" | No → shortcuts, Direct and the home button will not behave. settings › system. |
| "Did you enable Zenith actions?" | No → lock, shade, recents, screenshot and power cannot work. |
| "Which sky are you in?" | A second sky → their constellations live in the other one. Top of settings. |
glossary
Zenith's vocabulary, defined once.
glossary
Zenith's vocabulary, defined once.
| Word | Means |
|---|---|
| sky | Both the home screen itself, and one complete switchable setup. |
| star | One item on a ring: an app, folder, shortcut or widget. |
| ring | A folder's contents drawn as a circle around your finger. |
| constellation | The whole nested tree of rings in one region. |
| orbit | How far a star sits from its ring's centre, as a multiplier of the base radius. |
| region | An area of the screen with its own root ring. Up to nine. |
| bloom | The animation of a ring opening. |
| dwell | Resting still on something long enough for it to act. |
| hybrid | A star that both launches something and holds children. |
| ritual | A folder that launches everything inside it, in order, on one release. |
| breathe | A deliberate 2.6-second pause before a star opens, so you can change your mind. |
| talisman / sigil | A shape you draw to open something. |
| cast | To draw a talisman fast enough that it fires. |
| inscribe | To record a new talisman. |
| comet | A notification drifting across the sky. |
| deep sky | The searchable list of every app. |
| star index | The all-apps semicircle, grouped by letter. |
| the dock | The ✛ ◈ ✎ − column shown while you hold. |
| the veil | A curtain over the launcher, lifted by a drawn sigil or a rested finger. |
| star chart | A backup file containing your whole sky. |
| my sky | The real night sky above your location, rendered as the background. |
| supernova | The shockwave when a star launches. |
| ghost | The fading trace of your stroke after you lift. |
| direct | The inbox for things other apps pin to your home screen. |
| zenith actions | The optional assistive service that performs system actions. |
quick reference
One card. If you print anything, print this.
Gestures
| Do this | Get this |
|---|---|
| Hold empty sky | A ring of stars blooms at your finger |
| Slide onto a star · lift | Opens it |
| Rest on a folder star | Its ring blooms around it |
| Trace back into the ring's heart | Folds that ring shut |
| Lift on empty sky | Everything dissolves |
| Slide onto ✛ · position · lift | Place a new star, then choose what it opens |
| Touch a star · slide to ◈ ✎ − | Icon · edit · remove |
| Second-finger tap − | Removes without ending the hold |
| Hold the lower-left corner | Settings |
| Hold the lower-right corner | Deep Sky |
| Hold the upper-left corner | Notification shade |
| Hold the upper-right corner | Lock screen |
| Flick up · flick down | Deep Sky · notification shade |
| Double-tap the sky | Lock screen |
| Draw a quick circle | Star Index |
| Draw a sigil, fast | Casts that talisman |
| Hold a drifting comet | Catch it — open · dismiss · snooze |
| Two fingers on the sky gold | Pinch, pan and twist My Sky · three fingers recentre |
Defaults worth knowing
| Setting | Default |
|---|---|
| Mode | icon mode (rings) |
| Regions | 1 — the whole screen |
| Hold delay | 220 ms |
| Folder dwell | 330 ms |
| Orbit radius · star size | 150 dp · 26 dp |
| Labels | on hover |
| Theme · background | clean · black |
| Clock · date | on · on, top centre |
| Weather · battery · next event | off |
| Comets | on (needs notification access) |
| Sky veil | off |
| Sound | off |
| Orientation | portrait |
| Everything in accessibility | off |
Where to find things
| To change… | Go to |
|---|---|
| Colours, wallpaper, icon pack, star style | settings › background & light |
| Ring size, star size, labels, effects, hold delay | settings › rings & effects |
| What corners, edges, flicks and double-tap do | settings › gestures |
| Splitting the screen, all-apps triggers | settings › regions & star index |
| Clock, date, weather, battery, next event | settings › sky overlays |
| Default launcher, status bar, Gold, veil, comets, hints | settings › system |
| Drawn sigils | settings › talismans |
| Backups, hidden apps, erasing | settings › star chart |
| Dwell, latched buttons, contrast, text size, timings | settings › accessibility |
| Separate complete setups | settings › skies (main page) |