AsteroidOS - User contributions [en]

SSH

2026-04-20T09:23:18Z

Mosen: Reorder hierarchy on SSH page

By default, you can get a remote shell on you smartwatch with SSH over RNDIS. On some smartwatches, it is also possible to use SSH with Wi-Fi.

== SSH over USB ==
USB Moded already set up udhcpd so that your watch gets the 192.168.2.15 IP address on its rndis interface. You can then connect to your watch from your computer with the following command:
<pre>
ssh ceres@192.168.2.15
</pre>
If your computer does not automatically get an IP address for its rndis interface, you might need to run this first:
<pre>
sudo dhclient -v enp0s20f0u8
</pre>

== SSH over WiFi ==

Dropbear is already running on the watch so we just need to configure an IP address to connect to.
The [[IP Connection]] page describes how to set up Wi-Fi.
Once the setup is done, you can look for the IP address your Router assigned via DHCP, with
<pre># ip a show dev wlan0</pre>.

== Troubleshooting SSH ==

* Using SCP/SSH results in a <code>REMOTE HOST IDENTIFICATION HAS CHANGED!</code> warning
** This means that there is already a different device known with the same IP adress. This happens if you reinstall AsteroidOS or you use multiple watches. The warning can be resolved by removing the record of the IP adress from the list of known hosts as follows:
<pre>ssh-keygen -R 192.168.2.15</pre>

----
= ADB =

Some watches have a known issue with the SSH implementation that prevents a working SSH connection. On these devices, ADB (Android Debug Bridge) is the only available shell access method.

ADB can also be used as a straightforward alternative to SSH on any supported watch, and provides equivalent root shell access.

== Enabling ADB ==

ADB and SSH are both enabled and disabled individually in '''Settings > USB'''. Selecting '''Charging only''' disables both. The toggle takes effect immediately without a restart.

== Connecting ==

With ADB enabled and the watch connected over USB, open a shell with:

<pre>adb shell</pre>

This gives you a root shell equivalent to <code>ssh root@192.168.2.15</code>.

== Multiple watches ==

When more than one watch is connected, ADB assigns each device a port. List all connected devices and their ports with:

<pre>adb devices</pre>

Connect to a specific watch by passing its port with the <code>-s</code> flag:

<pre>adb -s <port> shell</pre>

SSH

2026-04-20T09:19:15Z

Mosen: Add ADB section

By default, you can get a remote shell on you smartwatch with SSH over RNDIS. On some smartwatches, it is also possible to use SSH with Wi-Fi.

= SSH over USB =
USB Moded already set up udhcpd so that your watch gets the 192.168.2.15 IP address on its rndis interface. You can then connect to your watch from your computer with the following command:
<pre>
ssh ceres@192.168.2.15
</pre>
If your computer does not automatically get an IP address for its rndis interface, you might need to run this first:
<pre>
sudo dhclient -v enp0s20f0u8
</pre>

= SSH over WiFi =

Dropbear is already running on the watch so we just need to configure an IP address to connect to.
The [[IP Connection]] page describes how to set up Wi-Fi.
Once the setup is done, you can look for the IP address your Router assigned via DHCP, with
<pre># ip a show dev wlan0</pre>.

= Troubleshooting =

* Using SCP/SSH results in a <code>REMOTE HOST IDENTIFICATION HAS CHANGED!</code> warning
** This means that there is already a different device known with the same IP adress. This happens if you reinstall AsteroidOS or you use multiple watches. The warning can be resolved by removing the record of the IP adress from the list of known hosts as follows:
<pre>ssh-keygen -R 192.168.2.15</pre>

= ADB =

Some watches have a known issue with the SSH implementation that prevents a working SSH connection. On these devices, ADB (Android Debug Bridge) is the only available shell access method.

ADB can also be used as a straightforward alternative to SSH on any supported watch, and provides equivalent root shell access.

== Enabling ADB ==

ADB and SSH are both enabled and disabled individually in '''Settings > USB'''. Selecting '''Charging only''' disables both. The toggle takes effect immediately without a restart.

== Connecting ==

With ADB enabled and the watch connected over USB, open a shell with:

<pre>adb shell</pre>

This gives you a root shell equivalent to <code>ssh root@192.168.2.15</code>.

== Multiple watches ==

When more than one watch is connected, ADB assigns each device a port. List all connected devices and their ports with:

<pre>adb devices</pre>

Connect to a specific watch by passing its port with the <code>-s</code> flag:

<pre>adb -s <port> shell</pre>

Documentation

2026-04-20T09:14:45Z

Mosen: /* Connectivity and sync */ Rename SSH to SSH and ADB Access to prepare ADB description addition

__NOTOC__
* [[Code of Conduct]]
* [[:Category:Watches|Watches]]
* [[Watch Feature List]]
* [[Watch Support Level|Watch Support Level Rating System]]

----
=== For Users: ===

==== Before you install ====
* [[Frequently Asked Questions (FAQ)]]

==== Getting started ====
* [[Finding a Watch|Finding and identifying a Watch]]
* [[Quick Start Guide]]

==== Using AsteroidOS ====
* [[Interface Overview|User Interface Overview]]
* [[Quick Settings Panel]]
* [[Settings Pages]]
* [[Applications]]

==== Connectivity and sync ====
* [[Synchronization Clients]]
* [[SSH|SSH and ADB Access]]
* [[IP Connection]]

==== Managing your watch ====
* [[Watchface and Package Installation]]
* [[Updating AsteroidOS]]
* [[Backup Guide]]

==== Reference ====
* [[Useful Commands]]
* [[Translating AsteroidOS]]
* [[Licenses]]

----
=== For Developers: ===
* [[Contributors Agreement]]
* [[Contributing Guidelines]]
* [[Building AsteroidOS]]
* [[Building the SDK]]
* [[Installing the SDK]]
* [[Creating an Asteroid app]]
* [[Debugging Applications]]
* [[Creating a Watchface]]
* [[Emulator]]
* [[Local version of asteroidos.org]]
* [[Bluetooth]]
* [[BLE profiles]]

----
===For Porters:===
* [[Porting Status]]
* [[Porting Guide]]
* [[OpenEmbedded]]
* [[Boot Process]]
* [[Graphic Stack]]
* [[Technical Details of AsteroidOS Watches]]

Documentation

2026-04-20T09:07:58Z

Mosen: /* Connectivity and sync */ Reorder sync section

__NOTOC__
* [[Code of Conduct]]
* [[:Category:Watches|Watches]]
* [[Watch Feature List]]
* [[Watch Support Level|Watch Support Level Rating System]]

----
=== For Users: ===

==== Before you install ====
* [[Frequently Asked Questions (FAQ)]]

==== Getting started ====
* [[Finding a Watch|Finding and identifying a Watch]]
* [[Quick Start Guide]]

==== Using AsteroidOS ====
* [[Interface Overview|User Interface Overview]]
* [[Quick Settings Panel]]
* [[Settings Pages]]
* [[Applications]]

==== Connectivity and sync ====
* [[Synchronization Clients]]
* [[SSH]]
* [[IP Connection]]

==== Managing your watch ====
* [[Watchface and Package Installation]]
* [[Updating AsteroidOS]]
* [[Backup Guide]]

==== Reference ====
* [[Useful Commands]]
* [[Translating AsteroidOS]]
* [[Licenses]]

----
=== For Developers: ===
* [[Contributors Agreement]]
* [[Contributing Guidelines]]
* [[Building AsteroidOS]]
* [[Building the SDK]]
* [[Installing the SDK]]
* [[Creating an Asteroid app]]
* [[Debugging Applications]]
* [[Creating a Watchface]]
* [[Emulator]]
* [[Local version of asteroidos.org]]
* [[Bluetooth]]
* [[BLE profiles]]

----
===For Porters:===
* [[Porting Status]]
* [[Porting Guide]]
* [[OpenEmbedded]]
* [[Boot Process]]
* [[Graphic Stack]]
* [[Technical Details of AsteroidOS Watches]]

Documentation

2026-04-20T09:02:26Z

Mosen: /* Getting started */ Make new page titles more descriptive

__NOTOC__
* [[Code of Conduct]]
* [[:Category:Watches|Watches]]
* [[Watch Feature List]]
* [[Watch Support Level|Watch Support Level Rating System]]

----
=== For Users: ===

==== Before you install ====
* [[Frequently Asked Questions (FAQ)]]

==== Getting started ====
* [[Finding a Watch|Finding and identifying a Watch]]
* [[Quick Start Guide]]

==== Using AsteroidOS ====
* [[Interface Overview|User Interface Overview]]
* [[Quick Settings Panel]]
* [[Settings Pages]]
* [[Applications]]

==== Connectivity and sync ====
* [[IP Connection]]
* [[SSH]]
* [[Synchronization Clients]]

==== Managing your watch ====
* [[Watchface and Package Installation]]
* [[Updating AsteroidOS]]
* [[Backup Guide]]

==== Reference ====
* [[Useful Commands]]
* [[Translating AsteroidOS]]
* [[Licenses]]

----
=== For Developers: ===
* [[Contributors Agreement]]
* [[Contributing Guidelines]]
* [[Building AsteroidOS]]
* [[Building the SDK]]
* [[Installing the SDK]]
* [[Creating an Asteroid app]]
* [[Debugging Applications]]
* [[Creating a Watchface]]
* [[Emulator]]
* [[Local version of asteroidos.org]]
* [[Bluetooth]]
* [[BLE profiles]]

----
===For Porters:===
* [[Porting Status]]
* [[Porting Guide]]
* [[OpenEmbedded]]
* [[Boot Process]]
* [[Graphic Stack]]
* [[Technical Details of AsteroidOS Watches]]

Interface Overview

2026-04-20T08:51:53Z

Mosen: /* Display blanking */ Add palm to sleep and power button mention

AsteroidOS uses swipe gestures as its primary navigation method. There are no on-screen navigation buttons — everything is controlled from the touchscreen.

== The watchface homescreen ==

The watchface homescreen is the home base of the UI. It displays your active watchface and is the starting point for all navigation. You return here by swiping down from the top edge of any open app.

== Homescreen swipe gestures ==

{| class="wikitable"
! Direction !! Action
|-
| Swipe from top || Opens the Quick Settings panel
|-
| Swipe from bottom || Opens the App Launcher
|-
| Swipe from left || Shows the Notifications panel
|-
| Swipe from right || Shows the Agenda and Weather panels
|}

== In-app navigation ==

'''Swipe from the left edge toward the right''' to go back — either to the previous page within an app, or to the App Launcher if you are already on the app's main screen. This is the universal back gesture across all AsteroidOS apps.

'''Swipe from the top edge downward''' from within any app to close it and return to the watchface homescreen.

== The peek gesture ==

Gestures do not have to be completed. You can swipe partway and then reverse direction. For example:

Start a downward swipe from within an app to begin closing it. Stop halfway to see the watchface behind it, then reverse the swipe to return to the app without closing it.

This is particularly useful when selecting a watchface or wallpaper in Settings — you can peek at the homescreen to preview your selection without leaving the settings page.

== Display blanking ==

=== Automatic ===

After approximately 10 seconds of inactivity the display shuts off and the watch goes to sleep, showing the Always-On Display if it is enabled.

You can extend the active period by tapping the screen as the display begins to dim. Each tap before blanking doubles the timeout. After five consecutive extensions the screen stays on indefinitely and must be dismissed manually.

Some apps — including Flashlight and games — prevent blanking automatically while in active use. These apps must be explicitly closed to avoid unattended battery drain.

=== Manual ===

Two gestures immediately put the watch to sleep regardless of the current timeout state:

* '''Power button''' — if your watch has a physical button, pressing it forces the display off instantly.
* '''Palm-to-sleep''' — covering the display with your palm blocks the ambient light sensor and triggers immediate sleep. This is always active on watches equipped with a light sensor and cannot be disabled.

Interface Overview

2026-04-20T08:46:42Z

Mosen: Add display blanking section

AsteroidOS uses swipe gestures as its primary navigation method. There are no on-screen navigation buttons — everything is controlled from the touchscreen.

== The watchface homescreen ==

The watchface homescreen is the home base of the UI. It displays your active watchface and is the starting point for all navigation. You return here by swiping down from the top edge of any open app.

== Homescreen swipe gestures ==

{| class="wikitable"
! Direction !! Action
|-
| Swipe from top || Opens the Quick Settings panel
|-
| Swipe from bottom || Opens the App Launcher
|-
| Swipe from left || Shows the Notifications panel
|-
| Swipe from right || Shows the Agenda and Weather panels
|}

== In-app navigation ==

'''Swipe from the left edge toward the right''' to go back — either to the previous page within an app, or to the App Launcher if you are already on the app's main screen. This is the universal back gesture across all AsteroidOS apps.

'''Swipe from the top edge downward''' from within any app to close it and return to the watchface homescreen.

== The peek gesture ==

Gestures do not have to be completed. You can swipe partway and then reverse direction. For example:

Start a downward swipe from within an app to begin closing it. Stop halfway to see the watchface behind it, then reverse the swipe to return to the app without closing it.

This is particularly useful when selecting a watchface or wallpaper in Settings — you can peek at the homescreen to preview your selection without leaving the settings page.

== Display blanking ==

After approximately 10 seconds of inactivity the display shuts off and the watch goes to sleep, showing the Always-On Display if it is enabled.

You can extend the active period by tapping the screen as the display begins to dim. Each tap before blanking doubles the timeout. After five consecutive extensions the screen stays on indefinitely and must be dismissed manually by pressing the button or closing the app.

Some apps — including Flashlight and games — prevent blanking automatically while in active use. These apps must be explicitly closed to avoid unattended battery drain.

Quick Start Guide

2026-04-20T08:29:45Z

Mosen: /* Syncing with your phone */ correcting github availability

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''' — [[https://f-droid.org/packages/nodomain.freeyourgadget.gadgetbridge Gadgetbridge]] provides the best overall experience. [[https://f-droid.org/packages/org.asteroidos.sync AsteroidOSSync]] is also available but known for an unstable stable connection on newer Android versions.
* '''iOS''' — Notifications can be received by pairing with an iPhone. Time and weather sync are not currently supported.
* '''Ubuntu Touch and SailfishOS''' — Good support via [[https://open-store.io/app/uk.co.piggz.amazfish Amazfish]].
* '''Linux desktop''' — Amazfish is also available via [[https://flathub.org/apps/uk.co.piggz.amazfish Flathub]]. [[https://github.com/dodoradio/Buran Buran]], [[https://github.com/atx/AsteroidOSLinux AsteroidOSLinux]], and [[https://github.com/AsteroidOS/asteroid-ctrl asteroid-ctrl]] are available Github.

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:

<code>opkg update && opkg upgrade</code>

And install apps with:

<code>opkg install name-of-the-app</code>

== What's next ==

* [[Interface Overview]] — full gesture reference and navigation model
* [[Quick Settings Panel]] — what each toggle in the Quick Settings panel does
* [[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
* [[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 [[https://github.com/AsteroidOS github.com/AsteroidOS]].

=== Join the community ===

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

Quick Start Guide

2026-04-20T08:28:55Z

Mosen: /* Syncing with your phone */ Correct Sync clients order

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''' — [[https://f-droid.org/packages/nodomain.freeyourgadget.gadgetbridge Gadgetbridge]] provides the best overall experience. [[https://f-droid.org/packages/org.asteroidos.sync AsteroidOSSync]] is also available but known for an unstable stable connection on newer Android versions.
* '''iOS''' — Notifications can be received by pairing with an iPhone. Time and weather sync are not currently supported.
* '''Ubuntu Touch and SailfishOS''' — Good support via [[https://open-store.io/app/uk.co.piggz.amazfish Amazfish]].
* '''Linux desktop''' — Amazfish is also available via [[https://flathub.org/apps/uk.co.piggz.amazfish Flathub]]. [[https://github.com/dodoradio/Buran Buran]], [[https://github.com/atx/AsteroidOSLinux AsteroidOSLinux]], and [[https://github.com/AsteroidOS/asteroid-ctrl asteroid-ctrl]] are available on the projects Github.

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:

<code>opkg update && opkg upgrade</code>

And install apps with:

<code>opkg install name-of-the-app</code>

== What's next ==

* [[Interface Overview]] — full gesture reference and navigation model
* [[Quick Settings Panel]] — what each toggle in the Quick Settings panel does
* [[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
* [[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 [[https://github.com/AsteroidOS github.com/AsteroidOS]].

=== Join the community ===

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

Contributing Guidelines

2026-04-20T08:22:38Z

Mosen: /* Before you start */ Remove IRC mention

= Who this is for =
Anyone submitting code, documentation, watchfaces, translations, or other contributions to any AsteroidOS repository, whether you are a first-time contributor or a regular one.

= Before you start =
Read the [[Contributors Agreement|contributors agreement.]]

It is short and covers licensing, copyright, and the project's independence from commercial interests. If you are unsure whether your contribution fits the project or how to approach a problem technically, ask first. The Matrix room is the right place. Nobody has ever been turned away for asking a basic question early. Asking late, after submitting something that needs significant rework, costs everyone more time.

= Patience and mutual respect =
Everyone involved in AsteroidOS — contributors and maintainers alike — is giving their free time. There are zero expectations on review or development timelines in either direction. Do not pressure maintainers for reviews, and do not pressure contributors for updates. Life happens, things take as long as they take, and that is completely fine. If a PR sits without movement for a while, a single polite ping after a reasonable wait is always welcome. Repeated pressure is not.

= Submitting a pull request =
One concern per PR. If you are fixing a bug and also cleaning up whitespace, those are two separate commits at minimum and potentially two PRs. Reviewers should be able to understand and approve each change independently.

Write commit messages that explain why, not just what. "Fix timer reset" is less useful than "Reset timer on visibility change to prevent stale state on re-entry". The diff shows what changed; the message should explain the reasoning.

AsteroidOS uses a two-eyes principle: every merge requires review by at least one maintainer who did not author the change. If your PR is a work in progress, mark it as a draft. Do not ask for review on unfinished code. Reference any related issue in the PR description.

= Using AI and LLM tools =
AsteroidOS welcomes contributors who use AI coding assistants. We ask for transparency so reviewers can give useful feedback.

State in your PR description that you used an LLM tool and name it (e.g. "drafted with Claude" or "written with Copilot"). Include or link the context and key prompts you used, a gist is fine. This helps reviewers identify systematic pattern issues and improve the project's own LLM context resources rather than leaving the same feedback repeatedly.

Explain how you validated the output. At minimum this means you reviewed the code and design yourself and tested it by building and running it on a device or emulator. Submitting LLM output that has not been built, run, or reasoned about independently damages trust in the same way that submitting any other untested or unjustified change does. You are responsible for what you submit.

Do not paste LLM-generated text into Matrix or GitHub discussions. Write in your own words. Reviewers notice, and it damages trust in ways that are hard to recover from. If you are uncertain whether your understanding is correct, say so. "I think this is right but I'm not sure" is always a better opening than presenting guesswork as fact.

= If your PR is rejected or needs changes =
Rejection is feedback, not judgement. If a reviewer asks for changes or closes a PR, they will explain why. If the explanation is unclear, ask for clarification in the PR thread. If you disagree with a review decision, say so in the thread with your reasoning. Maintainers are not infallible and have changed their minds before.

Documentation

2026-04-20T08:17:29Z

Mosen: /* Getting started */ Add Finding a Watch page

__NOTOC__
* [[Code of Conduct]]
* [[:Category:Watches|Watches]]
* [[Watch Feature List]]
* [[Watch Support Level|Watch Support Level Rating System]]

----
=== For Users: ===

==== Before you install ====
* [[Frequently Asked Questions (FAQ)]]

==== Getting started ====
* [[Finding a Watch]]
* [[Quick Start Guide]]

==== Using AsteroidOS ====
* [[Interface Overview]]
* [[Quick Settings Panel]]
* [[Settings Pages]]
* [[Applications]]

==== Connectivity and sync ====
* [[IP Connection]]
* [[SSH]]
* [[Synchronization Clients]]

==== Managing your watch ====
* [[Watchface and Package Installation]]
* [[Updating AsteroidOS]]
* [[Backup Guide]]

==== Reference ====
* [[Useful Commands]]
* [[Translating AsteroidOS]]
* [[Licenses]]

----
=== For Developers: ===
* [[Contributors Agreement]]
* [[Contributing Guidelines]]
* [[Building AsteroidOS]]
* [[Building the SDK]]
* [[Installing the SDK]]
* [[Creating an Asteroid app]]
* [[Debugging Applications]]
* [[Creating a Watchface]]
* [[Emulator]]
* [[Local version of asteroidos.org]]
* [[Bluetooth]]
* [[BLE profiles]]

----
===For Porters:===
* [[Porting Status]]
* [[Porting Guide]]
* [[OpenEmbedded]]
* [[Boot Process]]
* [[Graphic Stack]]
* [[Technical Details of AsteroidOS Watches]]

Finding a Watch

2026-04-20T08:14:39Z

Mosen: Add initial state of Finding a Watch page

AsteroidOS runs on a selection of smartwatches, most of which are no longer in production. The best place to find a supported model is the used market — online auction sites, secondhand electronics shops, and classified listings are all good sources. Prices are generally low given the age of the hardware.

When buying secondhand, prefer a watch with an intact and functional battery. Battery health cannot be easily assessed from a listing, but watches described as having seen light use or that come from non-smoker households are generally safer bets. A degraded battery will significantly reduce runtime even on a fresh AsteroidOS install.

== Identifying your watch ==

Before flashing, confirm you have a supported model and know its exact codename — the install instructions differ per device.

The easiest method is to compare your watch visually against the pictures on the [[https://asteroidos.org/watches/ Watches page]]. Most models are visually distinct enough to identify by shape, button placement, and bezel style.

If you are unsure after comparing pictures, you can read the codename directly from the watch by entering the fastboot bootloader:

# Power off the watch.
# Check if a manual button combination described on the [[Useful Commands]] page works to bring your watch into fastboot mode.
# Alternatively, follow the install instructions for any watch up to the bootloader unlock step.
# The device codename is displayed on screen.

Match that codename against the [[https://asteroidos.org/watches/ Watches page]] to confirm support level and find the correct install instructions.

== Flashing AsteroidOS ==

Follow the install instructions for your specific watch closely. Some devices differ in procedure and partition layout — steps that apply to one watch may not work on another.

If you run into problems during flashing or first boot, the Matrix chat at [[https://matrix.to/#/#Asteroid:matrix.org #Asteroid:matrix.org]] is the fastest place to get help. The community is friendly and experienced with the supported devices.

Once your watch is running AsteroidOS, continue with the [[Quick Start Guide]].

Quick Settings Panel

2026-04-19T21:25:59Z

Mosen: Correct typos

The Quick Panel gives you fast access to the most common system controls without opening the Settings app. Swipe down from the top edge of the watchface to open it.

The panel has two rows of controls:

* '''Fixed row''' — holds up to two high-priority toggles or buttons, always visible without scrolling.
* '''Sliding row''' — holds additional toggles organized into pages of three. Swipe left and right to move between pages.

A meter at the center of the panel shows battery charge by default. Pressing and holding the brightness or volume toggles adjusts their values in steps rather than toggling — brightness in steps of 10 (minimum 10% to prevent a blank screen), volume linearly from 0 to 100%.

The order and visibility of toggles in the sliding row is configurable. Open Settings > Quick Panel to drag toggles into your preferred order or enable and disable them individually. Toggles marked as unavailable on your hardware appear at the bottom of the list and cannot be moved.

== Toggles ==

=== Wi-Fi ===
Enables or disables the Wi-Fi radio. Wi-Fi is required for over-the-air updates, installing packages via <code>opkg</code>, and any sync client that communicates over IP rather than Bluetooth. Disabling Wi-Fi when not in use is one of the most effective ways to extend battery life.

=== Bluetooth ===
Enables or disables the Bluetooth radio. Bluetooth is required for phone sync via AsteroidOSSync and Gadgetbridge. Disabling Bluetooth disconnects any active sync session immediately.

=== Brightness ===
Tap to toggle between full brightness and a reduced level. Press and hold to step brightness up or down in increments of 10%, with a minimum of 10% to keep the display visible.

=== Sound ===
Tap to mute or unmute system audio. Press and hold to adjust volume in steps from 0 to 100%. Only available on watches with a speaker.

=== Haptics ===
Enables or disables vibration feedback for notifications and system events.

=== Always-On Display (AoD) ===

Toggles the Always-On Display watchface that keeps the screen active at reduced power between interactions.

Behaviour varies significantly by display hardware:

* '''OLED displays''' — AoD is power-efficient. The screen dims to a minimal watchface that updates once per minute. This is the intended use case for AoD.
* '''LCD displays''' — AoD keeps the backlight on continuously and has a high battery cost. It is not recommended for daily use on LCD watches.
* '''Watches with a secondary display''' (e.g. TicWatch Pro series) — AoD on the primary OLED panel is redundant, as the secondary always-on LCD provides the same function at no cost to the primary display. Disabling AoD on these watches leaves timekeeping to the secondary panel, which is the recommended configuration.

AoD is automatically disabled when Cinema Mode is active and restored when Cinema Mode is deactivated.

=== Cinema Mode ===
Silences the watch for use in quiet environments. When activated, Cinema Mode:

* mutes all audio output
* sets display brightness to 10%
* disables the Always-On Display

All three values are restored to their pre-cinema state when Cinema Mode is deactivated. The 10% brightness minimum means the display remains readable if you need to check the time without the watch making noise or lighting up a dark room.

Cinema Mode ships disabled by default and must be enabled in Settings > Quick Settings to appear in the sliding row.

=== Power Off ===
Shuts down the watch. A 3-second cancellable confirmation timer runs before the shutdown executes, preventing accidental activation.

=== Reboot ===
Restarts the watch. The same 3-second cancellable confirmation applies.

=== Music (optional) ===
Opens the Music app directly from the panel. Disabled by default — enable in Settings > Quick Settings if you frequently use the watch as a remote control for phone playback.

=== Flashlight (optional) ===
Opens the Flashlight app, turning the screen white for use as a torch. Disabled by default.

== Configuring the panel ==

Open Settings > Quick Panel to:

* reorder toggles in the sliding row by dragging
* enable or disable individual toggles
* choose whether the battery meter appears above or below the sliding row
* select the particle animation style shown on the battery meter

Settings Pages

2026-04-19T21:23:31Z

Mosen: /* Quick Settings */ correct typo

Open Settings from the App Launcher (swipe up from the watchface, tap the gear icon) or from the Quick Settings panel (swipe down from the watchface, tap the gear icon). All changes take effect immediately — there is no save button.

To preview a change on the watchface without leaving Settings, start a downward swipe from the top of the screen to peek at the homescreen, then reverse the swipe to return.

== Display ==

* '''Brightness''' — Set the display brightness using the scrubber, or tap the plus and minus buttons at either end of the scrubber track to increment or decrement by 10.
* '''Automatic Brightness''' — Enables automatic brightness adjustment based on ambient light.
* '''Always-On Display (AoD)''' — See the [[Quick Settings Panel]] page for a full description of AoD and its display-type-specific behaviour. This toggle controls the same setting.
* '''Burn-in Protection''' — Periodically shifts the AoD watchface to prevent OLED pixel wear. Available levels are High, Mid, Low, and Off. Recommended for any OLED watch using AoD regularly. The shift may look like a bug — it is intentional.
* '''Tilt-to-Wake''' — Wakes the display from AoD when you tilt your wrist toward you. Has a notable battery cost due to frequent accidental triggers. Disable unless you find waking the display by button press inconvenient.
* '''Tap-to-Wake''' — Wakes the display from AoD on a tap of the screen.

== Nightstand ==

Nightstand mode activates automatically when the watch is placed on a charger. It shows a charging ring for at-a-glance charge status and switches to a simplified large-time watchface for use as a bedside clock.

* '''Enabled''' — Toggles the Nightstand feature on or off.
* '''Brightness''' — Sets the display brightness while Nightstand is active. Adjust using the scrubber or the plus and minus buttons.
* '''Delay''' — How long after removal from the charger before Nightstand mode deactivates.
* '''Always-On Display''' — Toggles AoD while Nightstand is active.
* '''Custom Watchface''' — When enabled, reveals a watchface selector below. The chosen watchface is shown exclusively during Nightstand mode, leaving your regular watchface unaffected.

== Quick Panel ==

Configures the layout and appearance of the Quick Settings panel. Drag toggles to reorder them in the sliding row. Tap a toggle to enable or disable its appearance in the panel. See the [[Quick Settings Panel]] page for descriptions of each individual toggle.

Options at the bottom of the page:

* '''Battery meter at bottom''' — Enabled by default. Uncheck to mirror the layout and place the battery meter above the sliding row instead.
* '''Colored battery fill''' — Shows the battery meter fill in colour, transitioning from green at full charge to red at low charge.
* '''Battery fill animations''' — Enables particle animations inside the battery meter.
* '''Particle design''' — Tap to cycle through the available particle styles: diamonds, bubbles, AsteroidOS logos, and flashes.

== Wallpaper ==

A two-column gallery of wallpapers sorted by hue, mirroring the rainbow progression of the App Launcher. Wallpapers become progressively brighter and more colourful toward the bottom of the gallery. Tap a wallpaper to select it. Peek to the homescreen by swiping down from the top to see the change instantly without leaving the page.

== Watchface ==

A gallery of 18 stock watchfaces covering a variety of designs and complications. The selected watchface is paired with your chosen wallpaper already in the gallery view. Peek to the homescreen to see the change instantly without leaving the page.

== Launcher ==

Select from seven App Launcher layouts:

* Large icons, horizontal scrolling, with rainbow FlatMesh progression
* Large icons, vertical scrolling, with rainbow FlatMesh progression
* Small icons, horizontal scrolling, with rainbow FlatMesh progression
* Two-column vertical icon list
* Turbo list launcher
* 3×3 icon grid
* Circular dial launcher

== Time ==

Set the current time using vertical spinner wheels for hours and minutes.

== Date ==

Set the current date using vertical spinner wheels for day, month, and year.

== Units ==

* '''12-hour format''' — Switches between 24-hour and 12-hour (AM/PM) time display.
* '''Fahrenheit''' — Switches temperature display between °C and °F in the Weather app and the events panel.

== Language ==

Select the system language using a vertical spinner.

== Time Zone ==

Select your time zone and nearest city using vertical spinners.

== Bluetooth ==

Toggle the Bluetooth radio on or off. For quick access without opening Settings, the same control is available in the [[Quick Settings Panel]].

== USB ==

Enables USB-based device access for maintenance tasks such as installing apps, running commands, and updating the system.

* '''ADB''' — Enables Android Debug Bridge access over USB.
* '''SSH''' — Enables SSH access over USB. See the [[SSH]] and [[IP Connection]] guides for instructions.
* Selecting '''Charging only''' disables both modes.

== Power ==

Provides shutdown and restart options. Tapping any option starts a 3-second remorse timer — the action executes automatically unless cancelled within that window.

* '''Power Off''' — Shuts down the watch.
* '''Reboot''' — Restarts the watch.
* '''Reboot to Bootloader''' — Restarts into fastboot mode for flashing.

== About ==

Displays system and hardware information for the current device:

* AsteroidOS version and build date
* Watch codename and hostname
* WLAN MAC address
* IMEI (if available)
* Total and available disk space
* Display resolution in pixels
* Kernel version
* Qt version
* System uptime
* Thread count
* 1, 5, and 15-minute load averages
* Total and free memory

Quick Start Guide

2026-04-19T21:10:42Z

Mosen: /* Connecting to your watch */ Correct Settings Pages link

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''' — [[https://f-droid.org/packages/org.asteroidos.sync AsteroidOSSync]] provides the best overall experience. [[https://f-droid.org/packages/nodomain.freeyourgadget.gadgetbridge 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 [[https://open-store.io/app/uk.co.piggz.amazfish Amazfish]].
* '''Linux desktop''' — [[https://github.com/dodoradio/Buran Buran]], [[https://github.com/atx/AsteroidOSLinux AsteroidOSLinux]], and [[https://github.com/AsteroidOS/asteroid-ctrl asteroid-ctrl]] are available. Amazfish is also available via [[https://flathub.org/apps/uk.co.piggz.amazfish 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:

<code>opkg update && opkg upgrade</code>

And install apps with:

<code>opkg install name-of-the-app</code>

== What's next ==

* [[Interface Overview]] — full gesture reference and navigation model
* [[Quick Settings Panel]] — what each toggle in the Quick Settings panel does
* [[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
* [[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 [[https://github.com/AsteroidOS github.com/AsteroidOS]].

=== Join the community ===

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

Documentation

2026-04-19T21:09:00Z

Mosen: /* Using AsteroidOS */ Correct Settings Pages link

__NOTOC__
* [[Code of Conduct]]
* [[:Category:Watches|Watches]]
* [[Watch Feature List]]
* [[Watch Support Level|Watch Support Level Rating System]]

----
=== For Users: ===

==== Before you install ====
* [[Frequently Asked Questions (FAQ)]]

==== Getting started ====
* [[Quick Start Guide]]

==== Using AsteroidOS ====
* [[Interface Overview]]
* [[Quick Settings Panel]]
* [[Settings Pages]]
* [[Applications]]

==== Connectivity and sync ====
* [[IP Connection]]
* [[SSH]]
* [[Synchronization Clients]]

==== Managing your watch ====
* [[Watchface and Package Installation]]
* [[Updating AsteroidOS]]
* [[Backup Guide]]

==== Reference ====
* [[Useful Commands]]
* [[Translating AsteroidOS]]
* [[Licenses]]

----
=== For Developers: ===
* [[Contributors Agreement]]
* [[Contributing Guidelines]]
* [[Building AsteroidOS]]
* [[Building the SDK]]
* [[Installing the SDK]]
* [[Creating an Asteroid app]]
* [[Debugging Applications]]
* [[Creating a Watchface]]
* [[Emulator]]
* [[Local version of asteroidos.org]]
* [[Bluetooth]]
* [[BLE profiles]]

----
===For Porters:===
* [[Porting Status]]
* [[Porting Guide]]
* [[OpenEmbedded]]
* [[Boot Process]]
* [[Graphic Stack]]
* [[Technical Details of AsteroidOS Watches]]

Documentation

2026-04-19T21:07:48Z

Mosen: Add separator lines above/below the 3 main sections

__NOTOC__
* [[Code of Conduct]]
* [[:Category:Watches|Watches]]
* [[Watch Feature List]]
* [[Watch Support Level|Watch Support Level Rating System]]

----
=== For Users: ===

==== Before you install ====
* [[Frequently Asked Questions (FAQ)]]

==== Getting started ====
* [[Quick Start Guide]]

==== Using AsteroidOS ====
* [[Interface Overview]]
* [[Quick Settings Panel]]
* [[Settings Reference]]
* [[Applications]]

==== Connectivity and sync ====
* [[IP Connection]]
* [[SSH]]
* [[Synchronization Clients]]

==== Managing your watch ====
* [[Watchface and Package Installation]]
* [[Updating AsteroidOS]]
* [[Backup Guide]]

==== Reference ====
* [[Useful Commands]]
* [[Translating AsteroidOS]]
* [[Licenses]]

----
=== For Developers: ===
* [[Contributors Agreement]]
* [[Contributing Guidelines]]
* [[Building AsteroidOS]]
* [[Building the SDK]]
* [[Installing the SDK]]
* [[Creating an Asteroid app]]
* [[Debugging Applications]]
* [[Creating a Watchface]]
* [[Emulator]]
* [[Local version of asteroidos.org]]
* [[Bluetooth]]
* [[BLE profiles]]

----
===For Porters:===
* [[Porting Status]]
* [[Porting Guide]]
* [[OpenEmbedded]]
* [[Boot Process]]
* [[Graphic Stack]]
* [[Technical Details of AsteroidOS Watches]]

Documentation

2026-04-19T21:04:44Z

Mosen: Remove redundant FAQ entry from top

__NOTOC__
* [[Code of Conduct]]
* [[:Category:Watches|Watches]]
* [[Watch Feature List]]
* [[Watch Support Level|Watch Support Level Rating System]]

=== For Users: ===

==== Before you install ====
* [[Frequently Asked Questions (FAQ)]]

==== Getting started ====
* [[Quick Start Guide]]

==== Using AsteroidOS ====
* [[Interface Overview]]
* [[Quick Settings Panel]]
* [[Settings Reference]]
* [[Applications]]

==== Connectivity and sync ====
* [[IP Connection]]
* [[SSH]]
* [[Synchronization Clients]]

==== Managing your watch ====
* [[Watchface and Package Installation]]
* [[Updating AsteroidOS]]
* [[Backup Guide]]

==== Reference ====
* [[Useful Commands]]
* [[Translating AsteroidOS]]
* [[Licenses]]

=== For Developers: ===
* [[Contributors Agreement]]
* [[Contributing Guidelines]]
* [[Building AsteroidOS]]
* [[Building the SDK]]
* [[Installing the SDK]]
* [[Creating an Asteroid app]]
* [[Debugging Applications]]
* [[Creating a Watchface]]
* [[Emulator]]
* [[Local version of asteroidos.org]]
* [[Bluetooth]]
* [[BLE profiles]]

===For Porters:===
* [[Porting Status]]
* [[Porting Guide]]
* [[OpenEmbedded]]
* [[Boot Process]]
* [[Graphic Stack]]
* [[Technical Details of AsteroidOS Watches]]

Documentation

2026-04-19T21:00:58Z

Mosen: Disable content overview generation

__NOTOC__
* [[Code of Conduct]]
* [[Frequently Asked Questions (FAQ)]]
* [[:Category:Watches|Watches]]
* [[Watch Feature List]]
* [[Watch Support Level|Watch Support Level Rating System]]

=== For Users: ===

==== Before you install ====
* [[Frequently Asked Questions (FAQ)]]

==== Getting started ====
* [[Quick Start Guide]]

==== Using AsteroidOS ====
* [[Interface Overview]]
* [[Quick Settings Panel]]
* [[Settings Reference]]
* [[Applications]]

==== Connectivity and sync ====
* [[IP Connection]]
* [[SSH]]
* [[Synchronization Clients]]

==== Managing your watch ====
* [[Watchface and Package Installation]]
* [[Updating AsteroidOS]]
* [[Backup Guide]]

==== Reference ====
* [[Useful Commands]]
* [[Translating AsteroidOS]]
* [[Licenses]]

=== For Developers: ===
* [[Contributors Agreement]]
* [[Contributing Guidelines]]
* [[Building AsteroidOS]]
* [[Building the SDK]]
* [[Installing the SDK]]
* [[Creating an Asteroid app]]
* [[Debugging Applications]]
* [[Creating a Watchface]]
* [[Emulator]]
* [[Local version of asteroidos.org]]
* [[Bluetooth]]
* [[BLE profiles]]

===For Porters:===
* [[Porting Status]]
* [[Porting Guide]]
* [[OpenEmbedded]]
* [[Boot Process]]
* [[Graphic Stack]]
* [[Technical Details of AsteroidOS Watches]]

Documentation

2026-04-19T20:42:01Z

Mosen: /* For Users: */ Add discovery progression groups to sort the user manual pages according to user discovery path.

* [[Code of Conduct]]
* [[Frequently Asked Questions (FAQ)]]
* [[:Category:Watches|Watches]]
* [[Watch Feature List]]
* [[Watch Support Level|Watch Support Level Rating System]]

=== For Users: ===

==== Before you install ====
* [[Frequently Asked Questions (FAQ)]]

==== Getting started ====
* [[Quick Start Guide]]

==== Using AsteroidOS ====
* [[Interface Overview]]
* [[Quick Settings Panel]]
* [[Settings Reference]]
* [[Applications]]

==== Connectivity and sync ====
* [[IP Connection]]
* [[SSH]]
* [[Synchronization Clients]]

==== Managing your watch ====
* [[Watchface and Package Installation]]
* [[Updating AsteroidOS]]
* [[Backup Guide]]

==== Reference ====
* [[Useful Commands]]
* [[Translating AsteroidOS]]
* [[Licenses]]

=== For Developers: ===
* [[Contributors Agreement]]
* [[Contributing Guidelines]]
* [[Building AsteroidOS]]
* [[Building the SDK]]
* [[Installing the SDK]]
* [[Creating an Asteroid app]]
* [[Debugging Applications]]
* [[Creating a Watchface]]
* [[Emulator]]
* [[Local version of asteroidos.org]]
* [[Bluetooth]]
* [[BLE profiles]]

===For Porters:===
* [[Porting Status]]
* [[Porting Guide]]
* [[OpenEmbedded]]
* [[Boot Process]]
* [[Graphic Stack]]
* [[Technical Details of AsteroidOS Watches]]

Quick Start Guide

2026-04-19T20:31:33Z

Mosen: Chop Quick Start Guide by the sections that moved to individual pages

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 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''' — [[https://f-droid.org/packages/org.asteroidos.sync AsteroidOSSync]] provides the best overall experience. [[https://f-droid.org/packages/nodomain.freeyourgadget.gadgetbridge 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 [[https://open-store.io/app/uk.co.piggz.amazfish Amazfish]].
* '''Linux desktop''' — [[https://github.com/dodoradio/Buran Buran]], [[https://github.com/atx/AsteroidOSLinux AsteroidOSLinux]], and [[https://github.com/AsteroidOS/asteroid-ctrl asteroid-ctrl]] are available. Amazfish is also available via [[https://flathub.org/apps/uk.co.piggz.amazfish 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:

<code>opkg update && opkg upgrade</code>

And install apps with:

<code>opkg install name-of-the-app</code>

== 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 [[https://github.com/AsteroidOS github.com/AsteroidOS]].

=== Join the community ===

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

Interface Overview

2026-04-19T20:28:08Z

Mosen: Add initial Version of Interface Overview page, chopped from the Quick Start uide

Documentation

2026-04-19T20:17:55Z

Mosen: Move Porting status from Users to Porters

* [[Code of Conduct]]
* [[Frequently Asked Questions (FAQ)]]
* [[:Category:Watches|Watches]]
* [[Watch Feature List]]
* [[Watch Support Level|Watch Support Level Rating System]]

=== For Users: ===
* [[Quick Start Guide]]
* [[Applications]]
* [[Synchronization Clients]]
* [[SSH]]
* [[Watchface and Package Installation]]
* [[Backup Guide]]
* [[IP Connection]]
* [[Useful Commands]]
* [[Updating AsteroidOS]]
* [[Translating AsteroidOS]]
* [[Licenses]]

=== For Developers: ===
* [[Contributors Agreement]]
* [[Contributing Guidelines]]
* [[Building AsteroidOS]]
* [[Building the SDK]]
* [[Installing the SDK]]
* [[Creating an Asteroid app]]
* [[Debugging Applications]]
* [[Creating a Watchface]]
* [[Emulator]]
* [[Local version of asteroidos.org]]
* [[Bluetooth]]
* [[BLE profiles]]

===For Porters:===
* [[Porting Status]]
* [[Porting Guide]]
* [[OpenEmbedded]]
* [[Boot Process]]
* [[Graphic Stack]]
* [[Technical Details of AsteroidOS Watches]]

Settings Pages

2026-04-19T20:09:27Z

Mosen: Add initial version of Settings Pages page

Open Settings from the App Launcher (swipe up from the watchface, tap the gear icon) or from the Quick Settings panel (swipe down from the watchface, tap the gear icon). All changes take effect immediately — there is no save button.

To preview a change on the watchface without leaving Settings, start a downward swipe from the top of the screen to peek at the homescreen, then reverse the swipe to return.

== Display ==

* '''Brightness''' — Set the display brightness using the scrubber, or tap the plus and minus buttons at either end of the scrubber track to increment or decrement by 10.
* '''Automatic Brightness''' — Enables automatic brightness adjustment based on ambient light.
* '''Always-On Display (AoD)''' — See the [[Quick Settings Panel]] page for a full description of AoD and its display-type-specific behaviour. This toggle controls the same setting.
* '''Burn-in Protection''' — Periodically shifts the AoD watchface to prevent OLED pixel wear. Available levels are High, Mid, Low, and Off. Recommended for any OLED watch using AoD regularly. The shift may look like a bug — it is intentional.
* '''Tilt-to-Wake''' — Wakes the display from AoD when you tilt your wrist toward you. Has a notable battery cost due to frequent accidental triggers. Disable unless you find waking the display by button press inconvenient.
* '''Tap-to-Wake''' — Wakes the display from AoD on a tap of the screen.

== Nightstand ==

Nightstand mode activates automatically when the watch is placed on a charger. It shows a charging ring for at-a-glance charge status and switches to a simplified large-time watchface for use as a bedside clock.

* '''Enabled''' — Toggles the Nightstand feature on or off.
* '''Brightness''' — Sets the display brightness while Nightstand is active. Adjust using the scrubber or the plus and minus buttons.
* '''Delay''' — How long after removal from the charger before Nightstand mode deactivates.
* '''Always-On Display''' — Toggles AoD while Nightstand is active.
* '''Custom Watchface''' — When enabled, reveals a watchface selector below. The chosen watchface is shown exclusively during Nightstand mode, leaving your regular watchface unaffected.

== Quick Settings ==

Configures the layout and appearance of the Quick Settings panel. Drag toggles to reorder them in the sliding row. Tap a toggle to enable or disable its appearance in the panel. See the [[Quick Settings Panel]] page for descriptions of each individual toggle.

Options at the bottom of the page:

* '''Battery meter at bottom''' — Enabled by default. Uncheck to mirror the layout and place the battery meter above the sliding row instead.
* '''Colored battery fill''' — Shows the battery meter fill in colour, transitioning from green at full charge to red at low charge.
* '''Battery fill animations''' — Enables particle animations inside the battery meter.
* '''Particle design''' — Tap to cycle through the available particle styles: diamonds, bubbles, AsteroidOS logos, and flashes.

== Wallpaper ==

A two-column gallery of wallpapers sorted by hue, mirroring the rainbow progression of the App Launcher. Wallpapers become progressively brighter and more colourful toward the bottom of the gallery. Tap a wallpaper to select it. Peek to the homescreen by swiping down from the top to see the change instantly without leaving the page.

== Watchface ==

A gallery of 18 stock watchfaces covering a variety of designs and complications. The selected watchface is paired with your chosen wallpaper already in the gallery view. Peek to the homescreen to see the change instantly without leaving the page.

== Launcher ==

Select from seven App Launcher layouts:

* Large icons, horizontal scrolling, with rainbow FlatMesh progression
* Large icons, vertical scrolling, with rainbow FlatMesh progression
* Small icons, horizontal scrolling, with rainbow FlatMesh progression
* Two-column vertical icon list
* Turbo list launcher
* 3×3 icon grid
* Circular dial launcher

== Time ==

Set the current time using vertical spinner wheels for hours and minutes.

== Date ==

Set the current date using vertical spinner wheels for day, month, and year.

== Units ==

* '''12-hour format''' — Switches between 24-hour and 12-hour (AM/PM) time display.
* '''Fahrenheit''' — Switches temperature display between °C and °F in the Weather app and the events panel.

== Language ==

Select the system language using a vertical spinner.

== Time Zone ==

Select your time zone and nearest city using vertical spinners.

== Bluetooth ==

Toggle the Bluetooth radio on or off. For quick access without opening Settings, the same control is available in the [[Quick Settings Panel]].

== USB ==

Enables USB-based device access for maintenance tasks such as installing apps, running commands, and updating the system.

* '''ADB''' — Enables Android Debug Bridge access over USB.
* '''SSH''' — Enables SSH access over USB. See the [[SSH]] and [[IP Connection]] guides for instructions.
* Selecting '''Charging only''' disables both modes.

== Power ==

Provides shutdown and restart options. Tapping any option starts a 3-second remorse timer — the action executes automatically unless cancelled within that window.

* '''Power Off''' — Shuts down the watch.
* '''Reboot''' — Restarts the watch.
* '''Reboot to Bootloader''' — Restarts into fastboot mode for flashing.

== About ==

Displays system and hardware information for the current device:

* AsteroidOS version and build date
* Watch codename and hostname
* WLAN MAC address
* IMEI (if available)
* Total and available disk space
* Display resolution in pixels
* Kernel version
* Qt version
* System uptime
* Thread count
* 1, 5, and 15-minute load averages
* Total and free memory

Quick Settings Panel

2026-04-19T14:21:02Z

Mosen: /* Quick Settings Panel */ Remove double header

The Quick Settings panel gives you fast access to the most common system controls without opening the Settings app. Swipe down from the top edge of the watchface to open it.

The panel has two rows of controls:

* '''Fixed row''' — holds up to two high-priority toggles or buttons, always visible without scrolling.
* '''Sliding row''' — holds additional toggles organised into pages of three. Swipe left and right to move between pages.

A meter at the centre of the panel shows battery charge by default. Pressing and holding the brightness or volume toggles adjusts their values in steps rather than toggling — brightness in steps of 10 (minimum 10% to prevent a blank screen), volume linearly from 0 to 100%.

The order and visibility of toggles in the sliding row is configurable. Open Settings > Quick Settings to drag toggles into your preferred order or enable and disable them individually. Toggles marked as unavailable on your hardware appear at the bottom of the list and cannot be moved.

== Toggles ==

=== Wi-Fi ===
Enables or disables the Wi-Fi radio. Wi-Fi is required for over-the-air updates, installing packages via <code>opkg</code>, and any sync client that communicates over IP rather than Bluetooth. Disabling Wi-Fi when not in use is one of the most effective ways to extend battery life.

=== Bluetooth ===
Enables or disables the Bluetooth radio. Bluetooth is required for phone sync via AsteroidOSSync and Gadgetbridge. Disabling Bluetooth disconnects any active sync session immediately.

=== Brightness ===
Tap to toggle between full brightness and a reduced level. Press and hold to step brightness up or down in increments of 10%, with a minimum of 10% to keep the display visible.

=== Sound ===
Tap to mute or unmute system audio. Press and hold to adjust volume in steps from 0 to 100%. Only available on watches with a speaker.

=== Haptics ===
Enables or disables vibration feedback for notifications and system events.

=== Always-On Display (AoD) ===

Toggles the Always-On Display watchface that keeps the screen active at reduced power between interactions.

Behaviour varies significantly by display hardware:

* '''OLED displays''' — AoD is power-efficient. The screen dims to a minimal watchface that updates once per minute. This is the intended use case for AoD.
* '''LCD displays''' — AoD keeps the backlight on continuously and has a high battery cost. It is not recommended for daily use on LCD watches.
* '''Watches with a secondary display''' (e.g. TicWatch Pro series) — AoD on the primary OLED panel is redundant, as the secondary always-on LCD provides the same function at no cost to the primary display. Disabling AoD on these watches leaves timekeeping to the secondary panel, which is the recommended configuration.

AoD is automatically disabled when Cinema Mode is active and restored when Cinema Mode is deactivated.

=== Cinema Mode ===
Silences the watch for use in quiet environments. When activated, Cinema Mode:

* mutes all audio output
* sets display brightness to 10%
* disables the Always-On Display

All three values are restored to their pre-cinema state when Cinema Mode is deactivated. The 10% brightness minimum means the display remains readable if you need to check the time without the watch making noise or lighting up a dark room.

Cinema Mode ships disabled by default and must be enabled in Settings > Quick Settings to appear in the sliding row.

=== Power Off ===
Shuts down the watch. A 3-second cancellable confirmation timer runs before the shutdown executes, preventing accidental activation.

=== Reboot ===
Restarts the watch. The same 3-second cancellable confirmation applies.

=== Music (optional) ===
Opens the Music app directly from the panel. Disabled by default — enable in Settings > Quick Settings if you frequently use the watch as a remote control for phone playback.

=== Flashlight (optional) ===
Opens the Flashlight app, turning the screen white for use as a torch. Disabled by default.

== Configuring the panel ==

Open Settings > Quick Panel to:

* reorder toggles in the sliding row by dragging
* enable or disable individual toggles
* choose whether the battery meter appears above or below the sliding row
* select the particle animation style shown on the battery meter

Quick Settings Panel

2026-04-19T14:20:23Z

Mosen: /* Configuring the panel */ correct typo

= Quick Settings Panel =

The Quick Settings panel gives you fast access to the most common system controls without opening the Settings app. Swipe down from the top edge of the watchface to open it.

The panel has two rows of controls:

* '''Fixed row''' — holds up to two high-priority toggles or buttons, always visible without scrolling.
* '''Sliding row''' — holds additional toggles organised into pages of three. Swipe left and right to move between pages.

A meter at the centre of the panel shows battery charge by default. Pressing and holding the brightness or volume toggles adjusts their values in steps rather than toggling — brightness in steps of 10 (minimum 10% to prevent a blank screen), volume linearly from 0 to 100%.

The order and visibility of toggles in the sliding row is configurable. Open Settings > Quick Settings to drag toggles into your preferred order or enable and disable them individually. Toggles marked as unavailable on your hardware appear at the bottom of the list and cannot be moved.

== Toggles ==

=== Wi-Fi ===
Enables or disables the Wi-Fi radio. Wi-Fi is required for over-the-air updates, installing packages via <code>opkg</code>, and any sync client that communicates over IP rather than Bluetooth. Disabling Wi-Fi when not in use is one of the most effective ways to extend battery life.

=== Bluetooth ===
Enables or disables the Bluetooth radio. Bluetooth is required for phone sync via AsteroidOSSync and Gadgetbridge. Disabling Bluetooth disconnects any active sync session immediately.

=== Brightness ===
Tap to toggle between full brightness and a reduced level. Press and hold to step brightness up or down in increments of 10%, with a minimum of 10% to keep the display visible.

=== Sound ===
Tap to mute or unmute system audio. Press and hold to adjust volume in steps from 0 to 100%. Only available on watches with a speaker.

=== Haptics ===
Enables or disables vibration feedback for notifications and system events.

=== Always-On Display (AoD) ===

Toggles the Always-On Display watchface that keeps the screen active at reduced power between interactions.

Behaviour varies significantly by display hardware:

* '''OLED displays''' — AoD is power-efficient. The screen dims to a minimal watchface that updates once per minute. This is the intended use case for AoD.
* '''LCD displays''' — AoD keeps the backlight on continuously and has a high battery cost. It is not recommended for daily use on LCD watches.
* '''Watches with a secondary display''' (e.g. TicWatch Pro series) — AoD on the primary OLED panel is redundant, as the secondary always-on LCD provides the same function at no cost to the primary display. Disabling AoD on these watches leaves timekeeping to the secondary panel, which is the recommended configuration.

AoD is automatically disabled when Cinema Mode is active and restored when Cinema Mode is deactivated.

=== Cinema Mode ===
Silences the watch for use in quiet environments. When activated, Cinema Mode:

* mutes all audio output
* sets display brightness to 10%
* disables the Always-On Display

All three values are restored to their pre-cinema state when Cinema Mode is deactivated. The 10% brightness minimum means the display remains readable if you need to check the time without the watch making noise or lighting up a dark room.

Cinema Mode ships disabled by default and must be enabled in Settings > Quick Settings to appear in the sliding row.

=== Power Off ===
Shuts down the watch. A 3-second cancellable confirmation timer runs before the shutdown executes, preventing accidental activation.

=== Reboot ===
Restarts the watch. The same 3-second cancellable confirmation applies.

=== Music (optional) ===
Opens the Music app directly from the panel. Disabled by default — enable in Settings > Quick Settings if you frequently use the watch as a remote control for phone playback.

=== Flashlight (optional) ===
Opens the Flashlight app, turning the screen white for use as a torch. Disabled by default.

== Configuring the panel ==

Open Settings > Quick Panel to:

* reorder toggles in the sliding row by dragging
* enable or disable individual toggles
* choose whether the battery meter appears above or below the sliding row
* select the particle animation style shown on the battery meter

Quick Settings Panel

2026-04-19T14:18:45Z

Mosen: Convert Quick Settings Panel page to mediawiki markdown

= Quick Settings Panel =

The Quick Settings panel gives you fast access to the most common system controls without opening the Settings app. Swipe down from the top edge of the watchface to open it.

The panel has two rows of controls:

* '''Fixed row''' — holds up to two high-priority toggles or buttons, always visible without scrolling.
* '''Sliding row''' — holds additional toggles organised into pages of three. Swipe left and right to move between pages.

A meter at the centre of the panel shows battery charge by default. Pressing and holding the brightness or volume toggles adjusts their values in steps rather than toggling — brightness in steps of 10 (minimum 10% to prevent a blank screen), volume linearly from 0 to 100%.

The order and visibility of toggles in the sliding row is configurable. Open Settings > Quick Settings to drag toggles into your preferred order or enable and disable them individually. Toggles marked as unavailable on your hardware appear at the bottom of the list and cannot be moved.

== Toggles ==

=== Wi-Fi ===
Enables or disables the Wi-Fi radio. Wi-Fi is required for over-the-air updates, installing packages via <code>opkg</code>, and any sync client that communicates over IP rather than Bluetooth. Disabling Wi-Fi when not in use is one of the most effective ways to extend battery life.

=== Bluetooth ===
Enables or disables the Bluetooth radio. Bluetooth is required for phone sync via AsteroidOSSync and Gadgetbridge. Disabling Bluetooth disconnects any active sync session immediately.

=== Brightness ===
Tap to toggle between full brightness and a reduced level. Press and hold to step brightness up or down in increments of 10%, with a minimum of 10% to keep the display visible.

=== Sound ===
Tap to mute or unmute system audio. Press and hold to adjust volume in steps from 0 to 100%. Only available on watches with a speaker.

=== Haptics ===
Enables or disables vibration feedback for notifications and system events.

=== Always-On Display (AoD) ===

Toggles the Always-On Display watchface that keeps the screen active at reduced power between interactions.

Behaviour varies significantly by display hardware:

* '''OLED displays''' — AoD is power-efficient. The screen dims to a minimal watchface that updates once per minute. This is the intended use case for AoD.
* '''LCD displays''' — AoD keeps the backlight on continuously and has a high battery cost. It is not recommended for daily use on LCD watches.
* '''Watches with a secondary display''' (e.g. TicWatch Pro series) — AoD on the primary OLED panel is redundant, as the secondary always-on LCD provides the same function at no cost to the primary display. Disabling AoD on these watches leaves timekeeping to the secondary panel, which is the recommended configuration.

AoD is automatically disabled when Cinema Mode is active and restored when Cinema Mode is deactivated.

=== Cinema Mode ===
Silences the watch for use in quiet environments. When activated, Cinema Mode:

* mutes all audio output
* sets display brightness to 10%
* disables the Always-On Display

All three values are restored to their pre-cinema state when Cinema Mode is deactivated. The 10% brightness minimum means the display remains readable if you need to check the time without the watch making noise or lighting up a dark room.

Cinema Mode ships disabled by default and must be enabled in Settings > Quick Settings to appear in the sliding row.

=== Power Off ===
Shuts down the watch. A 3-second cancellable confirmation timer runs before the shutdown executes, preventing accidental activation.

=== Reboot ===
Restarts the watch. The same 3-second cancellable confirmation applies.

=== Music (optional) ===
Opens the Music app directly from the panel. Disabled by default — enable in Settings > Quick Settings if you frequently use the watch as a remote control for phone playback.

=== Flashlight (optional) ===
Opens the Flashlight app, turning the screen white for use as a torch. Disabled by default.

== Configuring the panel ==

Open Settings > Quick Settings to:

* reorder toggles in the sliding row by dragging
* enable or disable individual toggles
* choose whether the battery meter appears above or below the sliding row
* select the particle animation style shown on the battery meter

Quick Settings Panel

2026-04-19T14:14:54Z

Mosen: Add initial version of Quick Settings Panel reference

# Quick Settings Panel

The Quick Settings panel gives you fast access to the most common system controls without opening the Settings app. Swipe down from the top edge of the watchface to open it.

The panel has two rows of controls:

- **Fixed row** — holds up to two high-priority toggles or buttons, always visible without scrolling.
- **Sliding row** — holds additional toggles organised into pages of three. Swipe left and right to move between pages.

A meter at the centre of the panel shows battery charge by default. Pressing and holding the brightness or volume toggles adjusts their values in steps rather than toggling — brightness in steps of 10 (minimum 10% to prevent a blank screen), volume linearly from 0 to 100%.

The order and visibility of toggles in the sliding row is configurable. Open Settings > Quick Settings to drag toggles into your preferred order or enable and disable them individually. Toggles marked as unavailable on your hardware appear at the bottom of the list and cannot be moved.

## Toggles

### Wi-Fi
Enables or disables the Wi-Fi radio. Wi-Fi is required for over-the-air updates, installing packages via `opkg`, and any sync client that communicates over IP rather than Bluetooth. Disabling Wi-Fi when not in use is one of the most effective ways to extend battery life.

### Bluetooth
Enables or disables the Bluetooth radio. Bluetooth is required for phone sync via AsteroidOSSync and Gadgetbridge. Disabling Bluetooth disconnects any active sync session immediately.

### Brightness
Tap to toggle between full brightness and a reduced level. Press and hold to step brightness up or down in increments of 10%, with a minimum of 10% to keep the display visible.

### Sound
Tap to mute or unmute system audio. Press and hold to adjust volume in steps from 0 to 100%. Only available on watches with a speaker.

### Haptics
Enables or disables vibration feedback for notifications and system events.

### Always-On Display (AoD)

Toggles the Always-On Display watchface that keeps the screen active at reduced power between interactions.

Behaviour varies significantly by display hardware:

- **OLED displays** — AoD is power-efficient. The screen dims to a minimal watchface that updates once per minute. This is the intended use case for AoD.
- **LCD displays** — AoD keeps the backlight on continuously and has a high battery cost. It is not recommended for daily use on LCD watches.
- **Watches with a secondary display** (e.g. TicWatch Pro series) — AoD on the primary OLED panel is redundant, as the secondary always-on LCD provides the same function at no cost to the primary display. Disabling AoD on these watches leaves timekeeping to the secondary panel, which is the recommended configuration.

AoD is automatically disabled when Cinema Mode is active and restored when Cinema Mode is deactivated.

### Cinema Mode
Silences the watch for use in quiet environments. When activated, Cinema Mode:

- mutes all audio output
- sets display brightness to 10%
- disables the Always-On Display

All three values are restored to their pre-cinema state when Cinema Mode is deactivated. The 10% brightness minimum means the display remains readable if you need to check the time without the watch making noise or lighting up a dark room.

Cinema Mode ships disabled by default and must be enabled in Settings > Quick Settings to appear in the sliding row.

### Power Off
Shuts down the watch. A 3-second cancellable confirmation timer runs before the shutdown executes, preventing accidental activation.

### Reboot
Restarts the watch. The same 3-second cancellable confirmation applies.

### Music (optional)
Opens the Music app directly from the panel. Disabled by default — enable in Settings > Quick Settings if you frequently use the watch as a remote control for phone playback.

### Flashlight (optional)
Opens the Flashlight app, turning the screen white for use as a torch. Disabled by default.

## Configuring the panel

Open Settings > Quick Settings to:

- reorder toggles in the sliding row by dragging
- enable or disable individual toggles
- choose whether the battery meter appears above or below the sliding row
- select the particle animation style shown on the battery meter

Documentation

2026-04-19T11:18:15Z

Mosen: /* For Developers: */ Add links to Contributors Agreement and Contribution Guidelines

* [[Code of Conduct]]
* [[Frequently Asked Questions (FAQ)]]
* [[:Category:Watches|Watches]]
* [[Watch Feature List]]
* [[Watch Support Level|Watch Support Level Rating System]]

=== For Users: ===
* [[Quick Start Guide]]
* [[Applications]]
* [[Synchronization Clients]]
* [[SSH]]
* [[Watchface and Package Installation]]
* [[Backup Guide]]
* [[IP Connection]]
* [[Useful Commands]]
* [[Porting Status]]
* [[Updating AsteroidOS]]
* [[Translating AsteroidOS]]
* [[Licenses]]

=== For Developers: ===
* [[Contributors Agreement]]
*[[Contributing Guidelines]]
*[[Building AsteroidOS]]
* [[Building the SDK]]
*[[Installing the SDK]]
*[[Creating an Asteroid app]]
*[[Debugging Applications]]
*[[Creating a Watchface]]
*[[Emulator]]
*[[Local version of asteroidos.org]]
*[[Bluetooth]]
*[[BLE profiles]]

===For Porters:===
*[[Porting Guide]]
*[[OpenEmbedded]]
*[[Boot Process]]
*[[Graphic Stack]]
*[[Technical Details of AsteroidOS Watches]]

Contributing Guidelines

2026-04-19T11:15:03Z

Mosen: /* Before you start */ Add Contributors Agreement link

= Who this is for =
Anyone submitting code, documentation, watchfaces, translations, or other contributions to any AsteroidOS repository, whether you are a first-time contributor or a regular one.

= Before you start =
Read the [[Contributors Agreement|contributors agreement.]]

It is short and covers licensing, copyright, and the project's independence from commercial interests. If you are unsure whether your contribution fits the project or how to approach a problem technically, ask first. The IRC channel and Matrix room are the right place. Nobody has ever been turned away for asking a basic question early. Asking late, after submitting something that needs significant rework, costs everyone more time.

= Patience and mutual respect =
Everyone involved in AsteroidOS — contributors and maintainers alike — is giving their free time. There are zero expectations on review or development timelines in either direction. Do not pressure maintainers for reviews, and do not pressure contributors for updates. Life happens, things take as long as they take, and that is completely fine. If a PR sits without movement for a while, a single polite ping after a reasonable wait is always welcome. Repeated pressure is not.

= Submitting a pull request =
One concern per PR. If you are fixing a bug and also cleaning up whitespace, those are two separate commits at minimum and potentially two PRs. Reviewers should be able to understand and approve each change independently.

Write commit messages that explain why, not just what. "Fix timer reset" is less useful than "Reset timer on visibility change to prevent stale state on re-entry". The diff shows what changed; the message should explain the reasoning.

AsteroidOS uses a two-eyes principle: every merge requires review by at least one maintainer who did not author the change. If your PR is a work in progress, mark it as a draft. Do not ask for review on unfinished code. Reference any related issue in the PR description.

= Using AI and LLM tools =
AsteroidOS welcomes contributors who use AI coding assistants. We ask for transparency so reviewers can give useful feedback.

State in your PR description that you used an LLM tool and name it (e.g. "drafted with Claude" or "written with Copilot"). Include or link the context and key prompts you used, a gist is fine. This helps reviewers identify systematic pattern issues and improve the project's own LLM context resources rather than leaving the same feedback repeatedly.

Explain how you validated the output. At minimum this means you reviewed the code and design yourself and tested it by building and running it on a device or emulator. Submitting LLM output that has not been built, run, or reasoned about independently damages trust in the same way that submitting any other untested or unjustified change does. You are responsible for what you submit.

Do not paste LLM-generated text into Matrix or GitHub discussions. Write in your own words. Reviewers notice, and it damages trust in ways that are hard to recover from. If you are uncertain whether your understanding is correct, say so. "I think this is right but I'm not sure" is always a better opening than presenting guesswork as fact.

= If your PR is rejected or needs changes =
Rejection is feedback, not judgement. If a reviewer asks for changes or closes a PR, they will explain why. If the explanation is unclear, ask for clarification in the PR thread. If you disagree with a review decision, say so in the thread with your reasoning. Maintainers are not infallible and have changed their minds before.

Contributing Guidelines

2026-04-19T11:08:05Z

Mosen: Add initial state discussed on 20260419

= Who this is for =
Anyone submitting code, documentation, watchfaces, translations, or other contributions to any AsteroidOS repository, whether you are a first-time contributor or a regular one.

= Before you start =
Read the contributor agreement. It is short and covers licensing, copyright, and the project's independence from commercial interests. If you are unsure whether your contribution fits the project or how to approach a problem technically, ask first. The IRC channel and Matrix room are the right place. Nobody has ever been turned away for asking a basic question early. Asking late, after submitting something that needs significant rework, costs everyone more time.

= Patience and mutual respect =
Everyone involved in AsteroidOS — contributors and maintainers alike — is giving their free time. There are zero expectations on review or development timelines in either direction. Do not pressure maintainers for reviews, and do not pressure contributors for updates. Life happens, things take as long as they take, and that is completely fine. If a PR sits without movement for a while, a single polite ping after a reasonable wait is always welcome. Repeated pressure is not.

= Submitting a pull request =
One concern per PR. If you are fixing a bug and also cleaning up whitespace, those are two separate commits at minimum and potentially two PRs. Reviewers should be able to understand and approve each change independently.

Write commit messages that explain why, not just what. "Fix timer reset" is less useful than "Reset timer on visibility change to prevent stale state on re-entry". The diff shows what changed; the message should explain the reasoning.

AsteroidOS uses a two-eyes principle: every merge requires review by at least one maintainer who did not author the change. If your PR is a work in progress, mark it as a draft. Do not ask for review on unfinished code. Reference any related issue in the PR description.

= Using AI and LLM tools =
AsteroidOS welcomes contributors who use AI coding assistants. We ask for transparency so reviewers can give useful feedback.

State in your PR description that you used an LLM tool and name it (e.g. "drafted with Claude" or "written with Copilot"). Include or link the context and key prompts you used, a gist is fine. This helps reviewers identify systematic pattern issues and improve the project's own LLM context resources rather than leaving the same feedback repeatedly.

Explain how you validated the output. At minimum this means you reviewed the code and design yourself and tested it by building and running it on a device or emulator. Submitting LLM output that has not been built, run, or reasoned about independently damages trust in the same way that submitting any other untested or unjustified change does. You are responsible for what you submit.

Do not paste LLM-generated text into Matrix or GitHub discussions. Write in your own words. Reviewers notice, and it damages trust in ways that are hard to recover from. If you are uncertain whether your understanding is correct, say so. "I think this is right but I'm not sure" is always a better opening than presenting guesswork as fact.

= If your PR is rejected or needs changes =
Rejection is feedback, not judgement. If a reviewer asks for changes or closes a PR, they will explain why. If the explanation is unclear, ask for clarification in the PR thread. If you disagree with a review decision, say so in the thread with your reasoning. Maintainers are not infallible and have changed their minds before.

Contributors Agreement

2026-04-19T11:02:17Z

Mosen: Populate Contributors Agreement with draft from 20260419

= 1. Purpose =
This agreement defines how contributions — code, documentation, designs, translations, and other creative work — to the AsteroidOS project are licensed, and how the project remains independent and community-governed regardless of who contributes.

= 2. Licensing of Contributions =
All contributions must be licensed under the same open-source license as the receiving component of AsteroidOS (GPLv2, GPLv3, or LGPLv3 as applicable). By contributing, you grant a perpetual, irrevocable, non-exclusive license for your contribution to be used, modified, and redistributed under that license. Contributors must ensure they have the legal right to contribute their work, meaning no proprietary, NDA-protected, or patent-encumbered code.

= 3. LLM (AI)-Assisted Contributions =
Contributions that were wholly or substantially generated by an AI or LLM tool must be disclosed in the pull request or submission. Contributors are responsible for verifying that LLM-generated content does not introduce third-party license obligations or reproduce protected material. The contributor, not the tool, is the author of record and accepts full responsibility for the submission.

= 4. No Special Privileges for Companies =
Contributions from companies or their employees do not grant special control, influence, or priority over the project. All contributors participate on equal terms regardless of affiliation. No contributor or organization may demand exclusivity, priority review, or roadmap influence in exchange for contributions or resources.

= 5. Independence and No Obligations =
AsteroidOS remains a volunteer-driven effort with no commercial obligations. Contributors participate on their own time with no expectation of compensation. Contributions are accepted on technical merit and community consensus, not corporate or organizational influence.

= 6. Retention of Copyright =
Contributors retain copyright over their own contributions. AsteroidOS and its maintainers cannot relicense contributions under a closed-source or commercially restrictive license.

= 7. Technical and Legal Independence =
AsteroidOS will remain technically and legally independent from any company or organization. No contributor may introduce a dependency on proprietary services, infrastructure, or APIs without community consensus. Any collaboration requiring shared external resources must include a documented exit strategy to prevent lock-in.

= 8. Governance and Decision-Making =
The project is community-governed. No single entity may unilaterally dictate project direction, feature inclusion, or release priorities. Major decisions are discussed openly in community channels before implementation.

= 9. Conflict Resolution =
Disputes are resolved through open community discussion. If a contributor's actions demonstrably harm the project's open nature or community health, the maintainers may suspend acceptance of their future contributions pending resolution.

Contributors Agreement

2026-04-19T11:00:50Z

Mosen: Initial creation of Contribution Agreement page

<nowiki>= 1. Purpose =</nowiki>

Backup Guide

2026-03-18T23:34:23Z

Mosen: /* Manual backup method */ Add alternate debug ramdisk method

Before flashing AsteroidOS to your watch to replace WearOS, we advise to make a complete backup.

= Manual backup method=

# Temporarily install AsteroidOS
#: Follow the install instructions for a temporary installation. Once booted into AsteroidOS, we can enable SSH or ADB with root access to all partitions on the internal storage.
# Enable SSH or ADB
#: Open the settings app and the USB page. Select SSH Mode to enable SSH. Or ADB Mode to use ADB connection.
# Copy mmcblk0 into a local image file
#* Backup using SSH and <code>dd</code>
#: Navigate to a folder where you want to store the backup. Or add a full path before the image name (after <code>of=</code>) in the next command.
#: <pre>ssh root@192.168.2.15 "dd if=/dev/mmcblk0" | dd "of=watch-backup.img" bs=4096 status=progress</pre>
#* Backup using ADB
#: <pre>adb pull /dev/mmcblk0 watch-backup.img</pre>

The copy process might take up to an hour on watches with 8GB of storage.

Mind that taking multiple backups during runtime will result in different checksums. This is expected, because the live AsteroidOS system continuously writes to files, logs and other data on the block device while the dump is running.

If you want consistent backups, the debug ramdisk method may work on some watches. Boot the debug ramdisk with the following command (replace <code>zImage-dtb-dory.fastboot</code> with the correct image for your watch):

<pre>fastboot --cmdline debug-ramdisk boot zImage-dtb-dory.fastboot</pre>

The debug ramdisk is booted when the manufacturer logo is standing/hanging. You can then run the normal <code>adb pull /dev/mmcblk0 watch-backup.img</code> command and repeated dumps will have identical checksums.

= Scripted backup and restore=

Beroset has written a set of tools to make working with watches from a Linux computer very convenient. This backup guide will only cover the backup and restore features of asteroid-hosttools. Please be sure to read the [https://github.com/beroset/asteroid-hosttools asteroid-hosttools documentation] to make use of the full capabilities they provide.
# Clone asteroid-hosttools
#: Clone the asteroid-hosttools using the following command:
#: <pre>git clone https://github.com/beroset/asteroid-hosttools</pre>
#: And change into the asteroid-hosttools directory:
#:<pre>cd asteroid-hosttools</pre>
# Temporarily install AsteroidOS
#: Adapt <code><watch-codename></code> in the following commands according to your watches codename listed on the [https://asteroidos.org/watches/ Watches page]. I.e <code>dory</code> for the LG G Watch or <code>sturgeon</code> for the Huawei Watch.
#:<pre>./flashy <watch-codename> --temp --nightly</pre>
# Backup the entire watch
#: Following command will create a file called <code>original-<watch-codename>.img</code>.
#:<pre>./watch-image <watch-codename> --save</pre>
# Restore a backup
#: To restore the backup image created in step 3, make sure the <code>original-<watch-codename>.img</code> file exists.
#:Then issue the restore command:
#: <pre>./watch-image <watch-codename> --restore</pre>

IP Connection

2026-03-05T00:58:22Z

Mosen: /* IP over WLAN (WiFi) */ Add note to connect

Configuring an IP connection on your watch has to be done manually until a GUI settings option is available. On watches that support WLAN, you can enable Wi-Fi and configure the connection using <code>connmanctl</code> like described below. Forwarding IP requests to a connected PC via USB is another option, explained in the second paragraph.

By default, there is no <code>root</code> or <code>ceres</code> password, and no firewall rules. (However, on some watches, the kernel has the <code>CONFIG_ANDROID_PARANOID_NETWORK</code> kernel option enabled, see below.) A password can be set using the passwd command.

= IP over WLAN (WiFi) =
Connect to your watch using <code>ssh root@192.168.2.15</code> or <code>adb shell</code>.

<pre>connmanctl</pre>
Starts the connmanctl interactive mode. The prompt indicator will change to <code>connmanctl></code>
<pre>enable wifi</pre>
Output: Enabled wifi
<pre>scan wifi</pre>
Output: Scan completed for wifi
<pre>agent on</pre>
Output: Agent registered

The Agent will handle automatic reconnect to the network.
<pre>services</pre>
Shows the discovered SSIDs and their service identifier.

Output example:

<code>YourNetwork wifi_1234567890_1234567890_managed_psk</code>

<code>OtherLAN wifi_0987654321_123456789_managed_psk</code>
<pre>connect <ServiceIdentifierOfYourSSID></pre>
Example:

<code>connect wifi_1234567890_1234567890_managed_psk</code>

Prompt changes to <code>Passphrase?</code> and asks for the password to the SSID.

<code>TypeYourPassPhraseAndPressEnter</code>

Output: Connected to wifi_1234567890_1234567890_managed_psk

Note: If the connection fails with an error (e.g., "Invalid key" or no connection), try connecting to the other service identifier listed for the same SSID name, as it may correspond to the 2.4 GHz band that your watch supports more reliably (while the other is likely 5 GHz).
<pre>quit</pre>
Leaves the connmanctl interactive mode.

Check whether an IP address has been assigned to the watch using <code>ip a show dev wlan0</code> or <code>ifconfig wlan0</code> or by trying to <code>ping 8.8.8.8</code>.

Note that activated WLAN consumes additional power. Currently, it is recommended to disable the function after use. <code>connmanctl disable wifi</code> is used to disable Wi-Fi and power off WLAN temporarily. <code>connmanctl enable wifi</code> activates WLAN again and connects to the last used Wi-Fi network.

Some more documentation on connman can be found on [https://wiki.archlinux.org/index.php/ConnMan#Connecting_to_a_protected_access_point ArchWiki].

=IP over USB=
It is possible to allow your watch to be able to use your Linux computer's internet connection via a USB connection. You will need:

#A Linux computer with RNDIS support loaded and enabled
#The ability to change network configurations on that computer
#A network connection

This works by using the RNDIS driver to allow the USB device to appear to be a network interface. RNDIS stands for "Remote Network Driver Interface Specification" and was a proprietary protocol from Microsoft. It is supported in Linux by the <code>rndis_host</code> driver. This driver may either be compiled into the kernel, or more typically provided as an optional module. If you're not sure, you can try this <code>lsmod</code> to see if it's loaded on your computer.

<pre>
lsmod | grep ndis
rndis_host 24576 0
cdc_ether 24576 1 rndis_host
usbnet 61440 2 rndis_host,cdc_ether
</pre>

If it isn't you might be able to use <code>modprobe rndis_host</code> (with root privileges) to install the module.

Once the <code>rndis_host</code> is installed and running, you can enable Network Address Translation (NAT) to allow your Linux computer to share it's internet IP address with the watch. To configure a NAT '''on your computer''' (Note: Replace eth0 with the name of the interface that connects your computer to the Internet) with:

<pre>echo 1 > /proc/sys/net/ipv4/ip_forward</pre>
<pre>iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE</pre>

Here again, you might need root privileges for those commands, depending on how your computer is configured.

Configure a default gateway and DNS '''on the watch''' with the following commands ran via [[SSH]] as the root user:

<pre>ip route add default via 192.168.2.1</pre>
<pre>echo "nameserver 8.8.8.8" >> /etc/resolv.conf</pre>

Note that this assumes that your computer's IP address on RNDIS is 192.168.2.1, which is the default, but if you have multiple watches, or have plugged and unplugged the same watch a few times, it might be different. To make sure, on the watch, you can type <code>who</code> and it will reply with something like this:

<code>
root pts/0 00:01 Jun 9 08:06:24 192.168.2.2
</code>

In this particular case, the address shown is 192.168.2.2, so the first command listed above would be <code>route add default gw 192.168.2.2</code>.

= Paranoid Kernels=
On some watch models (e.g., <code>lenok</code>), the kernel shipped with AsteroidOS is compiled with the Android-specific <code>CONFIG_ANDROID_PARANOID_NETWORK</code> kernel option enabled. That option enforces non-standard restrictions on networking, based on hardcoded group IDs (GIDs):
*GID 3003 is the <code>inet</code> group, allowing to create <code>AF_INET</code> and <code>AF_INET6</code> sockets,
* GID 3004 is the <code>net_raw</code> group, allowing to create raw INET sockets.

Only <code>root</code> and members of the groups with those magic GIDs are allowed to perform the described actions. In particular, by default, the <code>ceres</code> user is '''not'''.

Therefore, in order to be able to access the network as <code>ceres</code> (e.g., for <code>asteroid-weatherfetch</code> to work), SSH into your watch as <code>root</code> (or use <code>adb shell</code>) and run the following 2 commands:
<pre>
groupadd -g 3003 -U root,ceres inet
groupadd -g 3004 -U root,ceres net_raw
</pre>
These create the two magic groups with the same name and GID as on Android and add both <code>root</code> and <code>ceres</code> to them. Then reboot your watch, because only newly started sessions will pick up the new group memberships.

IP Connection

2026-03-05T00:39:50Z

Mosen: /* IP over WLAN (WiFi) */

Configuring an IP connection on your watch has to be done manually until a GUI settings option is available. On watches that support WLAN, you can enable Wi-Fi and configure the connection using <code>connmanctl</code> like described below. Forwarding IP requests to a connected PC via USB is another option, explained in the second paragraph.

By default, there is no <code>root</code> or <code>ceres</code> password, and no firewall rules. (However, on some watches, the kernel has the <code>CONFIG_ANDROID_PARANOID_NETWORK</code> kernel option enabled, see below.) A password can be set using the passwd command.

= IP over WLAN (WiFi) =
Connect to your watch using <code>ssh root@192.168.2.15</code> or <code>adb shell</code>.

<pre>connmanctl</pre>
Starts the connmanctl interactive mode. The prompt indicator will change to <code>connmanctl></code>
<pre>enable wifi</pre>
Output: Enabled wifi
<pre>scan wifi</pre>
Output: Scan completed for wifi
<pre>agent on</pre>
Output: Agent registered

The Agent will handle automatic reconnect to the network.
<pre>services</pre>
Shows the discovered SSIDs and their service identifier.

Output example:

<code>YourNetwork wifi_1234567890_1234567890_managed_psk</code>

<code>OtherLAN wifi_0987654321_123456789_managed_psk</code>
<pre>connect <ServiceIdentifierOfYourSSID></pre>
Example:

<code>connect wifi_1234567890_1234567890_managed_psk</code>

Prompt changes to <code>Passphrase?</code> and asks for the password to the SSID.

<code>TypeYourPassPhraseAndPressEnter</code>

Output: Connected to wifi_1234567890_1234567890_managed_psk
<pre>quit</pre>
Leaves the connmanctl interactive mode.

Check whether an IP address has been assigned to the watch using <code>ip a show dev wlan0</code> or <code>ifconfig wlan0</code> or by trying to <code>ping 8.8.8.8</code>.

Note that activated WLAN consumes additional power. Currently, it is recommended to disable the function after use. <code>connmanctl disable wifi</code> is used to disable Wi-Fi and power off WLAN temporarily. <code>connmanctl enable wifi</code> activates WLAN again and connects to the last used Wi-Fi network.

Some more documentation on connman can be found on [https://wiki.archlinux.org/index.php/ConnMan#Connecting_to_a_protected_access_point ArchWiki].

=IP over USB=
It is possible to allow your watch to be able to use your Linux computer's internet connection via a USB connection. You will need:

#A Linux computer with RNDIS support loaded and enabled
#The ability to change network configurations on that computer
#A network connection

This works by using the RNDIS driver to allow the USB device to appear to be a network interface. RNDIS stands for "Remote Network Driver Interface Specification" and was a proprietary protocol from Microsoft. It is supported in Linux by the <code>rndis_host</code> driver. This driver may either be compiled into the kernel, or more typically provided as an optional module. If you're not sure, you can try this <code>lsmod</code> to see if it's loaded on your computer.

<pre>
lsmod | grep ndis
rndis_host 24576 0
cdc_ether 24576 1 rndis_host
usbnet 61440 2 rndis_host,cdc_ether
</pre>

If it isn't you might be able to use <code>modprobe rndis_host</code> (with root privileges) to install the module.

Once the <code>rndis_host</code> is installed and running, you can enable Network Address Translation (NAT) to allow your Linux computer to share it's internet IP address with the watch. To configure a NAT '''on your computer''' (Note: Replace eth0 with the name of the interface that connects your computer to the Internet) with:

<pre>echo 1 > /proc/sys/net/ipv4/ip_forward</pre>
<pre>iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE</pre>

Here again, you might need root privileges for those commands, depending on how your computer is configured.

Configure a default gateway and DNS '''on the watch''' with the following commands ran via [[SSH]] as the root user:

<pre>ip route add default via 192.168.2.1</pre>
<pre>echo "nameserver 8.8.8.8" >> /etc/resolv.conf</pre>

Note that this assumes that your computer's IP address on RNDIS is 192.168.2.1, which is the default, but if you have multiple watches, or have plugged and unplugged the same watch a few times, it might be different. To make sure, on the watch, you can type <code>who</code> and it will reply with something like this:

<code>
root pts/0 00:01 Jun 9 08:06:24 192.168.2.2
</code>

In this particular case, the address shown is 192.168.2.2, so the first command listed above would be <code>route add default gw 192.168.2.2</code>.

= Paranoid Kernels=
On some watch models (e.g., <code>lenok</code>), the kernel shipped with AsteroidOS is compiled with the Android-specific <code>CONFIG_ANDROID_PARANOID_NETWORK</code> kernel option enabled. That option enforces non-standard restrictions on networking, based on hardcoded group IDs (GIDs):
*GID 3003 is the <code>inet</code> group, allowing to create <code>AF_INET</code> and <code>AF_INET6</code> sockets,
* GID 3004 is the <code>net_raw</code> group, allowing to create raw INET sockets.

Only <code>root</code> and members of the groups with those magic GIDs are allowed to perform the described actions. In particular, by default, the <code>ceres</code> user is '''not'''.

Therefore, in order to be able to access the network as <code>ceres</code> (e.g., for <code>asteroid-weatherfetch</code> to work), SSH into your watch as <code>root</code> (or use <code>adb shell</code>) and run the following 2 commands:
<pre>
groupadd -g 3003 -U root,ceres inet
groupadd -g 3004 -U root,ceres net_raw
</pre>
These create the two magic groups with the same name and GID as on Android and add both <code>root</code> and <code>ceres</code> to them. Then reboot your watch, because only newly started sessions will pick up the new group memberships.

Rubyfish

2026-02-28T19:03:53Z

Mosen: /* Developer Dock */ Extend explanations

{{Watches
|Name=rubyfish
|OtherNames=rover
|Model=TicWatch Pro 3
|ReleaseDate=2020-09-24
|Picture=rubyfish.png
|Status=supported
|Stars=3
|Chipset=msm8937
|KernelVersion=4.9
|AndroidVersion=pie
|StatusDisplay=good
|StatusTouch=good
|StatusBluetooth=good
|StatusHaptics=good
|StatusTiltToWake=good
|StatusLightSensor=good
|StatusAlwaysOnDisplay=good
|StatusDualDisplay=partial
|StatusMicrophone=bad
|StatusSpeaker=bad
|StatusCompass=good
|StatusSteps=good
|StatusHeartRate=good
|StatusUSB=partial
|StatusWLAN=good
|StatusGPS=partial
|StatusNFC=bad
|StatusCellular=bad
|StatusCamera=missing
|StatusCrown=missing
|StatusHands=missing
}}
[[Category:Watches]]
= Description =
This watch is sold in several variations:
{| class="wikitable"
|+ rubyfish models and model numbers
|-
! Model Number !! Model Name !! Codename
|-
| WH12018 || TicWatch Pro || rubyfish
|-
| WH12018 || TicWatch Pro 3 Ultra GPS || rubyfish
|-
| WH11013 || TicWatch Pro 3 Cellular/LTE || rover
|-
| WH11013 || TicWatch Pro 3 Ultra || rover
|}

Although there are variations in the physical size and appearance of these watches, all models use the same <code>rubyfish</code> AsteroidOS image.

== Developer Dock ==
You will need to build a dock to access the USB pads since the stock cable does not connect to the inner D+ / D- data pads. This one has been developed by the community and tested working multiple times now:

https://www.printables.com/model/634749-ticwatch-pro-3-developer-usb-data-dock-using-pogo

The specs for the pogo-pins used in the dock assembly:
[[File:Rover-pogopins.webp|none|thumb]]
Mind to first solder the pogo-pins to the USB-cable:[[File:Rover-dock-pogo.jpg|none|thumb]]
Then use a 1.5mm drill bit to widen the channels in the 3D Print and insert the pogo-pin assembly.

You can be lucky and your 3D printer produces the channels with 1.5mm. The model has them at 1.56mm.

Users report however, that even with well calibrated printers, its hard to get those exact.
[[File:Rover-rubyfish-dock.jpg|none|thumb]]Order from left to right in pictured orientation: black (GND/ground), white (DATA/D-), green (/DATA/D+), red (VCC/+5V)

In case the pogo-pins do not stick out far enough to make connection with the watches pads after inserting them: Adjust the soldering iron to 150′C and gently press them deeper, melting them into the plastic.

If they are protruding to much and push the watch off the dock: Use gel-or hot-glue to adjust their height and fixate them in position. Avoid to use thin/liquid glue as it can run down the channels and glue the pogo- pin springs.

Rubyfish

2026-02-26T18:44:54Z

Mosen: /* Developer Dock */ add pogo specs

{{Watches
|Name=rubyfish
|OtherNames=rover
|Model=TicWatch Pro 3
|ReleaseDate=2020-09-24
|Picture=rubyfish.png
|Status=supported
|Stars=3
|Chipset=msm8937
|KernelVersion=4.9
|AndroidVersion=pie
|StatusDisplay=good
|StatusTouch=good
|StatusBluetooth=good
|StatusHaptics=good
|StatusTiltToWake=good
|StatusLightSensor=good
|StatusAlwaysOnDisplay=good
|StatusDualDisplay=partial
|StatusMicrophone=bad
|StatusSpeaker=bad
|StatusCompass=good
|StatusSteps=good
|StatusHeartRate=good
|StatusUSB=partial
|StatusWLAN=good
|StatusGPS=partial
|StatusNFC=bad
|StatusCellular=bad
|StatusCamera=missing
|StatusCrown=missing
|StatusHands=missing
}}
[[Category:Watches]]
= Description =
This watch is sold in several variations:
{| class="wikitable"
|+ rubyfish models and model numbers
|-
! Model Number !! Model Name !! Codename
|-
| WH12018 || TicWatch Pro || rubyfish
|-
| WH12018 || TicWatch Pro 3 Ultra GPS || rubyfish
|-
| WH11013 || TicWatch Pro 3 Cellular/LTE || rover
|-
| WH11013 || TicWatch Pro 3 Ultra || rover
|}

Although there are variations in the physical size and appearance of these watches, all models use the same <code>rubyfish</code> AsteroidOS image.

== Developer Dock ==
You will need to build a dock to access the USB pads since the stock cable does not connect to the inner D+ / D- data pads. This one has been developed by the community and tested working multiple times now:

https://www.printables.com/model/634749-ticwatch-pro-3-developer-usb-data-dock-using-pogo

The specs for the pogo-pins used in the dock assembly:
[[File:Rover-pogopins.webp|none|thumb]]
Mind to first solder the pogo-pins to the USB-cable:[[File:Rover-dock-pogo.jpg|none|thumb]]
Then use a 1.5mm drill bit to widen the channels in the 3D Print and insert the pogo-pin assembly.
[[File:Rover-rubyfish-dock.jpg|none|thumb]]In case the pins do not stick out far enough, adjust the soldering iron to 150′C and gently press them deeper, melting them into the plastic. If they are protruding to much and push the watch off the dock, use super-or hot-glue to adjust their height.

File:Rover-pogopins.webp

2026-02-26T18:41:41Z

Mosen:

Specification of the rover dock pogo pins

Rubyfish

2026-02-26T18:10:46Z

Mosen: /* Developer Dock */ Add pictures

File:Rover-rubyfish-dock.jpg

2026-02-26T18:10:04Z

Mosen:

3D printed dock for rover and rubyfish

File:Rover-dock-pogo.jpg

2026-02-26T18:06:16Z

Mosen:

Soldered Pogo pins on usb cable

Rubyfish

2026-02-26T18:01:27Z

Mosen: dev dock link

Applications

2025-05-01T22:49:42Z

Mosen: Add description to stopwatch

[[Category:Applications]]
This shows a list of applications available for AsteroidOS with details about their operation. There is also a [[Application list|list summary]] in table format.

== Preinstalled ==

{{Application
|Name=Agenda
|Categories=calendar
|Related=icalconverter
|Homepage=https://github.com/AsteroidOS/asteroid-calendar
|Description=default calendar app for AsteroidOS
|Screenshot=Agenda.webp
|Status=supported
}}
A calendar app, with support for adding events.
Each event has a name and an event time.
Switch days by swiping left and right. View events for a given day by tapping on the date.
Add new events from the day view by tapping the plus (+) button. Edit events by tapping on the event. Switch back to the overview by tapping at the top of the screen or swiping down.
Switch months by tapping at the top of the screen in the overview.

The calendar does not automatically sync to your smartphone calendar. However, you can sideload and import .ical exported calenders using <code>icalconverter import test.ics -d</code> on the watch.

To get that .ical out of Nextcloud, use:

<code>curl -o test.ics -u USER:PASSWORD "http://[IP-ADRESS]/remote.php/dav/calendars/[USER]/[CALENDAR-URI]?export"</code>

{{Application
|Name=Alarm Clock
|Categories=alarmclock
|Related=
|Homepage=https://github.com/AsteroidOS/asteroid-alarmclock
|Description=An alarm clock app, which can support multiple repeating alarms.
|Screenshot=Alarm Clock.webp
|Status=supported
}}
An alarm clock app, which can support multiple repeating alarms.

Swipe left and right to view different alarms. Tap the plus (+) icon to add a new alarm. If you have any alarms set up, you can find the plus (+) icon by swiping to the end of the list.
Alarms can be set to repeat on a given day of the week, or to trigger once.
You can enable or disable an alarm by tapping the checkbox, change the time of the alarm by tapping the alarm's time, change the repetition by tapping the repetition text, and delete the alarm by tapping the trash icon.

A non-repeating alarm will disable itself after triggering. You can set it to trigger once again by enabling it.

When an alarm is triggered, you can dismiss it by tapping the tick icon, or snooze it for five minutes by tapping the 'zzz' icon or pressing the power button. The alarm will also automatically snooze after 30 seconds of ringing and will dismiss itself after three automatic snoozes.

{{Application
|Name=Calculator
|Categories=calculator
|Related=
|Homepage=https://github.com/AsteroidOS/asteroid-calculator
|Description=A calculator app for AsteroidOS
|Screenshot=Calculator.webp
|Status=supported
}}
A simple calculator app optimized for small round screens. With adaptive layout for rectangular displays.

{{Application
|Name=Diamonds
|Categories=game
|Related=
|Homepage=https://github.com/AsteroidOS/asteroid-diamonds
|Description=A 2048 style game for AsteroidOS
|Screenshot=Diamonds.webp
|Status=supported
}}
A 2048 style game. Swipe diagonally to move all tiles in the direction of your swipe, colliding tiles of the same numeric value will add together. The game ends when the screen fills with tiles and there are no more moves left.

{{Application
|Name=Flashlight
|Categories=utility
|Related=
|Homepage=https://github.com/AsteroidOS/asteroid-flashlight
|Description=simple 'flashlight' app that turns your watch screen white
|Screenshot=Flashlight.webp
|Status=supported
}}
A simple 'flashlight' app that turns your watch screen white with a light grey bulb. It serves a secondary use as screen burn in detector on OLED displays. Toggle the 'flashlight' by tapping the screen.

{{Application
|Name=Music
|Categories=utility
|Related=
|Homepage=https://github.com/AsteroidOS/asteroid-music
|Description=A controller for music playing on your phone.
|Screenshot=Music.webp
|Status=supported
}}
A controller for music playing on your phone. The app shows the current track title and artist, and allows you to play and pause, skip tracks and adjust volume.

{{Application
|Name=Settings
|Categories=utility
|Related=
|Homepage=https://github.com/AsteroidOS/asteroid-settings
|Description=A settings app.
|Screenshot=Settings.webp
|Status=supported
}}
The Settings app allows customization of the watch. All changes made in the Settings pages, including subpages like Display, Nightstand, Wallpaper, and Watchface, take effect immediately upon toggling a switch or selecting an item. To preview changes on the Watchface Homescreen, use the top-edge swipe gesture to peek without leaving the Settings app, then reverse the swipe to return..

{{Application
|Name=Stopwatch
|Categories=utility
|Related=
|Homepage=https://github.com/AsteroidOS/asteroid-stopwatch
|Description=a stopwatch app for AsteroidOS
|Screenshot=Stopwatch.webp
|Status=supported
}}
A simple stopwatch app designed for optimal legibility. Tap to start or pause. The stopwatch continues running in the background until paused or reset.

{{Application
|Name=Timer
|Categories=utility
|Related=
|Homepage=https://github.com/AsteroidOS/asteroid-timer
|Description=a simple timer app
|Screenshot=Timer.webp
|Status=supported
}}
A simple timer app.

Use the swipe friendly tumbler selectors to adjust a time and start / pause using the button. When a timer is triggered, you can dismiss it by tapping the tick icon or repeat the timer by tapping the repeat icon.

{{Application
|Name=Weather
|Categories=utility, weather
|Related=asteroid-weatherfetch
|Homepage=https://github.com/AsteroidOS/asteroid-weather
|Description=A weather app which shows up to 5 days' worth of data.
|Screenshot=Weather.webp
|Status=supported
}}
A weather app which shows up to 5 days' worth of data.

The app gets data from a paired device. If you are unable to pair your watch to a smartphone, it is possible to use Beroset's Asteroid-Weatherfetch to fetch data by connecting your watch to the internet.

== Preinstalled on some watches ==
These applications will only come on watches that have appropriate hardware. They can also be installed on watches without the correct hardware, but may not work correctly.

{{Application
|Name=Compass
|Categories=utility
|Related=
|Homepage=https://github.com/AsteroidOS/asteroid-compass
|Description=a compass app for AsteroidOS
|Screenshot=Compass.webp
|Status=supported
}}
A basic compass app, which shows cardinal directions around the perimeter and a numeric heading in the middle of the screen.

{{Application
|Name=Heart Rate Monitor
|Categories=utility, health
|Related=asteroid-health
|Homepage=https://github.com/AsteroidOS/asteroid-hrm
|Description=shows the current reading from the heartrate sensor
|Screenshot=Heart Rate Monitor.webp
|Status=supported
}}
A basic application that shows the current reading from the heartrate sensor. The previous reading is shown with an arrow to the left of the current reading. This will move to indicate whether the current reading is lower or higher than the previous.

Make sure to have your watch strapped firmly to your wrist in order to get the best reading. However, do not overtighten it beyond what is comfortable.

== Community ==
These applications are not installed by default but can be installed using <code>opkg</code> as described [[Watchface_and_Package_Installation#Installation_of_prebuilt_packages|here]]. See [[Other Packages]] for CLI programs and other non-graphical tools.

{{Application
|Name=unofficial-watchfaces
|Categories=utility
|Related=
|Homepage=https://github.com/AsteroidOS/unofficial-watchfaces
|Description=collection of unofficial watchfaces for AsteroidOS
|Screenshot=Analog-scientific-v2.webp
|Status=community
}}

A collection of AsteroidOS unofficial watchfaces. Watchface creation in QtQuick is really easy! You can learn how to make your own by following the [[Creating a Watchface|Watchface Creation Guide]]. This is a great place to start getting ideas and examples for your own custom watchface.

{{Application
|Name=asteroid-blaster
|Categories=games
|Related=
|Homepage=https://github.com/eLtMosen/asteroid-blaster
|Description=A tilt-controlled asteroid-shooting frenzy for AsteroidOS smartwatches!
|Screenshot=Asteroid Blaster.jpg
|Status=community
}}
A tilt-controlled asteroid-shooting frenzy for AsteroidOS smartwatches! Survive waves of randomly generated tumbling rocks, rack up points, and avoid collisions with a mix of skill and luck.

Buckle up, space cadets—v1.1 is here with smoother gameplay, slicker visuals, and a dash of dev nostalgia! Since v1.0, we’ve blasted through bugs, tuned the chaos, and polished the experience.

{{Application
|Name=asteroid-dodger
|Categories=games
|Related=
|Homepage=https://github.com/eLtMosen/asteroid-dodger
|Description=Asteroid Dodger, a small action packed game for AsteroidOS
|Screenshot=Asteroid Dodger.jpg
|Status=community
}}
Asteroid-Dodger is a thrilling survival game where you tilt your watch to surf through an ever-denser asteroid field, nailing asteroid surfing combos for big points. Master the art of near-misses and grab rare power-up potions to shrink, speed up, or freeze the cosmic chaos—all while the challenge ramps up with each level. With its retro arcade flair, vibrant visuals, and accelerometer-driven action, this game turns your wrist into a playground of skill and reflexes.

{{Application
|Name=asteroid-health
|Categories=utility, health
|Related=
|Homepage=https://git.dodorad.io/dodoradio/asteroid-health
|Description=track user's steps, heartrate and optionally weight
|Screenshot=Asteroid Health.jpg
|Status=community
}}
asteroid-health is an application that tracks the user's steps, heartrate and optionally weight. It uses [https://git.dodorad.io/dodoradio/asteroid-sensorlogd asteroid-sensorlogd] as the underlying engine that reads the data and stores it on the watch. Unlike many commercial health applications, asteroid-health '''NEVER''' sends your data to the cloud or to any third party.

{{Application
|Name=asteroid-map
|Categories=utility
|Related=
|Homepage=https://git.dodorad.io/dodoradio/asteroid-map/about
|Description=A map app for AsteroidOS
|Screenshot=Asteroid-map.jpg
|Status=community
}}
A map app for AsteroidOS that's targeted at small and round displays, and devices with limited connectivity.

{{Application
|Name=asteroid-qmltester
|Categories=utility, developer
|Related=
|Homepage=https://github.com/MagneFire/asteroid-qmltester.git
|Description=Asteroid's qmltester app
|Screenshot=qmltester.jpg
|Status=community
}}
Asteroid's qmltester app

This is an application that allows a developer to quickly try out QML designs on the watch without needing to write an entire application.

{{Application
|Name=asteroid-skedaddle
|Categories=utility, health
|Related=asteroid-health
|Homepage=https://github.com/beroset/asteroid-skedaddle
|Description=A runner's logging app
|Screenshot=Skedaddle.jpg
|Status=community
}}
In English "skedaddle" is verb meaning "to run off hastily." asteroid-skedaddle is an running log application that runs on AsteroidOS that tracks distance and time, logging each run to an industry standard [https://www.topografix.com/gpx.asp GPX] file. Note that the watch must have functional GPS (or other satellite positioning) to be fully useful. Unlike many commercial exercise and running applications, asteroid-skedaddle '''NEVER''' sends your data to the cloud or to any third party.

{{Application
|Name=asteroid-weatherfetch
|Categories=utility, weather
|Related=asteroid-weather
|Homepage=https://github.com/beroset/asteroid-weatherfetch.git
|Description=fetch weather forecast data for Weather app
|Screenshot=
|Status=community
}}
This app uses an internet connection from the watch to fetch weather forecast data to be used for the Weather app in AsteroidOS. It also has a command-line version that can be used for scripting.

Applications

2025-05-01T22:41:02Z

Mosen: Add details to some applications

[[Category:Applications]]
This shows a list of applications available for AsteroidOS with details about their operation. There is also a [[Application list|list summary]] in table format.

== Preinstalled ==

{{Application
|Name=Agenda
|Categories=calendar
|Related=icalconverter
|Homepage=https://github.com/AsteroidOS/asteroid-calendar
|Description=default calendar app for AsteroidOS
|Screenshot=Agenda.webp
|Status=supported
}}
A calendar app, with support for adding events.
Each event has a name and an event time.
Switch days by swiping left and right. View events for a given day by tapping on the date.
Add new events from the day view by tapping the plus (+) button. Edit events by tapping on the event. Switch back to the overview by tapping at the top of the screen or swiping down.
Switch months by tapping at the top of the screen in the overview.

The calendar does not automatically sync to your smartphone calendar. However, you can sideload and import .ical exported calenders using <code>icalconverter import test.ics -d</code> on the watch.

To get that .ical out of Nextcloud, use:

<code>curl -o test.ics -u USER:PASSWORD "http://[IP-ADRESS]/remote.php/dav/calendars/[USER]/[CALENDAR-URI]?export"</code>

{{Application
|Name=Alarm Clock
|Categories=alarmclock
|Related=
|Homepage=https://github.com/AsteroidOS/asteroid-alarmclock
|Description=An alarm clock app, which can support multiple repeating alarms.
|Screenshot=Alarm Clock.webp
|Status=supported
}}
An alarm clock app, which can support multiple repeating alarms.

Swipe left and right to view different alarms. Tap the plus (+) icon to add a new alarm. If you have any alarms set up, you can find the plus (+) icon by swiping to the end of the list.
Alarms can be set to repeat on a given day of the week, or to trigger once.
You can enable or disable an alarm by tapping the checkbox, change the time of the alarm by tapping the alarm's time, change the repetition by tapping the repetition text, and delete the alarm by tapping the trash icon.

A non-repeating alarm will disable itself after triggering. You can set it to trigger once again by enabling it.

When an alarm is triggered, you can dismiss it by tapping the tick icon, or snooze it for five minutes by tapping the 'zzz' icon or pressing the power button. The alarm will also automatically snooze after 30 seconds of ringing and will dismiss itself after three automatic snoozes.

{{Application
|Name=Calculator
|Categories=calculator
|Related=
|Homepage=https://github.com/AsteroidOS/asteroid-calculator
|Description=A calculator app for AsteroidOS
|Screenshot=Calculator.webp
|Status=supported
}}
A simple calculator app optimized for small round screens. With adaptive layout for rectangular displays.

{{Application
|Name=Diamonds
|Categories=game
|Related=
|Homepage=https://github.com/AsteroidOS/asteroid-diamonds
|Description=A 2048 style game for AsteroidOS
|Screenshot=Diamonds.webp
|Status=supported
}}
A 2048 style game. Swipe diagonally to move all tiles in the direction of your swipe, colliding tiles of the same numeric value will add together. The game ends when the screen fills with tiles and there are no more moves left.

{{Application
|Name=Flashlight
|Categories=utility
|Related=
|Homepage=https://github.com/AsteroidOS/asteroid-flashlight
|Description=simple 'flashlight' app that turns your watch screen white
|Screenshot=Flashlight.webp
|Status=supported
}}
A simple 'flashlight' app that turns your watch screen white with a light grey bulb. It serves a secondary use as screen burn in detector on OLED displays. Toggle the 'flashlight' by tapping the screen.

{{Application
|Name=Music
|Categories=utility
|Related=
|Homepage=https://github.com/AsteroidOS/asteroid-music
|Description=A controller for music playing on your phone.
|Screenshot=Music.webp
|Status=supported
}}
A controller for music playing on your phone. The app shows the current track title and artist, and allows you to play and pause, skip tracks and adjust volume.

{{Application
|Name=Settings
|Categories=utility
|Related=
|Homepage=https://github.com/AsteroidOS/asteroid-settings
|Description=A settings app.
|Screenshot=Settings.webp
|Status=supported
}}
The Settings app allows customization of the watch. All changes made in the Settings pages, including subpages like Display, Nightstand, Wallpaper, and Watchface, take effect immediately upon toggling a switch or selecting an item. To preview changes on the Watchface Homescreen, use the top-edge swipe gesture to peek without leaving the Settings app, then reverse the swipe to return..

{{Application
|Name=Stopwatch
|Categories=utility
|Related=
|Homepage=https://github.com/AsteroidOS/asteroid-stopwatch
|Description=a stopwatch app for AsteroidOS
|Screenshot=Stopwatch.webp
|Status=supported
}}
A simple stopwatch app.

{{Application
|Name=Timer
|Categories=utility
|Related=
|Homepage=https://github.com/AsteroidOS/asteroid-timer
|Description=a simple timer app
|Screenshot=Timer.webp
|Status=supported
}}
A simple timer app.

Use the swipe friendly tumbler selectors to adjust a time and start / pause using the button. When a timer is triggered, you can dismiss it by tapping the tick icon or repeat the timer by tapping the repeat icon.

{{Application
|Name=Weather
|Categories=utility, weather
|Related=asteroid-weatherfetch
|Homepage=https://github.com/AsteroidOS/asteroid-weather
|Description=A weather app which shows up to 5 days' worth of data.
|Screenshot=Weather.webp
|Status=supported
}}
A weather app which shows up to 5 days' worth of data.

The app gets data from a paired device. If you are unable to pair your watch to a smartphone, it is possible to use Beroset's Asteroid-Weatherfetch to fetch data by connecting your watch to the internet.

== Preinstalled on some watches ==
These applications will only come on watches that have appropriate hardware. They can also be installed on watches without the correct hardware, but may not work correctly.

{{Application
|Name=Compass
|Categories=utility
|Related=
|Homepage=https://github.com/AsteroidOS/asteroid-compass
|Description=a compass app for AsteroidOS
|Screenshot=Compass.webp
|Status=supported
}}
A basic compass app, which shows cardinal directions around the perimeter and a numeric heading in the middle of the screen.

{{Application
|Name=Heart Rate Monitor
|Categories=utility, health
|Related=asteroid-health
|Homepage=https://github.com/AsteroidOS/asteroid-hrm
|Description=shows the current reading from the heartrate sensor
|Screenshot=Heart Rate Monitor.webp
|Status=supported
}}
A basic application that shows the current reading from the heartrate sensor. The previous reading is shown with an arrow to the left of the current reading. This will move to indicate whether the current reading is lower or higher than the previous.

Make sure to have your watch strapped firmly to your wrist in order to get the best reading. However, do not overtighten it beyond what is comfortable.

== Community ==
These applications are not installed by default but can be installed using <code>opkg</code> as described [[Watchface_and_Package_Installation#Installation_of_prebuilt_packages|here]]. See [[Other Packages]] for CLI programs and other non-graphical tools.

{{Application
|Name=unofficial-watchfaces
|Categories=utility
|Related=
|Homepage=https://github.com/AsteroidOS/unofficial-watchfaces
|Description=collection of unofficial watchfaces for AsteroidOS
|Screenshot=Analog-scientific-v2.webp
|Status=community
}}

A collection of AsteroidOS unofficial watchfaces. Watchface creation in QtQuick is really easy! You can learn how to make your own by following the [[Creating a Watchface|Watchface Creation Guide]]. This is a great place to start getting ideas and examples for your own custom watchface.

{{Application
|Name=asteroid-blaster
|Categories=games
|Related=
|Homepage=https://github.com/eLtMosen/asteroid-blaster
|Description=A tilt-controlled asteroid-shooting frenzy for AsteroidOS smartwatches!
|Screenshot=Asteroid Blaster.jpg
|Status=community
}}
A tilt-controlled asteroid-shooting frenzy for AsteroidOS smartwatches! Survive waves of randomly generated tumbling rocks, rack up points, and avoid collisions with a mix of skill and luck.

Buckle up, space cadets—v1.1 is here with smoother gameplay, slicker visuals, and a dash of dev nostalgia! Since v1.0, we’ve blasted through bugs, tuned the chaos, and polished the experience.

{{Application
|Name=asteroid-dodger
|Categories=games
|Related=
|Homepage=https://github.com/eLtMosen/asteroid-dodger
|Description=Asteroid Dodger, a small action packed game for AsteroidOS
|Screenshot=Asteroid Dodger.jpg
|Status=community
}}
Asteroid-Dodger is a thrilling survival game where you tilt your watch to surf through an ever-denser asteroid field, nailing asteroid surfing combos for big points. Master the art of near-misses and grab rare power-up potions to shrink, speed up, or freeze the cosmic chaos—all while the challenge ramps up with each level. With its retro arcade flair, vibrant visuals, and accelerometer-driven action, this game turns your wrist into a playground of skill and reflexes.

{{Application
|Name=asteroid-health
|Categories=utility, health
|Related=
|Homepage=https://git.dodorad.io/dodoradio/asteroid-health
|Description=track user's steps, heartrate and optionally weight
|Screenshot=Asteroid Health.jpg
|Status=community
}}
asteroid-health is an application that tracks the user's steps, heartrate and optionally weight. It uses [https://git.dodorad.io/dodoradio/asteroid-sensorlogd asteroid-sensorlogd] as the underlying engine that reads the data and stores it on the watch. Unlike many commercial health applications, asteroid-health '''NEVER''' sends your data to the cloud or to any third party.

{{Application
|Name=asteroid-map
|Categories=utility
|Related=
|Homepage=https://git.dodorad.io/dodoradio/asteroid-map/about
|Description=A map app for AsteroidOS
|Screenshot=Asteroid-map.jpg
|Status=community
}}
A map app for AsteroidOS that's targeted at small and round displays, and devices with limited connectivity.

{{Application
|Name=asteroid-qmltester
|Categories=utility, developer
|Related=
|Homepage=https://github.com/MagneFire/asteroid-qmltester.git
|Description=Asteroid's qmltester app
|Screenshot=qmltester.jpg
|Status=community
}}
Asteroid's qmltester app

This is an application that allows a developer to quickly try out QML designs on the watch without needing to write an entire application.

{{Application
|Name=asteroid-skedaddle
|Categories=utility, health
|Related=asteroid-health
|Homepage=https://github.com/beroset/asteroid-skedaddle
|Description=A runner's logging app
|Screenshot=Skedaddle.jpg
|Status=community
}}
In English "skedaddle" is verb meaning "to run off hastily." asteroid-skedaddle is an running log application that runs on AsteroidOS that tracks distance and time, logging each run to an industry standard [https://www.topografix.com/gpx.asp GPX] file. Note that the watch must have functional GPS (or other satellite positioning) to be fully useful. Unlike many commercial exercise and running applications, asteroid-skedaddle '''NEVER''' sends your data to the cloud or to any third party.

{{Application
|Name=asteroid-weatherfetch
|Categories=utility, weather
|Related=asteroid-weather
|Homepage=https://github.com/beroset/asteroid-weatherfetch.git
|Description=fetch weather forecast data for Weather app
|Screenshot=
|Status=community
}}
This app uses an internet connection from the watch to fetch weather forecast data to be used for the Weather app in AsteroidOS. It also has a command-line version that can be used for scripting.

Quick Start Guide

2025-05-01T22:16:12Z

Mosen: /* Accessing Settings */ remove battery life mention from Convenience features

Welcome to AsteroidOS! This guide will help you set up and personalize your smartwatch after a successful installation. Follow these steps to get started and make the most of your device.

== Initial Setup ==
After booting your watch for the first time, you’ll be guided through a quick setup:
# '''Set your Language, Time, Date, and Timezone''': Adjust these settings as prompted.
# '''Intro Slideshow''': A non-interactive slideshow will introduce you to the UI and swipe gestures. Once it’s done, you’ll land on the Watchface Homescreen with the stock watchface. Hint: You can skip the tutorial slideshow via long press on the arrow/next button

Now, let’s explore your watch!

== Understanding the Interface ==
AsteroidOS uses swipe gestures to navigate. Here’s what each swipe does from the Watchface Homescreen:
=== Homescreen Swipe Gestures ===
* '''Swipe from Top''': Opens the Quick Settings panel (work in progress, more shortcuts coming soon).
* '''Swipe from Left''': Shows notifications synced from your paired phone.
* '''Swipe from Right''': Displays events from the Agenda and Weather apps.
* '''Swipe from Bottom''': Opens the configurable App Launcher.

=== In-App Swipe Gestures ===
When using an app, you can '''swipe from the left edge''' of the screen toward the right to '''go back''' — either to the previous page in the app, or to the launcher if you're already on the app's main screen.

This behavior is consistent across all apps and is a quick way to navigate without needing buttons. Think of it like the "back" gesture on Android phones.

'''Swipe from the top''' will '''close any app''' and return to the Homescreen.

Gestures are real gestures—you don’t need to complete them fully and can pause them. For example, swipe down from the top to close an app but stop halfway to peek at the Watchface Homescreen without leaving the app. Then reverse the swipe to go back to the app. This is super useful when choosing a watchface or wallpaper in Settings, letting you preview how they look on the Watchface Homescreen.

== Synchronizing your watch ==

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

* For Android, the official [https://f-droid.org/packages/org.asteroidos.sync AsteroidOSSync] app provides the best overall experience. [https://f-droid.org/packages/nodomain.freeyourgadget.gadgetbridge Gadgetbridge] is also compatible and is known for a very stable connection, though missing a few features.

* iOS users can receive notifications by pairing the watch with an iPhone, but syncing time or weather is not supported.

* Ubuntu Touch and SailfishOS offer partial support via [https://open-store.io/app/uk.co.piggz.amazfish Amazfish on open-store] and [https://sailfishos-chum.github.io/apps/harbour-amazfish/ Amazfish on chum].

* Desktop users can explore [https://github.com/AsteroidOS/buran Buran], [https://github.com/AsteroidOS/AsteroidOSLinux AsteroidOSLinux], or CLI tools like [https://github.com/AsteroidOS/asteroid-ctrl asteroid-ctrl]. Amazfish is also available for linux desktop via [https://flathub.org/apps/uk.co.piggz.amazfish flathub].

Full details and links are listed here: [[Synchronization Clients]]

==Accessing Settings==
To personalize your watch, head to the Settings page:
*Open the App Launcher (swipe up from the Watchface Homescreen).
*Tap the '''gear icon''' to enter Settings.
*Alternatively, use the Quick Settings shortcut (coming soon).

Settings include subpages like Display, Nightstand, Wallpaper, Watchface, and more. Let’s tweak some key options next.

===Battery Life ===
With a healthy battery, all supported watches typically achieve '''at least 48 hours''' of battery life running AsteroidOS.

Some models with secondary displays can reach '''3 to 5 days'''. However, if you enable features like '''Tilt-to-Wake''', expect runtime to drop — in most cases down to '''30 hours''' or more, depending on usage.

As always, battery life varies by device, usage habits, and power-saving settings. But these two settings are most power hungry:

===Tilt-to-Wake===
*'''What it does''': Wakes the screen when you tilt your wrist.
* '''Battery Impact''': High – it often triggers accidentally.
*'''Recommendation''': Turn it off unless you really need it.
*'''How to adjust''': Go to Settings > Display > Toggle “Tilt-to-Wake” off.

===Always-On Display (AoD)===
*'''What it does''': Keeps the screen on with a low-power watchface.
*'''Battery Impact''':
*High on LCD screens – avoid using it.
* Moderate on OLED screens – safe to use.
*Disable on watches with a secondary display (e.g., hybrid watches) to use the secondary screen instead of the AoD watchface.
*'''How to adjust''': Go to Settings > Display > Toggle “Always-On Display” on/off.

=== Convenience Features ===
Some convenience features enhance usability but need some explanation or may require specific use cases. Consider toggling the following based on your needs:

=== Nightstand ===
* '''What it does''': Activates when the charger is connected, showing a charging ring for at-a-glance charge status and switching to a simplified watchface with a large time display for a clean, night-clock style view.
* '''Recommendation''': It is enabled by default, disable nightstand if you do not use your watch as a bedside clock or do not want the watchhface to be altered when a charger connects. Note that auto-rotation based on watch orientation (e.g., for 90° tilted charger cradles) is not yet supported but is a requested feature.
* '''How to adjust''': Go to Settings > Nightstand > Toggle “Nightstand” on/off.

=== Burn-in Offset ===
* '''What it does''': Periodically shifts the Always-On Display (AoD) watchface to prevent OLED screen burn-in, protecting your display over time.
* '''Recommendation''': Keep enabled for OLED watches using AoD to avoid burn-in. It may seem like a bug due to the shifting, but it’s intentional. Future updates will offer low, mid, and high offset options for less noticeable shifts.
* '''How to adjust''': Go to Settings > Display > Toggle “Burn-in Offset” on/off.

==Connect Your Watch to the Internet==
To unlock more features like updates and app installation, connect your computer to your watch via SSH or ADB by enabling either of them in the settings app -> USB.
Use a computer or phone with ADB (Android Debug Bridge from the Google Platform Tools):<syntaxhighlight lang="shell">
adb shell
</syntaxhighlight>or an SSH client to connect to your watch via USB.
For SSH, follow the [[SSH|SSH guide]].

When connected to the watch, establish an IP Connection by following the [[IP_Connection|IP Connection guide]].

With an IP connection established, you can:

===Update AsteroidOS===
*Keep your watch up-to-date with the latest features and fixes using: <syntaxhighlight lang="shell">opkg update && opkg upgrade</syntaxhighlight>
*See the [[Updating AsteroidOS|Updating AsteroidOS guide]] for instructions.

===Install Apps===
*Add community-provided apps via the command line.
*Check the [[Applications|Applications guide]] for details.
*Install apps using: <syntaxhighlight lang="shell">opkg install name-of-the-app</syntaxhighlight>

=== Customize Watchfaces ===
*Install community watchfaces to match your style.
*Follow the [[Watchface_and_Package_Installation|Watchface Installation guide]].

==What's next ==
*Experiment with Settings to find what works best for you.
* <big>'''Visit the [[Frequently_Asked_Questions_(FAQ)|FAQ pages]]'''</big> if you’re curious about pre-install details or troubleshooting.

===Hack, Tinker, Contribute===
AsteroidOS is built by enthusiasts for enthusiasts — and you're encouraged to make it your own!

Whether you want to customize watchfaces, write your own apps in QML/Qt, explore via SSH, or even contribute code, everything is open and waiting for your ideas.

You can explore the source code, report issues, or get involved at: [https://github.com/AsteroidOS github.com/AsteroidOS]

===Join the Community Chat===
Got questions, want to share progress, or just hang out with fellow AsteroidOS users and developers?

Join us on Matrix at [https://matrix.to/#/#Asteroid:matrix.org #Asteroid:matrix.org] — we’re a friendly bunch and always happy to help or chat about smartwatch hacking!

Enjoy your AsteroidOS smartwatch!

Quick Start Guide

2025-05-01T22:06:25Z

Mosen: /* Accessing Settings */ Add explantion for burn in offset and nightstand in new paragraph Convenience features

Welcome to AsteroidOS! This guide will help you set up and personalize your smartwatch after a successful installation. Follow these steps to get started and make the most of your device.

== Initial Setup ==
After booting your watch for the first time, you’ll be guided through a quick setup:
# '''Set your Language, Time, Date, and Timezone''': Adjust these settings as prompted.
# '''Intro Slideshow''': A non-interactive slideshow will introduce you to the UI and swipe gestures. Once it’s done, you’ll land on the Watchface Homescreen with the stock watchface. Hint: You can skip the tutorial slideshow via long press on the arrow/next button

Now, let’s explore your watch!

== Understanding the Interface ==
AsteroidOS uses swipe gestures to navigate. Here’s what each swipe does from the Watchface Homescreen:
=== Homescreen Swipe Gestures ===
* '''Swipe from Top''': Opens the Quick Settings panel (work in progress, more shortcuts coming soon).
* '''Swipe from Left''': Shows notifications synced from your paired phone.
* '''Swipe from Right''': Displays events from the Agenda and Weather apps.
* '''Swipe from Bottom''': Opens the configurable App Launcher.

=== In-App Swipe Gestures ===
When using an app, you can '''swipe from the left edge''' of the screen toward the right to '''go back''' — either to the previous page in the app, or to the launcher if you're already on the app's main screen.

This behavior is consistent across all apps and is a quick way to navigate without needing buttons. Think of it like the "back" gesture on Android phones.

'''Swipe from the top''' will '''close any app''' and return to the Homescreen.

Gestures are real gestures—you don’t need to complete them fully and can pause them. For example, swipe down from the top to close an app but stop halfway to peek at the Watchface Homescreen without leaving the app. Then reverse the swipe to go back to the app. This is super useful when choosing a watchface or wallpaper in Settings, letting you preview how they look on the Watchface Homescreen.

== Synchronizing your watch ==

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

* For Android, the official [https://f-droid.org/packages/org.asteroidos.sync AsteroidOSSync] app provides the best overall experience. [https://f-droid.org/packages/nodomain.freeyourgadget.gadgetbridge Gadgetbridge] is also compatible and is known for a very stable connection, though missing a few features.

* iOS users can receive notifications by pairing the watch with an iPhone, but syncing time or weather is not supported.

* Ubuntu Touch and SailfishOS offer partial support via [https://open-store.io/app/uk.co.piggz.amazfish Amazfish on open-store] and [https://sailfishos-chum.github.io/apps/harbour-amazfish/ Amazfish on chum].

* Desktop users can explore [https://github.com/AsteroidOS/buran Buran], [https://github.com/AsteroidOS/AsteroidOSLinux AsteroidOSLinux], or CLI tools like [https://github.com/AsteroidOS/asteroid-ctrl asteroid-ctrl]. Amazfish is also available for linux desktop via [https://flathub.org/apps/uk.co.piggz.amazfish flathub].

Full details and links are listed here: [[Synchronization Clients]]

==Accessing Settings==
To personalize your watch, head to the Settings page:
*Open the App Launcher (swipe up from the Watchface Homescreen).
*Tap the '''gear icon''' to enter Settings.
*Alternatively, use the Quick Settings shortcut (coming soon).

Settings include subpages like Display, Nightstand, Wallpaper, Watchface, and more. Let’s tweak some key options next.

===Battery Life ===
With a healthy battery, all supported watches typically achieve '''at least 48 hours''' of battery life running AsteroidOS.

Some models with secondary displays can reach '''3 to 5 days'''. However, if you enable features like '''Tilt-to-Wake''', expect runtime to drop — in most cases down to '''30 hours''' or more, depending on usage.

As always, battery life varies by device, usage habits, and power-saving settings. But these two settings are most power hungry:

===Tilt-to-Wake===
*'''What it does''': Wakes the screen when you tilt your wrist.
* '''Battery Impact''': High – it often triggers accidentally.
*'''Recommendation''': Turn it off unless you really need it.
*'''How to adjust''': Go to Settings > Display > Toggle “Tilt-to-Wake” off.

===Always-On Display (AoD)===
*'''What it does''': Keeps the screen on with a low-power watchface.
*'''Battery Impact''':
*High on LCD screens – avoid using it.
* Moderate on OLED screens – safe to use.
*Disable on watches with a secondary display (e.g., hybrid watches) to use the secondary screen instead of the AoD watchface.
*'''How to adjust''': Go to Settings > Display > Toggle “Always-On Display” on/off.

=== Convenience Features ===
Some convenience features enhance usability but need some explanation or may require specific use cases. Consider toggling the following based on your needs:

=== Nightstand ===
* '''What it does''': Activates when the charger is connected, showing a charging ring for at-a-glance charge status and switching to a simplified watchface with a large time display for a clean, night-clock style view.
* '''Battery Impact''': Minimal – only active while charging.
* '''Recommendation''': It is enabled by default, disable nightstand if you do not use your watch as a bedside clock or do not want the watchhface to be altered when a charger connects. Note that auto-rotation based on watch orientation (e.g., for 90° tilted charger cradles) is not yet supported but is a requested feature.
* '''How to adjust''': Go to Settings > Nightstand > Toggle “Nightstand” on/off.

=== Burn-in Offset ===
* '''What it does''': Periodically shifts the Always-On Display (AoD) watchface to prevent OLED screen burn-in, protecting your display over time.
* '''Battery Impact''': Negligible – designed to work with AoD efficiently.
* '''Recommendation''': Keep enabled for OLED watches using AoD to avoid burn-in. It may seem like a bug due to the shifting, but it’s intentional. Future updates will offer low, mid, and high offset options for less noticeable shifts.
* '''How to adjust''': Go to Settings > Display > Toggle “Burn-in Offset” on/off.

==Connect Your Watch to the Internet==
To unlock more features like updates and app installation, connect your computer to your watch via SSH or ADB by enabling either of them in the settings app -> USB.
Use a computer or phone with ADB (Android Debug Bridge from the Google Platform Tools):<syntaxhighlight lang="shell">
adb shell
</syntaxhighlight>or an SSH client to connect to your watch via USB.
For SSH, follow the [[SSH|SSH guide]].

When connected to the watch, establish an IP Connection by following the [[IP_Connection|IP Connection guide]].

With an IP connection established, you can:

===Update AsteroidOS===
*Keep your watch up-to-date with the latest features and fixes using: <syntaxhighlight lang="shell">opkg update && opkg upgrade</syntaxhighlight>
*See the [[Updating AsteroidOS|Updating AsteroidOS guide]] for instructions.

===Install Apps===
*Add community-provided apps via the command line.
*Check the [[Applications|Applications guide]] for details.
*Install apps using: <syntaxhighlight lang="shell">opkg install name-of-the-app</syntaxhighlight>

=== Customize Watchfaces ===
*Install community watchfaces to match your style.
*Follow the [[Watchface_and_Package_Installation|Watchface Installation guide]].

==What's next ==
*Experiment with Settings to find what works best for you.
* <big>'''Visit the [[Frequently_Asked_Questions_(FAQ)|FAQ pages]]'''</big> if you’re curious about pre-install details or troubleshooting.

===Hack, Tinker, Contribute===
AsteroidOS is built by enthusiasts for enthusiasts — and you're encouraged to make it your own!

Whether you want to customize watchfaces, write your own apps in QML/Qt, explore via SSH, or even contribute code, everything is open and waiting for your ideas.

You can explore the source code, report issues, or get involved at: [https://github.com/AsteroidOS github.com/AsteroidOS]

===Join the Community Chat===
Got questions, want to share progress, or just hang out with fellow AsteroidOS users and developers?

Join us on Matrix at [https://matrix.to/#/#Asteroid:matrix.org #Asteroid:matrix.org] — we’re a friendly bunch and always happy to help or chat about smartwatch hacking!

Enjoy your AsteroidOS smartwatch!

Watch Feature List

2025-04-12T03:39:12Z

Mosen: Undo revision 680 by Mosen (talk)

__NOTOC__
In the table below, the values given for ''individual watch features'' are one of the following values:

'''good''' - The hardware exists and is working

'''bad''' - The hardware exists and is NOT working

'''missing''' - The hardware does not exist

'''partial''' - The hardware exists but is only partially working

'''unknown''' - The hardware exists but the status is unknown

For the ''overall status'' of a watch port there are three values:

'''supported''' - The watch is reasonably well implemented and many features work

'''experimental''' - The watch is partially working but not recommended

'''port in progress''' - As the name suggests, there is some work being done but it is not yet complete

<div style="width: 100%; overflow-x: scroll;">
{{#cargo_query:
tables=Watches
|fields=CONCAT("[[",_pageName,"|",Model,"]]")=Model,Name,Status,Stars,StatusDisplay=Display,StatusTouch=Touch,StatusBluetooth=Bluetooth,StatusHaptics=Haptics,StatusTiltToWake=Tilt To Wake,StatusLightSensor=Light Sensor,StatusAlwaysOnDisplay=Always On Display,StatusDualDisplay=Dual Display,StatusMicrophone=Microphone,StatusSpeaker=Speaker,StatusCompass=Compass,StatusSteps=Step Counter,StatusHeartRate=Heart rate,StatusUSB=USB,StatusWLAN=WLAN,StatusGPS=GPS,StatusNFC=NFC,StatusCellular=Cellular,StatusCamera=Camera,StatusCrown=Crown,StatusHands=Hands
|order by=Watches.Stars DESC
|format=table
|limit=9999
|more results text=
}}
</div>

Watch Feature List

2025-04-12T03:31:05Z

Mosen: Implement static first column for better overview

<div class="scrollable-table-container" style="position: relative; overflow: hidden;">
<div class="fixed-column" style="position: absolute; left: 0; width: 200px; background-color: white; z-index: 2; border-right: 2px solid #ccc; overflow: hidden;">
{{#cargo_query:
tables=Watches
|fields=CONCAT("[[",_pageName,"|",Model,"]]")=Model
|order by=Watches.Stars DESC
|format=table
|limit=9999
|more results text=
}}
</div>
<div class="scrollable-area" style="overflow-x: auto; margin-left: 200px;">
{{#cargo_query:
tables=Watches
|fields=Name,Status,Stars,StatusDisplay=Display,StatusTouch=Touch,StatusBluetooth=Bluetooth,StatusHaptics=Haptics,StatusTiltToWake=TiltToWake,StatusLightSensor=LightSensor,StatusAlwaysOnDisplay=AlwaysOnDisplay,StatusDualDisplay=DualDisplay,StatusMicrophone=Microphone,StatusSpeaker=Speaker,StatusCompass=Compass,StatusSteps=StepCounter,StatusHeartRate=HeartRate,StatusUSB=USB,StatusWLAN=WLAN,StatusGPS=GPS,StatusNFC=NFC,StatusCellular=Cellular,StatusCamera=Camera,StatusCrown=Crown,StatusHands=Hands
|order by=Watches.Stars DESC
|format=table
|limit=9999
|more results text=
}}
</div>
</div>

Documentation

2025-04-12T02:45:55Z

Mosen: /* For Users: */ Add new Quick Start Guide to top of user section

* [[Code of Conduct]]
* [[Frequently Asked Questions (FAQ)]]
* [[:Category:Watches|Watches]]
* [[Watch Feature List]]
* [[Watch Support Level|Watch Support Level Rating System]]

=== For Users: ===
* [[Quick Start Guide]]
* [[Applications]]
* [[Synchronization Clients]]
* [[SSH]]
* [[Watchface and Package Installation]]
* [[Backup Guide]]
* [[IP Connection]]
* [[Useful Commands]]
* [[Porting Status]]
* [[Updating AsteroidOS]]
* [[Translating AsteroidOS]]
* [[Licenses]]

=== For Developers: ===
* [[Building AsteroidOS]]
* [[Building the SDK]]
* [[Installing the SDK]]
* [[Creating an Asteroid app]]
* [[Debugging Applications]]
* [[Creating a Watchface]]
* [[Emulator]]
* [[Local version of asteroidos.org]]
* [[Bluetooth]]
* [[BLE profiles]]

=== For Porters: ===
* [[Porting Guide]]
* [[OpenEmbedded]]
* [[Boot Process]]
* [[Graphic Stack]]
* [[Technical Details of AsteroidOS Watches]]