Useful Commands - Revision history

Brahms: update fastboot instructions for pixel watch 3

2025-10-29T09:22:54Z

update fastboot instructions for pixel watch 3

← Older revision		Revision as of 09:22, 29 October 2025
Line 112:		Line 112:


	==== Firefish, Ray====		==== Firefish, Ray, Seluna, Solios ====
	After the watch stops vibrating on startup, immediately touch the top/left & bottom/right of the screen and press the middle button while the manufacturer logo displays.		After the watch stops vibrating on startup, immediately touch the top/left & bottom/right of the screen and press the middle button while the manufacturer logo displays.

Jrt: systemctl --force reboot bootloader doesn't work anymore. systemd has a reboot argument that gets passed to the reboot syscall. Passing "bootloader" works as before and doesn't require the --force anymore

2025-10-25T09:51:16Z

systemctl --force reboot bootloader doesn't work anymore. systemd has a reboot argument that gets passed to the reboot syscall. Passing "bootloader" works as before and doesn't require the --force anymore

← Older revision		Revision as of 09:51, 25 October 2025
Line 86:		Line 86:
	<pre>reboot</pre>		<pre>reboot</pre>
	Restart the watch in bootloader mode:		Restart the watch in bootloader mode:
	<pre>systemctl --~~force~~ reboot bootloader</pre>		<pre>systemctl reboot --reboot-argument=bootloader</pre>
	Restart the watch in recovery mode:		Restart the watch in recovery mode:
	<pre>systemctl --~~force~~ reboot recovery</pre>		<pre>systemctl reboot --reboot-argument=recovery</pre>

	== Time zone, date & time ==		== Time zone, date & time ==

MagneFire: Fix copy code for sections: USB, Screen and Restart

2023-12-10T19:49:45Z

Fix copy code for sections: USB, Screen and Restart

← Older revision		Revision as of 19:49, 10 December 2023
Line 59:		Line 59:
	In AsteroidOS, the USB mode is handled by a daemon named usb_moded. This daemon offers a DBus interface that is exposed to the GUI by asteroid-launcher and asteroid-settings. However, usb_moded also comes with a command named <code>usb_moded_util</code> to control this DBus interface from the command line.		In AsteroidOS, the USB mode is handled by a daemon named usb_moded. This daemon offers a DBus interface that is exposed to the GUI by asteroid-launcher and asteroid-settings. However, usb_moded also comes with a command named <code>usb_moded_util</code> to control this DBus interface from the command line.

	~~<code>usb_moded_util -m # Returns~~ a list of supported modes~~</code>~~		Return a list of supported modes:
	<~~code~~>usb_moded_util -~~q #Shows~~ the currently used USB mode~~</code>~~		<pre>usb_moded_util -m</pre>
	<~~code~~>usb_moded_util -~~s adb_mode #~~Set USB to the ADB Mode</~~code~~>		Show the currently used USB mode:
			<pre>usb_moded_util -q</pre>
			Set USB to the ADB Mode:
			<pre>usb_moded_util -s adb_mode</pre>

	== Screen ==		== Screen ==
Line 67:		Line 70:
	A daemon named MCE is in charge of handling various screen related behaviors. For example, MCE handles the device locking, the tap to unlock, the current brightness, fading and dimming and others.... It can be controlled thanks to a CLI tool named <code>mcetool</code>.		A daemon named MCE is in charge of handling various screen related behaviors. For example, MCE handles the device locking, the tap to unlock, the current brightness, fading and dimming and others.... It can be controlled thanks to a CLI tool named <code>mcetool</code>.

	~~<code>mcetool # Displays~~ the current state of various variables</~~code~~>		Display the current state of various variables:
	~~<code>mcetool -D on # Enables~~ "demo mode": screen stays on</~~code~~>		<pre>mcetool</pre>
	<~~code~~>mcetool -M disabled ~~# Disables the tap to unlock functionality~~</~~code~~>		Enable "demo mode": screen stays on:
			<pre>mcetool -D on</pre>
			Disable the tap to unlock functionality:
			<pre>mcetool -M disabled</pre>

	== Restart ==		== Restart ==
Line 75:		Line 81:
	Systemd is the init system used by AsteroidOS. It is controlled by a command named <code>systemctl</code>. This command can be used to restart the user session or the entire system into a different mode.		Systemd is the init system used by AsteroidOS. It is controlled by a command named <code>systemctl</code>. This command can be used to restart the user session or the entire system into a different mode.

	~~<code>systemctl restart user@1000 # Restarts~~ the ceres session (including the entire UI)</~~code~~>		Restart the ceres session (including the entire UI):
	~~<code>reboot #~~ Simply reboot your watch</~~code~~>		<pre>systemctl restart user@1000</pre>
	<~~code~~>systemctl --force reboot bootloader ~~# Restarts~~ the watch in ~~bootloader~~ mode~~</code>~~		Simply reboot your watch:
	<~~code~~>systemctl --force reboot recovery ~~# Restarts the watch in recovery mode~~</~~code~~>		<pre>reboot</pre>
			Restart the watch in bootloader mode:
			<pre>systemctl --force reboot bootloader</pre>
			Restart the watch in recovery mode:
			<pre>systemctl --force reboot recovery</pre>

	== Time zone, date & time ==		== Time zone, date & time ==

Beroset: /* Time zone, date & time */ fix time setting command

2023-09-05T20:18:38Z

Time zone, date & time: fix time setting command

← Older revision		Revision as of 20:18, 5 September 2023
Line 85:		Line 85:

	<pre>ssh root@192.168.2.15 "timedatectl set-timezone <continent>/<zone>"</pre>		<pre>ssh root@192.168.2.15 "timedatectl set-timezone <continent>/<zone>"</pre>
	<pre>ssh root@192.168.2.15 "date -s @~~<code>~~(date -u +"%s" )~~</code>~~"</pre>		<pre>ssh root@192.168.2.15 "date -s @`(date -u +"%s" )`"</pre>

	= Boot to fastboot (bootloader) menu =		= Boot to fastboot (bootloader) menu =

Mosen: /* Nemo */ add triggerfish

2023-09-05T19:03:23Z

Nemo: add triggerfish

← Older revision		Revision as of 19:03, 5 September 2023
Line 106:		Line 106:


	==== Nemo====		==== Nemo, triggerfish====
	Power down the watch. Keep holding the lower button while powering on the device.		Power down the watch. Keep holding the lower button while powering on the device.

Mosen: /* Catfish, Skipjack */ add hoki fastboot combo

2023-08-30T13:33:21Z

Catfish, Skipjack: add hoki fastboot combo

← Older revision		Revision as of 13:33, 30 August 2023
Line 98:		Line 98:


	==== Catfish, Skipjack====		==== Catfish, hoki, Skipjack====
	Power down the watch. Keep holding both buttons during the boot process until the fastboot menu appears.		Power down the watch. Keep holding both buttons during the boot process until the fastboot menu appears.

Mosen: /* Firefish */ Add ray since the method works there too. Tested just now.

2023-08-11T13:43:52Z

Firefish: Add ray since the method works there too. Tested just now.

← Older revision		Revision as of 13:43, 11 August 2023
Line 102:		Line 102:


	==== Firefish====		==== Firefish, Ray====
	After the watch stops vibrating on startup, immediately touch the top/left & bottom/right of the screen and press the middle button while the manufacturer logo displays.		After the watch stops vibrating on startup, immediately touch the top/left & bottom/right of the screen and press the middle button while the manufacturer logo displays.

Mosen: /* Boot to fastboot (bootloader) menu */ Add Nemo

2023-07-04T22:13:51Z

Boot to fastboot (bootloader) menu: Add Nemo

← Older revision		Revision as of 22:13, 4 July 2023
Line 104:		Line 104:
	==== Firefish====		==== Firefish====
	After the watch stops vibrating on startup, immediately touch the top/left & bottom/right of the screen and press the middle button while the manufacturer logo displays.		After the watch stops vibrating on startup, immediately touch the top/left & bottom/right of the screen and press the middle button while the manufacturer logo displays.


			==== Nemo====
			Power down the watch. Keep holding the lower button while powering on the device.

Mosen at 22:09, 4 July 2023

2023-07-04T22:09:54Z

← Older revision		Revision as of 22:09, 4 July 2023
Line 8:		Line 8:
	On AsteroidOS a useful command named <code>notificationtool</code> is provided that allows you to create/update/close/list notifications from the CLI.		On AsteroidOS a useful command named <code>notificationtool</code> is provided that allows you to create/update/close/list notifications from the CLI.

			Following example creates a new notification with various parameters
	<pre>		<pre>
	~~# Creates a new notification with various parameters~~
	notificationtool -o add \		notificationtool -o add \
	--icon=ios-happy \		--icon=ios-happy \
Line 25:		Line 25:
	AsteroidOS uses an <code>invoker</code> to launch apps. The invoker is used to allow for quicker app startup by caching many of the Qt components into memory.		AsteroidOS uses an <code>invoker</code> to launch apps. The invoker is used to allow for quicker app startup by caching many of the Qt components into memory.

			This example launches the alarm clock app using the invoker and hides the title bar.
			Ensure that this command is executed under the <code>ceres</code> user.
	<pre>		<pre>
	~~# Launch the alarm clock app using the invoker and hide the title bar.~~
	~~# Ensure that this command is executed under the <code>ceres</code> user.~~
	EGL_PLATFORM=wayland \		EGL_PLATFORM=wayland \
	QT_QPA_PLATFORM=wayland \		QT_QPA_PLATFORM=wayland \
Line 39:		Line 39:
	The AsteroidOS Wayland compositor is named asteroid-launcher, it is based on lipstick which offers a DBus API to take screenshots. This DBus interface can be used from the command line with dbus-send but a tool named screenshottool makes the usage of this command easier.		The AsteroidOS Wayland compositor is named asteroid-launcher, it is based on lipstick which offers a DBus API to take screenshots. This DBus interface can be used from the command line with dbus-send but a tool named screenshottool makes the usage of this command easier.

			Save a screenshot in <code>$HOME</code> after 3 seconds
	<pre>		<pre>
	~~# Saves a screenshot in $HOME after 3 seconds~~
	screenshottool /home/ceres/screenshot.jpg 3		screenshottool /home/ceres/screenshot.jpg 3
	</pre>		</pre>
Line 48:		Line 48:
	Managing the time is very important on a smartwatch. Systemd provides basic timer capabilities but the timed daemon goes further and is much more capable. This daemon also comes with a tool named <code>timedclient-qt5</code> that can help you run commands on special events.		Managing the time is very important on a smartwatch. Systemd provides basic timer capabilities but the timed daemon goes further and is much more capable. This daemon also comes with a tool named <code>timedclient-qt5</code> that can help you run commands on special events.

			Execute the /home/ceres/test.sh script every day at 12:15
	<pre>		<pre>
	~~# Executes the /home/ceres/test.sh script every day at 12:15~~
	timedclient-qt5 -a'whenDue;runCommand=/home/ceres/test.sh@ceres' \		timedclient-qt5 -a'whenDue;runCommand=/home/ceres/test.sh@ceres' \
	-r'hour=12;minute=15;everyDayOfWeek;everyDayOfMonth;everyMonth' \		-r'hour=12;minute=15;everyDayOfWeek;everyDayOfMonth;everyMonth' \
Line 59:		Line 59:
	In AsteroidOS, the USB mode is handled by a daemon named usb_moded. This daemon offers a DBus interface that is exposed to the GUI by asteroid-launcher and asteroid-settings. However, usb_moded also comes with a command named <code>usb_moded_util</code> to control this DBus interface from the command line.		In AsteroidOS, the USB mode is handled by a daemon named usb_moded. This daemon offers a DBus interface that is exposed to the GUI by asteroid-launcher and asteroid-settings. However, usb_moded also comes with a command named <code>usb_moded_util</code> to control this DBus interface from the command line.

	<~~pre~~>		<code>usb_moded_util -m # Returns a list of supported modes</code>
	usb_moded_util -m # Returns a list of supported modes		<code>usb_moded_util -q #Shows the currently used USB mode</code>
	usb_moded_util -q #Shows the currently used USB mode		<code>usb_moded_util -s adb_mode #Set USB to the ADB Mode</code>
	usb_moded_util -s adb_mode #Set USB to the ADB Mode
	</~~pre~~>

	== Screen ==		== Screen ==
Line 69:		Line 67:
	A daemon named MCE is in charge of handling various screen related behaviors. For example, MCE handles the device locking, the tap to unlock, the current brightness, fading and dimming and others.... It can be controlled thanks to a CLI tool named <code>mcetool</code>.		A daemon named MCE is in charge of handling various screen related behaviors. For example, MCE handles the device locking, the tap to unlock, the current brightness, fading and dimming and others.... It can be controlled thanks to a CLI tool named <code>mcetool</code>.

	<~~pre~~>		<code>mcetool # Displays the current state of various variables</code>
	mcetool # Displays the current state of various variables		<code>mcetool -D on # Enables "demo mode": screen stays on</code>
	mcetool -D on # Enables "demo mode": screen stays on		<code>mcetool -M disabled # Disables the tap to unlock functionality</code>
	mcetool -M disabled # Disables the tap to unlock functionality
	</~~pre~~>

	== Restart ==		== Restart ==
Line 79:		Line 75:
	Systemd is the init system used by AsteroidOS. It is controlled by a command named <code>systemctl</code>. This command can be used to restart the user session or the entire system into a different mode.		Systemd is the init system used by AsteroidOS. It is controlled by a command named <code>systemctl</code>. This command can be used to restart the user session or the entire system into a different mode.

	<~~pre~~>		<code>systemctl restart user@1000 # Restarts the ceres session (including the entire UI)</code>
	systemctl restart user@1000 # Restarts the ceres session (including the entire UI)		<code>reboot # Simply reboot your watch</code>
	reboot Simply reboot your watch		<code>systemctl --force reboot bootloader # Restarts the watch in bootloader mode</code>
	systemctl --force reboot bootloader # Restarts the watch in bootloader mode		<code>systemctl --force reboot recovery # Restarts the watch in recovery mode</code>
	systemctl --force reboot recovery # Restarts the watch in recovery mode
	</~~pre~~>

	== Time zone, date & time ==		== Time zone, date & time ==
Line 90:		Line 84:
	Although we offer [[Synchronization Clients \| synchronisation clients]] for different platforms, it might still be useful to set the time zone or synchronise the date and time using standard Linux tools. The Linux folder <code>/usr/share/zoneinfo/</code> contains the naming scheme for your local time zone in <code><continent>/<zone></code> format.		Although we offer [[Synchronization Clients \| synchronisation clients]] for different platforms, it might still be useful to set the time zone or synchronise the date and time using standard Linux tools. The Linux folder <code>/usr/share/zoneinfo/</code> contains the naming scheme for your local time zone in <code><continent>/<zone></code> format.

	<pre>		<pre>ssh root@192.168.2.15 "timedatectl set-timezone <continent>/<zone>"</pre>
	ssh root@192.168.2.15 "timedatectl set-timezone <continent>/<zone>" ~~# e.g. Europe~~/~~Berlin~~		<pre>ssh root@192.168.2.15 "date -s @<code>(date -u +"%s" )</code>"</pre>
	ssh root@192.168.2.15 "date -s @<code>(date -u +"%s" )</code>"
	</pre>

	= Boot to fastboot (bootloader) menu =		= Boot to fastboot (bootloader) menu =

	In case you can not boot to the fastboot menu using <~~code~~>adb reboot bootloader</~~code~~>~~, try~~ the manual method for your watch specified below. These methods come in very handy in case your watch does neither boot AsteroidOS, nor WearOS successfully in its current state.		In case you can not boot to the fastboot menu using
			<pre>adb reboot bootloader</pre>
			Try the manual method for your watch specified below. These methods come in very handy in case your watch does neither boot AsteroidOS, nor WearOS successfully in its current state.

Dodoradio: Add useful commands page from current wiki

2023-06-17T14:20:38Z

Add useful commands page from current wiki

New page

AsteroidOS comes with several command line tools that are very handy to control a watch from [[SSH]] or a script. This page tries to document the basic features of those commands, don't hesitate to use their <code>--help</code> options if you want to learn more.

Commands and gestures to enter the fastboot (bootloader) mode are listed at the bottom of this page.

== Notifications ==

AsteroidOS complies to the [freedesktop.org notifications specification](https://specifications.freedesktop.org/notification-spec/notification-spec-latest.html), which means you can use standard Linux desktop tools such as libnotify to show notifications in asteroid-launcher.
On AsteroidOS a useful command named <code>notificationtool</code> is provided that allows you to create/update/close/list notifications from the CLI.

<pre>
# Creates a new notification with various parameters
notificationtool -o add \
--icon=ios-happy \
--application="Super App" \
--urgency=3 \
--hint="x-nemo-preview-summary Incredible preview title" \
--hint="x-nemo-preview-body Exceptional preview content" \
--hint="x-nemo-feedback notif_strong" \
"Great Title" \
"Amazing content"
</pre>

== Launch applications ==

AsteroidOS uses an <code>invoker</code> to launch apps. The invoker is used to allow for quicker app startup by caching many of the Qt components into memory.

<pre>
# Launch the alarm clock app using the invoker and hide the title bar.
# Ensure that this command is executed under the <code>ceres</code> user.
EGL_PLATFORM=wayland \
QT_QPA_PLATFORM=wayland \
QT_WAYLAND_DISABLE_WINDOWDECORATION=1 \
invoker --single-instance --type=qt5 \
/usr/lib/asteroid-alarmclock
</pre>

== Screenshots ==

The AsteroidOS Wayland compositor is named asteroid-launcher, it is based on lipstick which offers a DBus API to take screenshots. This DBus interface can be used from the command line with dbus-send but a tool named screenshottool makes the usage of this command easier.

<pre>
# Saves a screenshot in $HOME after 3 seconds
screenshottool /home/ceres/screenshot.jpg 3
</pre>

== Alarms ==

Managing the time is very important on a smartwatch. Systemd provides basic timer capabilities but the timed daemon goes further and is much more capable. This daemon also comes with a tool named <code>timedclient-qt5</code> that can help you run commands on special events.

<pre>
# Executes the /home/ceres/test.sh script every day at 12:15
timedclient-qt5 -a'whenDue;runCommand=/home/ceres/test.sh@ceres' \
-r'hour=12;minute=15;everyDayOfWeek;everyDayOfMonth;everyMonth' \
-e'APPLICATION=Test;TITLE=Test'
</pre>

== USB ==

In AsteroidOS, the USB mode is handled by a daemon named usb_moded. This daemon offers a DBus interface that is exposed to the GUI by asteroid-launcher and asteroid-settings. However, usb_moded also comes with a command named <code>usb_moded_util</code> to control this DBus interface from the command line.

<pre>
usb_moded_util -m # Returns a list of supported modes
usb_moded_util -q #Shows the currently used USB mode
usb_moded_util -s adb_mode #Set USB to the ADB Mode
</pre>

== Screen ==

A daemon named MCE is in charge of handling various screen related behaviors. For example, MCE handles the device locking, the tap to unlock, the current brightness, fading and dimming and others.... It can be controlled thanks to a CLI tool named <code>mcetool</code>.

<pre>
mcetool # Displays the current state of various variables
mcetool -D on # Enables "demo mode": screen stays on
mcetool -M disabled # Disables the tap to unlock functionality
</pre>

== Restart ==

Systemd is the init system used by AsteroidOS. It is controlled by a command named <code>systemctl</code>. This command can be used to restart the user session or the entire system into a different mode.

<pre>
systemctl restart user@1000 # Restarts the ceres session (including the entire UI)
reboot Simply reboot your watch
systemctl --force reboot bootloader # Restarts the watch in bootloader mode
systemctl --force reboot recovery # Restarts the watch in recovery mode
</pre>

== Time zone, date & time ==

Although we offer [[Synchronization Clients | synchronisation clients]] for different platforms, it might still be useful to set the time zone or synchronise the date and time using standard Linux tools. The Linux folder <code>/usr/share/zoneinfo/</code> contains the naming scheme for your local time zone in <code><continent>/<zone></code> format.

<pre>
ssh root@192.168.2.15 "timedatectl set-timezone <continent>/<zone>" # e.g. Europe/Berlin
ssh root@192.168.2.15 "date -s @<code>(date -u +"%s" )</code>"
</pre>

= Boot to fastboot (bootloader) menu =

In case you can not boot to the fastboot menu using <code>adb reboot bootloader</code>, try the manual method for your watch specified below. These methods come in very handy in case your watch does neither boot AsteroidOS, nor WearOS successfully in its current state.

==== Anthias, Bass, Dory, Lenok, Mooneye, Sparrow, Swift, Wren====
During the first seconds of the boot process, swipe diagonally across the screen. Starting from the top/left outer edge of the screen to the bottom/right.

==== Catfish, Skipjack====
Power down the watch. Keep holding both buttons during the boot process until the fastboot menu appears.

==== Firefish====
After the watch stops vibrating on startup, immediately touch the top/left & bottom/right of the screen and press the middle button while the manufacturer logo displays.

==== Pike====
Power down the watch. Keep holding both buttons during the boot process, then select fastboot from the menu.

==== Sawfish, Sawshark, Sturgeon====
Press and hold the power button when the manufacturer bootlogo appears, until the vibration finishes. Release the button and press it again quickly. The time frame for this method is short and might need several attempts. Some users report that spamming power button presses already during the vibration helps.

==== Smelt====
Keep holding the power button during the boot process and release it quickly after the second (double) vibration.