Watchfaces listed in the unofficial-watchface collection bring their own installation script.
To use the script you will need to clone the unofficial-watchfaces repo.
Execute the script with no flag to use SSH connection and SCP commands.
Or use ADB connection and commands with the -a flag.
If you wish to install a watchface that has no installation script or is not provided as a package you may install it manually using the following instructions.
Installing a watchface requires pushing the .qml file and the required assets (e.g.
fonts, images, etc.) into the
/usr/share/asteroid-launcher/watchfaces/ directory on your watch.
scp watchface-name.qml firstname.lastname@example.org:/usr/share/asteroid-launcher/watchfaces/
If the watchface has additional dependencies on assets you can push them the same way.
scp image.png email@example.com:/usr/share/asteroid-launcher/watchfaces-img/
Some watchfaces include their own font.
scp fontname.ttf firstname.lastname@example.org:/usr/share/fonts/
The scripts provided in the asteroid-wallpapers repo aim to make adding custom wallpapers easy.
To use the script you will need to clone the asteroid-wallpapers repo.
Place jpg, jpeg, png, svg, bmp or webp wallpaper images of at least 480x480px resolution here. Then generate preview images and copy scaled versions of your wallpapers to the correct folders.
Copy all wallpapers and preview images to a watch connected via USB/SDK Mode:
For advanced copy options execute:
In case you wish to quickly install a wallpaper that is not provided as a package, you can install it manually using the following command. Mind that copying a large image file might impact overall performance. Usage of the above described scripted method is highly advised.
scp wallpapername.jpg email@example.com:/usr/share/asteroid-launcher/wallpapers/full/
While AsteroidOS has a package manager, there is currently no graphical app store.
Installation of local packages
Before you can install the package you need to push it to the watch.
After that you can use SSH to login and install the package
scp packagename.ipk firstname.lastname@example.org:/home/root
When the package is installed you can remove the installation package from your root users home-directory and close the SSH connection to your watch.
opkg install packagename.ipk
Reinstallation of local packages
If you need to reinstall a package you can add the
--force-reinstall flag to the opkg command.
opkg install --force-reinstall packagename.ipk
Missing dependencies detected during package install
The package you are trying to install may depend on other packages and their versions. You can install the
dependencies first, add the
--force-depends flag to your install command or decide to not install the
package. Ignoring the dependencies can lead to broken or unstable packages.
opkg install --force-depends packagename.ipk