Quick Start Guide: Difference between revisions

Latest revision as of 21:10, 19 April 2026

Welcome to AsteroidOS! This guide will help you get set up after a successful installation. For a full reference of the UI and system features, see the links in the What's next section below.

Initial setup

After booting your watch for the first time you will be guided through a quick setup:

Set your language, time, date, and timezone — adjust these as prompted.
Intro slideshow — a non-interactive slideshow introduces the swipe gestures and UI. Once it finishes you will land on the watchface homescreen. You can skip it at any point with a long press on the on-screen next button.

Navigating the UI

AsteroidOS is controlled entirely by swipe gestures. Swipe down from the watchface to open the Quick Settings panel, swipe up to open the App Launcher, swipe left for notifications, and swipe right for the Agenda and Weather panels. Inside any app, swipe from the left edge to go back and swipe from the top to close the app and return to the watchface.

See the Interface Overview page for a full description of all gestures including the peek gesture.

Syncing with your phone

AsteroidOS can sync with your phone using community-built apps.

Android — [AsteroidOSSync] provides the best overall experience. [Gadgetbridge] is also compatible and known for a very stable connection.
iOS — Notifications can be received by pairing with an iPhone. Time and weather sync are not currently supported.
Ubuntu Touch and SailfishOS — Partial support via [Amazfish].
Linux desktop — [Buran], [AsteroidOSLinux], and [asteroid-ctrl] are available. Amazfish is also available via [Flathub].

Full details are on the Synchronization Clients page.

Connecting to your watch

To install apps, update the system, or run commands, connect your computer to the watch via USB. Enable ADB or SSH in Settings > USB, then follow the SSH and IP Connection guides to establish a connection.

With a connection established you can update AsteroidOS with:

opkg update && opkg upgrade

And install apps with:

opkg install name-of-the-app

What's next

Interface Overview — full gesture reference and navigation model
Quick Settings Panel — what each toggle in the Quick Settings panel does
Settings Reference — a description of every settings page and option
Applications — stock and community apps available for AsteroidOS
Synchronization Clients — phone and desktop sync options in detail
Frequently Asked Questions (FAQ) — common questions and known limitations

Hack, tinker, contribute

AsteroidOS is built by enthusiasts for enthusiasts. Whether you want to write your own apps in QML/Qt, create watchfaces, or contribute code, everything is open. Explore the source, report issues, or get involved at [github.com/AsteroidOS].

Join the community

Join us on Matrix at [#Asteroid:matrix.org] — questions, progress sharing, and smartwatch hacking chat all welcome.

@@ Line 6: / Line 6: @@
 # '''Set your language, time, date, and timezone''' — adjust these as prompted.
-# '''Intro slideshow''' — a non-interactive slideshow introduces the swipe gestures and UI. Once it finishes you will land on the watchface homescreen. You can skip it at any point with a long press on the next button.
+# '''Intro slideshow''' — a non-interactive slideshow introduces the swipe gestures and UI. Once it finishes you will land on the watchface homescreen. You can skip it at any point with a long press on the on-screen next button.
 == Navigating the UI ==
@@ Line 41: / Line 41: @@
 * [[Interface Overview]] — full gesture reference and navigation model
 * [[Quick Settings Panel]] — what each toggle in the Quick Settings panel does
-* [[Settings Reference]] — a description of every settings page and option
+* [[Settings Pages|Settings Reference]] — a description of every settings page and option
 * [[Applications]] — stock and community apps available for AsteroidOS
 * [[Synchronization Clients]] — phone and desktop sync options in detail