skip to the manual
ZENITH Zenith Suite — home handbook
[ fly it ] [ join the waitlist ]
zenith launcher · handbook

the whole sky, written down.

Zenith is a launcher that lives in one gesture: you hold the empty sky, a ring of app-stars blooms under your finger, you slide onto one and lift. Everything else in this manual is a refinement of that sentence.

This is the complete manual — every menu, every button, every setting, with its default, its range, and what it actually changes. It is written to be read straight through, searched in a hurry, or quoted verbatim by someone helping another person over the phone.

build · b0.8 android 8.0+ · portrait by default developed by black syntax plain-text manual ↓ machine-readable reference ↓
01

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

notation
Written asMeans
settings › systemA path through menus. Open settings, then the row named system.
holdPress and keep your finger down without lifting. Never a quick tap.
slideMove the finger that is already down. The gesture has not ended.
lift / releaseTake the finger off the glass. This is what commits an action.
dwellStop moving and wait, finger still down, for a set number of milliseconds.
dpDensity-independent pixels — Android's screen unit. 1 dp ≈ 1/160 inch, identical physical size on every phone.
goldRequires the one-time Zenith Gold unlock. Everything else is free forever.
defaultWhat 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

  1. 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.
  2. Where you start the hold matters. The screen can be split into up to 9 regions, and each region keeps its own constellation.
  3. 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.
  4. Releasing is committing. Lift on a star to open it, lift on empty sky to dissolve everything and change nothing.
02

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

  1. Install the app Zenith Launcher requires Android 8.0 or newer. It runs on phones and tablets; portrait is the designed orientation.
  2. Open it once The first launch shows a five-step welcome. Every step can be skipped and repeated later.
  3. 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 ✦.

onboarding · 5 steps + a final choice
StepCardWhat it asks forSkippable
0welcome to zenithNothing. States the privacy position and the core gesture. Button: begin.
1make zenith your homeDefault-launcher role, so the home button returns to the sky.yes
2zenith actionsThe optional accessibility service that performs lock / shade / recents / quick tiles / screenshot / power.yes
3notification cometsNotification access, so notifications drift by as catchable comets.yes
4weather & your real skyCoarse location, for the weather readout and the My Sky background.yes
5how 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.

starter ring layout · 0° is straight up, angles run clockwise
PositionAngleApp chosen
topPhone / dialler
upper right45°Messaging
right90°Email
lower right135°Gallery / Photos
bottom180°media folder — YouTube, YT Music, Spotify, TikTok, VLC (whichever are installed)
lower left225°Calendar
left270°Clock / alarms
upper left315°Tasks
to replay it

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.

the eight one-time hints
Fires whenTitledTells you
the sky first appearstwo things to knowWhere settings live, and how to see every app.
your first ring bloomsa ring is bornKeep holding, slide onto a star, lift to open.
a folder ring bloomsdescend into a folderRest to descend; trace back to the ✦ at the heart to return.
the add sheet opensthe corner dockWhat ✛ ◈ ✎ − do while you hold.
deep sky opensthe deep skyEvery app, searchable, search box at the bottom.
the star index opensthe star indexLetter groups, slide to a group then an app.
a talisman castsa talisman castWhere to inscribe your own.
settings opensthe settings cornerThe 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.

03

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

  1. 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.
  2. 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.
  3. Lift to open it The star goes supernova — a shockwave ring and sparks — and the app opens.
  4. Or lift on empty sky Everything dissolves. Nothing was changed, nothing was launched.
the one rule

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.

  1. 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.
  2. 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.
  3. Keep going as deep as you like Rings nest without limit.
  4. 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

gesture timings · all adjustable
WhatDefaultRangeWhere to change it
Ring opens after a hold220 ms120–450 mssettings › rings & effects › hold delay
(120–600 ms in accessibility › extended)
Folder ring blooms after a dwell330 ms150–1200 mssettings › accessibility › extended
Double-tap window340 ms200–700 mssettings › accessibility › extended
Dwell-to-select (rest to launch)900 ms400–2500 mssettings › accessibility › motor
Ring bloom animation240 msfixed
Ritual step spacing650 msfixed
"Breathe" pause before opening2600 msfixedper star, in the ✎ editor
Veil rest-to-unseal4000 msfixed

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.

the six states
StateYou areEnds when
idleNot touching, sky bareYou touch down.
pendingFinger down, hold not yet completeThe hold delay passes (ring opens, or the corner/edge action fires), or you move far enough to become a flick.
flickMoving fast before the hold landedYou lift — the stroke is judged as a flick, a drawn circle, or a talisman. Abandoned after 900 ms.
activeA ring (or list panel) is open under your fingerYou lift.
all appsThe Star Index semicircle is openYou lift on an app, or on empty space.
cometYou caught a notification comet and its menu is openYou lift on a menu row, or off it to let the comet fly on.

What each release does

release targets, while a ring is open
Lift on…Result
An app starLaunches the app.
A shortcut starRuns the app shortcut (needs Zenith to be the default launcher).
A widget starOpens the widget as a floating, draggable window.
A folder starNothing — folders open by dwelling, not by release. (Unless it is a ritual folder, which launches everything inside.)
The star at the ring's heartOpens 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 skyEverything 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 vs list mode
✦ icon mode default☰ list mode
What bloomsA ring of stars around your fingerA text panel beside your finger, on whichever side has room
SelectingSlide onto a starSlide down the rows; the row under your thumb highlights
Going deeperDwell on a folder starDwell on a folder row — a child panel cascades clear of the parent
Dwell timefolder-bloom delay (330 ms)hold delay (220 ms)
Going backTrace into the chevron at the previous ring's heartMove to a different row — deeper panels collapse instantly
Adding a starLive placement on the ring, then the add sheetThe add sheet opens directly; angle and orbit are chosen for you
Row markers folder · widget · shortcut
04

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.

9:41 THU, JUL 23
· corners 4 hold anchors
— edges 4 hold bands
9:41 the overlay block
✛ ◈ ✎ − the dock (while holding)
◉ ‹ latched buttons (opt-in)
⚙︎ settings corner (lower left)

Everything that can appear, and where

screen furniture · position and switch
ElementWhereWhen visibleTurn off at
⚙︎ settings cornerLower-left cornerOnly when idle — it hides while a ring is alive so it never sits over the buttonsettings › system › show ⚙︎ settings corner
Clock / date / battery / event / weatherAny of 9 anchor positionsAlways, above the ring canvas — tapping it opens the matching app, not a ringsettings › sky overlays
Corner hints4 tiny dots, 14 dp in from each cornerOnly for corners with an action assignedsettings › rings & effects › show corner & edge hints
Edge hintsShort dashes at the middle of each edgeOnly for edges with an action assignedsame switch as corner hints
Region bordersHairlines on the region gridOnly while you are holding, and only with more than one regionsettings › regions & star index › show region borders while holding
The dock ✛ ◈ ✎ −Column up the left edge, 60 dp inWhile a ring is open. always; ◈ ✎ − appear once you have touched a starsettings › rings & effects › show dock buttons
Latched / Lower right, stackedOnly with latched buttons onsettings › accessibility › latched buttons
Floating widgetsWherever you dragged themUntil closed with
CometsDrifting across the skyWith notification access and comets onsettings › system › comets · notifications
Status barTop of screenAndroid's ownsettings › 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.

dock button positions · from the bottom-left
ButtonHeight above bottomRadiusColour role
add246 dp28 dptheme "add" colour
icon182 dp24 dptheme "icon" colour
edit118 dp24 dptheme "edit" colour
remove54 dp24 dprose — the removal colour

Corner and edge hit zones

where a hold counts as a corner or an edge
ZoneSizeNotes
Corner52 × 52 dpEach of the four corners. A hold started here runs that corner's action instead of opening a ring.
Edge band18 dp wideThe strip along each edge between the corners. Corners win where they overlap.
Right-edge index drag26 dpOnly when "drag in from the right edge" is on. Drag inward 36 dp to open the Star Index.
Star hit target1.4 × star sizeMultiplied again by the accessibility touch-target slider (1.0–2.5×).
on system gestures

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.

05

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

node types
TypeDrawn asRelease doesNotes
appThe app's icon inside a discLaunches the appThe most common star.
folderA tiny orbit: centre point + three slowly circling moonsNothing (dwell to descend)Holds other stars. Nest without limit.
shortcutThe shortcut's iconRuns an app shortcut — "new message", a saved playlist, a bookmarkRequires Zenith to be the default launcher.
widgetA small square outline with a dotOpens the widget as a floating windowDrag 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.

orbit numbers
PropertyValue
Base radius150 dp default · 80–280 dp
Orbit multiplier range0.4× – 6×
Snap step0.25×
Sibling magnetWins only when genuinely nearer than the nearest quarter step
Rendered circlesOne faint orbit line per distinct orbit in use, plus the 1× ring always
rings spill on purpose

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

ring navigation
To…Do this
Open a ringHold empty sky.
Go deeperRest on a folder star for the bloom delay.
Go back one levelTrace inward into the chevron marker at the previous ring's centre.
Launch the folder you're standing inTouch the star at the current ring's heart and lift (works for hybrids and rituals).
Leave without doing anythingSlide to empty sky and lift.
Circle a ring without opening foldersKeep moving. Dwell is what opens things, so motion is always safe.

What changes how a star looks

star appearance controls
ControlLives inEffect
star sizesettings › rings & effects26 dp default · 18–36 dp
star stylesettings › background & lightapp icons · monochrome (true desaturation) · text only · inverted mono
labelssettings › rings & effectsoff · on hover · always. Text-only style forces labels on.
light color✎ star editorPicks from the current theme's palette. Mono themes flatten every star to the one light.
show label / show icon✎ star editorPer star, independent of the global setting.
custom icon pickerOverrides everything for that one star.
usage as lightsettings › background & lightStars you launch often glow brighter, up to +30%.
line thickness · star glowsettings › rings & effectsStroke weight and halo of stars and orbit lines.
labels move out of the way

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.

06

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

dock buttons · slide onto one and release, or tap it with a second finger
ButtonActs onRelease doesSecond-finger tap does
addThe star under your finger, else the open ringOpens the add sheetStarts live placement — your held thumb now positions the new star
iconThe last star you touchedOpens the icon pickerSame, and ends the gesture
editThe last star you touchedOpens the star editorSame, and ends the gesture
removeThe last star you touchedRemoves itRemoves 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.

removal is always shown before it happens

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.

  1. 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.
  2. 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.
  3. Release where you want it The spot is locked in. Only now does the add sheet open.
  4. 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.

in list mode

There is nothing to position, so skips placement entirely and opens the add sheet immediately. Angles are chosen for you.

07

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

✛ add sheet
TabWhat it listsTapping a row
AppsEvery installed app, with a search field at the topPlaces that app as a star
FolderA name fieldcreate ✦ makes an empty folder star that opens its own ring
WidgetsEvery installed widget provider, alphabetical, with its package underneathBinds the widget (may show a system permission screen and the widget's own setup screen), then places it
ShortcutsApps first; tap one to see the shortcuts it publishesPlaces that shortcut as a star
DirectEverything other apps have sent into Zenith with "add to home screen"Places it as a star
EditThe current ring's contents as a listSee below
rings hold personal-profile apps only

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

✛ · edit — one row per star on this ring
ControlDoes
The colour dotTap to cycle that star through the theme palette
The nameTap 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

  1. ✛ › Widgets › pick a provider Android may ask permission to bind the widget the first time.
  2. Configure it If the widget has its own setup screen, it opens now.
  3. Place it Either it lands on the spot you already marked, or the placement screen opens.
  4. Open it Release on its star and it appears as a floating window.
floating widget window
PartDoes
Title barDrag 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.
widgets do not travel

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.

08

the star editor

Everything about one star, in one panel. Reach it by touching the star during a hold and then sliding onto .

✎ star editor · every control
ControlTypeApplies toWhat it does
nametext fieldallRenames the star. Saves as you type.
light colorswatch rowallPicks from the current theme's palette. Mono themes will flatten it on screen.
show labelswitchallHides this star's name even when labels are on globally.
show app iconswitchapp · shortcutOff draws a bare coloured point instead of the icon.
breathe before openingswitchapp · shortcutAdds 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.
ritualswitchfolderReleasing on this folder activates everything inside, in order, 0.65 s apart. The star wears a double band.
haptic signature8-slot timelineallTap 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.
▶ feelbuttonallPlays the pattern.
clearbuttonallEmpties the pattern back to silence.
preset →buttonallCycles four ready-made patterns: pulse · triple tick · swell · double knock.
uninstall app from device…linkappHands off to Android's uninstall dialogue.
re-placebuttonallOpens the placement screen to move the star to a new angle and orbit.
removebuttonallTakes the star off the ring. Children go with it.
done ✦buttonallCloses. Everything was already saved.
haptics as navigation

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.

09

icons

Three layers decide what picture a star wears. Each one overrides the one below it.

icon precedence · highest first
LayerSet fromScope
1 · This star's custom icon during a holdOne star on one ring
2 · This app's chosen iconDeep Sky › long-press an app › ◈ set iconEverywhere that app appears — Deep Sky, the Star Index, and every star that has no icon of its own
3 · The default icon packsettings › background & light › icon setEvery app icon in the launcher
4 · The app's own iconAndroidThe fallback when nothing above matches

The ◈ picker

icon picker sections
SectionContainsNotes
zenith setEight bundled glyphs: star · moon · sun · comet · orbit · spark · eye · runeFree. Tap one and it applies immediately.
icon packs (name)Tapping the pack's name asks that pack for its own icon for this appOne 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, searchableUse this when the pack has no automatic match, or you want a different picture entirely.
choose image… goldAny picture from your phone, with a pinch-and-drag round cropSaved as a 512 px circular PNG in Zenith's own storage.
reset iconRemoves the custom iconOnly 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.

10

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

deep sky · app menu
ItemDoes
openLaunches it.
view app infoOpens Android's app info page.
set iconDresses 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 thisJumps straight into drawing a sigil bound to this app.
hide from deep skyRemoves 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

star index triggers
TriggerDefaultSet atNotes
Draw a quick circle anywhere on the skyonsettings › regions & star indexThe most reliable one — no system gesture competes with it.
A corner, edge, flick or double-tap set to star indexunassignedsettings › gesturesAny position can do it.
Drag in from the right edgeoffsettings › regions & star indexOff by default because Android's back gesture owns the edges.
A dedicated regionnonesettings › regions & star indexHolding anywhere in that region shows the index instead of a ring.

Using it

  1. 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.
  2. 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.
  3. Slide onto an app It swells and its name appears to its left.
  4. 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.

11

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

settings › gestures
GroupPositionsHow it firesDefaults
corners↙ bottom-left · ↘ bottom-right · ↖ top-left · ↗ top-rightHold inside the 52 dp corner squaresettings · deep sky · shade · lock
edges← left · → right · ↑ top · ↓ bottomHold on the 18 dp band between the cornersall unassigned
flicks↑ up · ↓ down · ← left · → rightA quick swipe on empty sky: at least 55 dp within 330 msdeep sky · shade · none · none
double-tap◎◎ on the skyTwo taps within the double-tap window, close togetherlock

The action roster

Every position offers the same list. Tap a chip to assign it.

all fourteen actions
ActionDoesNeeds
noneNothing. A hold here opens a ring instead.
settingsOpens Zenith's settings.
deep skyThe searchable all-apps list.
star indexThe all-apps semicircle.
shadePulls down the notification shade.Zenith actions (falls back to a system API on some builds)
quick tilesOpens quick settings.Zenith actions
lockLocks the screen.Zenith actions · Android 9+
recentsOpens the recent-apps switcher.Zenith actions
screenshotTakes a screenshot.Zenith actions · Android 9+
power menuOpens the power dialogue.Zenith actions
backPerforms system back.Zenith actions
homePerforms system home.Zenith actions
seal the skyDraws the Sky Veil immediately.
app or shortcutOpens 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.

left and right flicks

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.
12

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

  1. 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.)
  2. Draw your shape One continuous stroke, anywhere on the black sheet. It must be at least a few points long to register.
  3. 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.
  4. Name it and bind it Three tabs: apps (searchable), actions (the action roster), rings (any folder in your sky, listed by its full path).
  5. 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

settings › talismans
ControlDoes
talismans activeMaster switch. Off means no fast stroke ever casts.
The numbered listEach 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-inscribeRedraw the shape, keeping the name and target.
move up / move downChanges priority. Up = wins ties.
deleteRemoves it.
✎ inscribe new talismanStarts a new one. Free allows 3; beyond that it becomes ✦ more talismans with gold.
design advice

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).

13

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

  1. settings › system › comets · notifications The switch "notifications drift by as comets" is on by default.
  2. 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.
  3. That is all The status line then reads "comet feed connected ✦".

Catching one

  1. 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.
  2. Its flight freezes After the hold delay, the comet stops and a small menu appears beside it.
  3. Slide to a row and lift open · dismiss · snooze 30 min.
  4. 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.
14

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.

read this first

The veil has no password and never did. It hides your sky from someone glancing at an unlocked phone; it does not protect the phone. Keep your system lock screen.

Setting it up

  1. settings › system › sky veil Turn on "veil when the screen sleeps".
  2. Choose the key any talisman (the default) accepts any sigil you have inscribed; or pick one specific talisman as the only key.
  3. 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

two ways through the veil
MethodHowAlways available?
Draw your sigilDraw 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 fingerPress 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.

15

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

region count → grid
RegionsGridShape
11 × 1The whole screen default
21 col × 2 rowsTop half / bottom half
31 × 3Three horizontal bands
42 × 2Quarters
5–62 cols × 3 rowsSix cells (with 5, the last two merge)
7–82 cols × 4 rowsEight cells (with 7, the last two merge)
93 × 3A 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

settings › regions & star index
ControlDefaultDoes
show region borders while holdingonDraws 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 regionChips numbered 1…n. Pick one and holding anywhere in that region opens the Star Index instead of that region's ring. means none.
nothing is lost when you shrink

Reducing the region count hides the higher regions but keeps their constellations. Raise the count again and they are exactly as you left them.

16

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.

settings › skies
ControlDoes
Tap a nameSwitches to that sky. The current one is snapshotted first, so nothing is lost.
markerMarks 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 skyCreates 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.

setting scope
Per skyShared across every sky
The constellation tree itselfCorner, edge, flick and double-tap actions
Icon mode / list modeBound apps & shortcuts for those positions
Region count and dividersHold delay and all accessibility timings
The index regionHaptic feedback
Background colour, image, dimming, My SkyHidden apps
Theme and accent colourDefault icon pack
Ring radius and star sizeStatus-bar visibility, orientation
Labels, sparks, trails, glow, twinkleSound settings
Clock / date / weather overlay and its positionAll accessibility options
Talisman ink and cast glow coloursThe talismans themselves
Star style, usage-as-light, battery, next eventComets, the veil, onboarding & hints
17

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

settings · main
ItemWhat it is
✦ ICON MODE / ☰ LIST MODEThe big two-way switch. Rings of stars, or cascading text lists. Per sky.
skiesCreate, rename, delete and switch complete setups. The one section with no sub-page.
the twelve pagesListed below, each with a one-line hint under its name.

The twelve pages

settings · page list, in screen order
#PageHint shownCovers
1talismansinscribe · playback · priority order§12
2systemdefault launcher · status bar · zenith actionsbelow
3gesturescorners · edges · flicks · double-tap§11
4regions & star indexlayout editor · all-apps triggers§15
5background & lightcolors · wallpaper · icon setbelow
6rings & effectssizes · labels · sparks · trailsbelow
7the sky's voiceastral tones · ambient drone · scale§18
8accessibilitydwell · latched · magnify · spoken · haptics§19
9sky overlaysclock · date · weather · positionbelow
10star chartbackup · hidden apps · reset§20
11privacy & permissionsno spyware · what each permission does§21
12aboutblack syntax · friend castle · versionbelow

2 · system

settings › system
ControlDefaultDoes
set zenith as default launcher →Opens Android's home-app chooser. Replaced by "zenith is your default launcher ✦" once it is.
hide status baroffHides Android's status bar; swipe down to reveal it temporarily.
show ⚙︎ settings corneronThe visible gear in the lower left. Off leaves the sky completely bare — hold the corner to get back here.
orientationportraitportrait · 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 actionsoffStatus line plus enable zenith actions →. Powers lock, shade, recents, quick tiles, screenshot, power, back, home.
zenith goldfreeIn this build, a demo switch so both experiences can be tried side by side. Play Billing replaces it at v1.0.
✉ send feedbackOpens your mail app to [email protected].
crash reportOnly 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 hintsonThe one-time explanation cards.
reset hintsMakes all eight hints unseen again.
replay welcome →Runs the five-step walkthrough again.
sky veiloffSee §14.
comets · notificationsonSee §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.

settings › background & light
ControlDefaultDoes
themecleanEight 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.
backgroundblackSeven swatches, from pure black through near-blacks to paper white.
my sky goldoffRenders the real night sky above you as the background. See below.
choose imageAny picture as a wallpaper. clear image removes it.
image dimming0.350–0.9 · only shown with an image set
icon setsystem iconsSystem · Zenith packs · other installed packs. Free.
star styleapp iconsapp icons · monochrome (true desaturation, artwork kept) · text only · inverted mono (for light skies).
usage as lightoffStars you launch often glow brighter — up to about +30%.
accent#E8E8E6Rings, labels, clock, trails.
talisman inkpale goldThe stroke colour while drawing fast.
cast glowpale goldThe flash when a sigil lands.
background (picker)blackThe full colour table — neutrals plus 12 hues × 6 intensities.

The eight themes

themes · free ones first
ThemeCharacterTier
cleanStarlight on black, six-colour star palette. The default.free
monoEvery glow flattened to the one light.free
pastelMint, lilac, pink and blue at high value.free
rainbowSix saturated hues across the dock and palette.gold
daytimeWarm — amber, sky blue, apricot.gold
mono invertedInk 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
iridescentOil on water — the entire colour set drifts through the spectrum on a ~40 second cycle. Alive even when nothing is happening.gold
neonTron: 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.

navigating My Sky · two fingers, so one finger stays the launcher's
GestureDoes
Two-finger pinchZoom, 0.6× to 6×
Two-finger dragPan across the celestial sphere
Two-finger twistTilt / roll the view. A horizon line appears once you tilt away from straight up.
Three-finger tapRecentre on the zenith

Without location permission it draws a plausible mid-northern sky; grant the weather permission for your true coordinates.

6 · rings & effects

settings › rings & effects
ControlDefaultRangeDoes
orbit radius15080–280 dpHow far the 1× ring sits from your finger.
star size2618–36 dpStar radius. Also scales the touch target.
hold delay220120–450 msHow long a press must last before a ring blooms.
labelson hoveroff · on hover · alwaysWhen star names are drawn.
haptic feedbackonThe ticks as you cross stars and the thump when a ring opens.
birth sparksonParticles when stars are born, launched or removed.
spark intensitygentletwinkle · gentle · lively · 🎆 sparkler goldHow many particles and how fast they fly.
light trails & cometonThe tail that follows your finger.
trail sustain450 ms0 – permanent0 = a twinkle at the touch only; the maximum keeps the whole stroke until you lift.
trail thickness42–10 dpCore width of the finger trail.
trail glow100–25Halo around the trail. 0 = none.
line thickness1.80.5–5 dpStroke of orbit rings and star outlines.
star & orbit glow100–25Halo around stars and orbits.
✨ twinkle gold00–100Tiny four-point sparkles shimmering around your fingertip.
show dock buttonsonThe ✛ ◈ ✎ − column.
show corner & edge hintsonThe dots and dashes marking assigned positions.

9 · sky overlays

settings › sky overlays
ControlDefaultDoes
position on screentop centreA 3×3 grid of anchors. The whole block moves together.
clockonLarge, extra-light. Tap it to open your alarms app.
24-hour timeoffApplies to the clock, the veil clock and event times.
dateon"Thu, Jul 23". Tap it to open your calendar.
batteryoff⚡︎ and a percentage. Tap to open battery usage.
next calendar eventoff◷, 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.
weatheroffA weather glyph and the temperature. Asks for coarse location when switched on. Tap it to refresh. Refreshes itself every 30 minutes.
celsiusonOff 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.

18

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

settings › the sky's voice
ControlDefaultDoes
✧ soundoffThe master switch. Sound should never be a surprise, so it starts silent.
volume500–100
starsonA note as each star takes your finger.
ringsonOpening, descending, folding shut — three distinct figures.
openingonThe bright triad when something launches.
talismans & cometsonA wide ringing fifth for a cast; one high glint for a caught comet.
ambientoffThree detuned low tones breathing against each other, under everything.
tuningopenopen major pentatonic · deep minor pentatonic · floating lydian. Pentatonic means no two stars can ever clash.
hear a star / launch / castThree preview buttons.
it never takes over your audio

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.

19

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

settings › accessibility › motor · touch
ControlDefaultDoes
dwell to selectoffRest on a star and it launches on its own, no lift required. A countdown arc closes around the star as it fills.
dwell time900 ms400–2500 ms
latched buttonsoffThe single most important option for anyone who cannot hold a finger down. See below.
touch target size1.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:

  1. Hold once to open a ring Then lift. The ring stays open.
  2. Tap stars to select them Each tap arms that star.
  3. Tap ◉ to open it Lower right. On a folder, ◉ descends into it instead.
  4. Tap ‹ to go back Below ◉. It folds one ring shut, and closes the session at the root.

Vision

settings › accessibility › vision
ControlDefaultDoes
magnifieroffThe hovered star swells to nearly twice size and comes to the front, ignoring its neighbours.
spoken labelsoffSpeaks each star's name aloud as your finger reaches it, using the device's text-to-speech.
high contrastoffForces pure white light everywhere. This overrides your accent colour, and the colour setting says so.
star label text size100%70–250%
clock & overlay text size100%60–200%
remove glowsoffStrips every halo. Overrides the trail-glow and star-glow sliders.

Motion, timing & haptics

settings › accessibility · remaining sections
ControlDefaultDoes
reduce motionoffCalms the comet trail, sparks, shockwaves and the hover pulse. Overrides the sparks and trails switches.
ring opens after220 ms120–600 ms — the same hold delay, with a wider range here.
folder ring blooms after330 ms150–1200 ms
double-tap window340 ms200–700 ms
per-star hapticsSet in each star's editor. With spoken labels, a ring becomes navigable by feel and sound alone.
⟂ overridden

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.

20

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

  1. settings › star chart › export ✦
  2. Choose where to save it Android's file picker opens, pre-named zenith-star-chart.json.
  3. 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.

what travels in a star chart
TravelsDoes not travel
Every region's constellation treeWidgets — their stars import, but Android widget IDs are device-local, so each must be re-bound on the new device
All settingsYour wallpaper image — a content URI does not survive a device change; pick the image again
Talismans, with their drawn shapesThe 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.

no undo

Export a star chart first if there is any doubt. It takes ten seconds and it is the only way back.

21

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

every permission is optional · zenith works with none of them
PermissionUsed forWhat happens to the data
location (coarse)Weather, and placing the real night skyRounded before use. Never stored. Never sent anywhere but that one weather request.
notification accessCometsTitles 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 navigationConfigured to read nothing from your screen. It only performs the actions you assign.
calendar (read)The "next event" line under the clockRead and shown on-device. Never sent.
vibrateHaptic feedback
internetThe weather request, and nothing elseUsed 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.

22

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.

free

The full gesture launcher · Deep Sky · Star Index · widgets · shortcuts · Direct · star-chart backups & sharing · comets · every accessibility feature · icon packs, including Zenith's own · themes clean, mono and pastel · spark tiers 1–3 · 2 regions · 3 talismans · 1 sky.

zenith gold · $4.99 once

Unlimited regions, talismans and skies · every theme, including living iridescent and neon · My Sky · your own cropped images as star icons · twinkle · the sparkler spark tier · the sky’s voice. One payment of $4.99 — never a subscription. Everything you build stays yours.

Exactly where the free limits sit

free caps
ThingFreeGoldWhat you see at the limit
Regions29The slider stops at 2 and the Gold sheet opens.
Talismans3unlimitedThe inscribe button reads ✦ more talismans with gold.
Skies1unlimited+ new sky opens the Gold sheet.
Themesclean · mono · pastelall eightLocked themes are burnt-gold with a ✦.
Spark intensitytwinkle · gentle · lively+ 🎆 sparklerThe top chip is burnt-gold.
Twinkle0–100The slider is gold and inert.
My SkyThe row is gold and marked gold.
Your own images as icons✦ choose image… opens the Gold sheet. Bundled glyphs and icon packs stay free.
SoundsilentThe master switch is gold and marked gold.
in this build

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.

23

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:

  1. Hold the lower-left corner — the default settings anchor.
  2. Open Deep Sky (hold the lower-right corner, or flick up) and tap ✦ zenith settings, which is always the first row.
  3. 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 switchsettings › 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.

24

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

  1. Always say where the finger starts. "Press and hold in the middle of the screen" is a complete instruction; "open the menu" is not.
  2. Always say whether to lift. Most Zenith mistakes are lifting too early. Say "keep holding" out loud at every step that needs it.
  3. 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.
  4. Give the escape first. Tell people that lifting on empty sky cancels everything before you ask them to try anything.
  5. 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 chartexport ✦, 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 these, in this order
AskIf 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.
25

glossary

Zenith's vocabulary, defined once.

the words
WordMeans
skyBoth the home screen itself, and one complete switchable setup.
starOne item on a ring: an app, folder, shortcut or widget.
ringA folder's contents drawn as a circle around your finger.
constellationThe whole nested tree of rings in one region.
orbitHow far a star sits from its ring's centre, as a multiplier of the base radius.
regionAn area of the screen with its own root ring. Up to nine.
bloomThe animation of a ring opening.
dwellResting still on something long enough for it to act.
hybridA star that both launches something and holds children.
ritualA folder that launches everything inside it, in order, on one release.
breatheA deliberate 2.6-second pause before a star opens, so you can change your mind.
talisman / sigilA shape you draw to open something.
castTo draw a talisman fast enough that it fires.
inscribeTo record a new talisman.
cometA notification drifting across the sky.
deep skyThe searchable list of every app.
star indexThe all-apps semicircle, grouped by letter.
the dockThe ✛ ◈ ✎ − column shown while you hold.
the veilA curtain over the launcher, lifted by a drawn sigil or a rested finger.
star chartA backup file containing your whole sky.
my skyThe real night sky above your location, rendered as the background.
supernovaThe shockwave when a star launches.
ghostThe fading trace of your stroke after you lift.
directThe inbox for things other apps pin to your home screen.
zenith actionsThe optional assistive service that performs system actions.
26

quick reference

One card. If you print anything, print this.

Gestures

every gesture in the launcher
Do thisGet this
Hold empty skyA ring of stars blooms at your finger
Slide onto a star · liftOpens it
Rest on a folder starIts ring blooms around it
Trace back into the ring's heartFolds that ring shut
Lift on empty skyEverything dissolves
Slide onto · position · liftPlace 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 cornerSettings
Hold the lower-right cornerDeep Sky
Hold the upper-left cornerNotification shade
Hold the upper-right cornerLock screen
Flick up · flick downDeep Sky · notification shade
Double-tap the skyLock screen
Draw a quick circleStar Index
Draw a sigil, fastCasts that talisman
Hold a drifting cometCatch it — open · dismiss · snooze
Two fingers on the sky goldPinch, pan and twist My Sky · three fingers recentre

Defaults worth knowing

out of the box
SettingDefault
Modeicon mode (rings)
Regions1 — the whole screen
Hold delay220 ms
Folder dwell330 ms
Orbit radius · star size150 dp · 26 dp
Labelson hover
Theme · backgroundclean · black
Clock · dateon · on, top centre
Weather · battery · next eventoff
Cometson (needs notification access)
Sky veiloff
Soundoff
Orientationportrait
Everything in accessibilityoff

Where to find things

settings paths
To change…Go to
Colours, wallpaper, icon pack, star stylesettings › background & light
Ring size, star size, labels, effects, hold delaysettings › rings & effects
What corners, edges, flicks and double-tap dosettings › gestures
Splitting the screen, all-apps triggerssettings › regions & star index
Clock, date, weather, battery, next eventsettings › sky overlays
Default launcher, status bar, Gold, veil, comets, hintssettings › system
Drawn sigilssettings › talismans
Backups, hidden apps, erasingsettings › star chart
Dwell, latched buttons, contrast, text size, timingssettings › accessibility
Separate complete setupssettings › skies (main page)
zenith launcher handbook· build b0.8· developed by black syntax· published by friend castle· [email protected]· privacy· zenith.blacksyntax.com