Code of Conduct

We believe that our mission is best served in an environment that is friendly, safe, and accepting; free from intimidation or harassment. Towards this end, certain behaviors and practices will not be tolerated. tl;dr Be respectful. We’re here to help: Abusive behavior is never tolerated. Violations of this code may result in swift and...

Licenses

An AsteroidOS image is made of plenty of components and it’s hard to describe the full details of the licenses that are in used in the system. When building the system from sources with OpenEmbedded, one can find the exhaustive set of licenses in the build/tmp-glibc/deploy/licenses directory. In order to give a very general...

Building AsteroidOS

If you decide to compile AsteroidOS from source be aware that it’s a simple process but the first build might take you a lot of time. Report any problem to the issues tracker: Building Start by cloning the main repository using the following command: git clone https://github.com/AsteroidOS/asteroid.git cd asteroid/ This repository only contains a...

Translating AsteroidOS

AsteroidOS translations, aside from the app name, are managed through Weblate, a Free/Open Source web translation platform. To be able to use it, you will have to register an account, although you can also log in through a few popular third-party services. The rest of this page assumes you have an account. Updating translations...

Watchfaces creation

Watchface creation is fairly simple, requiring only QML knowledge. This guide will walk you through the steps. Preparing watchface creation First, clone the https://github.com/AsteroidOS/asteroid-launcher repository as it contains all watchfaces. Then, navigate to the watchfaces directory. In here, copy 000-default-digital.qml to a new file to use as a base for watchface creation. Testing your...

Creating an Asteroid App

The app creation process of AsteroidOS needs a Software Development Kit generated by OpenEmbedded. You can either grab a prebuilt SDK here (this is a self-contained script) and install it on your system or you can build it yourself as follow. Building the Cross compilation Toolchain If you’ve already got an OpenEmbedded build directory...

Porting Status

This page aims at gathering info about the currently supported platforms and porting efforts. Android Wear The Android Wear smartwatches are the most widespread and easy to support. The source code of their kernels is usually easily available and the drivers can be supported with libhybris. Those watches are the current priority of AsteroidOS....

Porting Guide

In order to quickly support Android Wear smartwatches, Asteroid is built upon libhybris a component that allows us to reuse Android Wear’s drivers. That’s why the first step in porting Asteroid to a new watch is to build an Android /system directory. To boot the device, we also use a modified Android Linux kernel...

TODO List

AsteroidOS is a large project and involves many activities. Here is a list of some of the things that should be done in the future. If you want to get started with one of those tasks, get in touch with us via IRC on #asteroid@irc.freenode.net and take a look at the “Building AsteroidOS” and...

SSH

By default, you can get a remote shell on you smartwatch with the Android Debug Bridge tool and the “adb shell” command. However this shell suffers from a many limitations and you might prefer to get a standard SSH connection. To do so you need to setup a TCP connection with your watch. The...