Frequently Asked Questions (FAQ)

What is AsteroidOS?

AsteroidOS is an open source Linux distribution that runs on many different smartwatches. It uses Qt and QML to provide the graphical interface.

One of the main goals of AsteroidOS is to provide users with greater control over their devices and data privacy. The operating system is fully customizable, and users can modify it to meet their specific needs.

Which features are provided?

Currently, AsteroidOS has these features available:

- Always-on-Display

- Tilt-to-Wake

- Palm-to-Sleep

- Phone notifications

- Multiple app launcher styles

- Wallpapers

- Community watchfaces

- Nightstand mode

Are any apps preinstalled?

The following apps are delivered with an AsteroidOS installation:

- Agenda, a calendar

- Alarm clock

- Calculator

- Compass

- Diamonds game

- Flashlight

- Heartrate check

- Music, a media remote control

- Settings

- Stopwatch

- Timer

- Weather forecast

Does an app store exist?

A store to install apps does not yet exist. But this is something that is being considered for future implementation. There are a number of contributed apps that are not installed in the default image. These can be installed manually if desired.

How can I connect the watch to my phone?

A phone is not required to use AsteroidOS, but several convenient functions are available when an AsteroidOS watch is paired with one of the synchronization clients listed in the documentation. A synchronization client is generically what we call software that runs on a phone or computer that knows how to talk via Bluetooth to an AsteroidOS device.

- Android users can use "AsteroidOSSync" which is available for download on F-Droid. Or try Gadgetbridge from F-Droid with initial AsteroidOS support. Mind that on Android 13 and later devices, you will need to manually enable "restricted notification access". The option is hidden behind the three dot menu in app-info.

- Ubuntu Touch users can download Telescope" from OpenStore

- There is currently no app for iPhone, however notifications can be shared from an iPhone to the watch. See this page for details.

What features and apps does AsteroidOS not provide?

There are a great many more ideas for apps than apps at the moment. Some of the more commonly requested, but not yet available applications and features are:

- Call answering from the watch

- Fitness and health tracking application (step counter, ongoing heartrate monitor, etc.)

- Support for using the watch as a phone (for some watches that incorporate a cellular phone chip)

- And many more

Some of these are being worked on, and others are just ideas at this point. If you think you might like to contribute, see our GitHub repository and the Contact page. There are many opportunities for creativity!

Is AsteroidOS based on Android?

No. AsteroidOS uses libhybris to simplify porting to most Android and WearOS watches, but it is not Android nor is it WearOS or a derivative of either.

Hardware drivers on modern smartwatches are specifically tailored for Android and WearOS devices. These drivers are closely tied to the hardware and are not compatible with other operating systems, which usually makes porting to alternative platforms a complex and time-consuming process. Libhybris allows AsteroidOS to leverage the proprietary binary drivers and thus greatly helps porting Linux to Android based hardware.

Can I run WearOS applications?

No. WearOS is a version of Android that runs on wearable devices. AsteroidOS is a Linux distribution that does not run Android and therefore cannot run either Android or WearOS applications.

What is different to WearOS?

One significant difference is that AsteroidOS is open source software, while WearOS is not. That is, if you want to change something and you are a developer, you can build the software yourself. Or perhaps you would like to create your own watchface.

Another significant difference is that AsteroidOS, unlike WearOS, tries to make the watch usable without pairing it with a phone. In contrast, WearOS watches only run when they are paired with a phone.

Does AsteroidOS have any tracking features?

No. AsteroidOS does not collect any tracking data and you don't need to use or establish any accounts to use it. Nothing on the default installation is able to connect to the internet. While it is possible to connect an AsteroidOS watch to the internet this must be explicitly done by the user.

Can my watch run AsteroidOS?

Maybe. Check the Watches page. It lists all devices supported by AsteroidOS. The star rating indicates the current level of support for each device's hardware features. Watches with at least 3 stars can be considered suitable for everyday use.

My watch isn't listed.

Maybe you can still run Asteroid OS in the future. See the porting status page for details on what kinds of watches might be supported in the future and what the general requirements are for running AsteroidOS.

If you are interested in porting AsteroidOS to a new watch yourself, please read the Porting Guide page and contact us via our matrix channel in case of possible questions.

Which features of my watch are currently supported?

The available AsteroidOS features depend on the watch you want to use. Review the table on the installation page for your device to get detailed support information.

Or check the features table to see a matrix of all AsteroidOS watches and their feature support.

Will I be able to revert to the previous operating system?

Yes, very easily if you choose the "temporary install" option.

For most watches, you may choose to only temporarily install AsteroidOS alongside the existing OS, called a "dual-boot". When doing so, the asteroidos.ext4 image is pushed to the userdata partition using ADB. With no alteration to the previous OS. The downside of this method being, AsteroidOS needs to be manually booted using fastboot boot boot-image.fastboot while connected via USB, after every reboot or shutdown. Else, the previous OS will start up as usual.

In case you decide to replace your previous OS using the full install method, to make the watch boot into AsteroidOS without manual intervention. It is advised that you make a backup of your entire watch before flashing AsteroidOS. Only then, you will be able to re-flash those backups to restore the previous OS later.

When can I expect updates?

The complete rebuild of all packages for all Watch system images and architectures takes almost a week. The build process is started at the beginning of a week. Therefore, it can be expected that new nightlies will be available on the weekend. These will contain all the changes that have been merged up to the start of the build process.

Can I compile AsteroidOS myself?

If you do not want to flash a prebuilt image onto your watch or wait for the nightlies to be updated, review the Building AsteroidOS page for detailed instructions on how to compile AsteroidOS yourself.

My question is not answered.

There are many additional resources. The Documentation page should be your first stop. It has a lot of useful information about both using and developing for AsteroidOS. If you can't find your answer on this web site, see Contact.