Skip to content

HydrogenMacro/illusion-os

Folders and files

NameName
Last commit message
Last commit date

Latest commit

eb4b34c · · Apr 29, 2026

History

8 Commits
Mar 10, 2026
Apr 1, 2026
Mar 26, 2026
Mar 22, 2026
Apr 29, 2026
Mar 4, 2026
Mar 22, 2026
Apr 29, 2026
Apr 29, 2026
Apr 1, 2026
Mar 10, 2026
Mar 17, 2026
Apr 1, 2026
Mar 22, 2026
Apr 1, 2026
Apr 1, 2026

Repository files navigation

IllusionOS

An OS for the Waveshare ESP32-C6 2.06" Watch.

Watch image

Features

  • Toggling screen with the BOOT button
  • Custom wallpapers
  • Custom fonts (must be monospace)
  • RTC integration
  • Bluetooth integration for battery percentage & time synchronizationtion

Usage

Some commands may require just.

Flashing the OS

Connect the watch to your computer and run

cargo run

# or release mode:
cargo run --release
se

Changing the wallpaper

The wallpaper image will be centered and cropped so that it fits the screen. This uses imagemagick, so all common image formats can be passed. The image must be in ./assets/wallpapers, which is where the command's argument is relative to.

just upload-wallpaper 
g>

Changing the font

A font size of around 120 is recommended for the time display. The fourth argument is to be a hard-coded 0x260000 for now; This is in preparation for the possibility of multiple fonts in different addresses in the future. This also uses imagemagick, so most common font formats should be supported. The font file must be in ./assets/fonts, which is where the command's font file argument is relative to.

just upload-font   0x260000
t; 0x260000

Synchronizing the time through BLE

You can do this through anything that supports connecting to BLE, but I personally do this with my iPhone. Your BLE client will need to be able to send 8-byte unsigned integers. Then, get an Unix Epoch timestamp in seconds (just truncate 3 digits if it's in ms) and send it to the BLE characteristic 3853b93c-f4ee-4bdf-8083-31ca09862a33. The timezone is currently fixed to be UTC-4 (EST with daylight savings).

Credits

TSTAR Mono

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published