BeeOS

BeeOS is a MicroPython-first smartwatch OS concept and desktop simulator for the PineTime Pro direction.

The current project is a Windows-friendly Tkinter simulator plus project framework. It does not require LVGL or MicroPython on Windows yet.

Current capabilities

  • BeeOS watch face and 2x2 app launcher
  • Notifications shade
  • Built-in apps: Clock, Health, HiveStore, Settings, Scripts, Resource Monitor, GPS, Battery, About, Developer Tools
  • Runtime API for installed apps/scripts
  • Live app sessions with touch events
  • Permission approval prompts
  • HiveStore package install/remove/update simulation
  • Multi-repo HiveStore support
  • GitHub-compatible HiveStore repo imports
  • Curated Lucide icon asset subset
  • PNG icon renders for the desktop simulator
  • LVGL v8/v9 icon descriptor export
  • Theme registry and C/JSON theme export

Run the simulator

py run_beeos.py

or:

python run_beeos.py

Useful tools

Validate the project:

py tools/validate_project.py --project-root .

Clean Python cache files:

py tools/clean_project.py --project-root .

Create a package template:

py tools/create_package_template.py app local.test.app "Test App"

Create a starter HiveStore repo:

py tools/create_hivestore_repo.py .\my-hivestore "My HiveStore Repo"

Import a HiveStore repo:

py tools/import_hivestore_repo.py .\my-hivestore\hivestore_index.json --project-root .

Rebuild icon assets:

py tools/convert_icons_for_lvgl.py --project-root . --sizes 24,34

Rebuild theme assets:

py tools/export_themes_for_lvgl.py --project-root .

Documentation

docs/PROJECT_STRUCTURE.md
docs/DEVELOPMENT.md
docs/HIVESTORE_REPOS.md
docs/history/

Important note

This is not firmware yet. It is the simulator, package model, runtime API shape, HiveStore model, and asset pipeline that can later be ported toward MicroPython/LVGL on the actual watch.

Dev Tools cleanup build

Developer Tools now uses a 2x2 paged tool hub instead of a long crowded list. Use mouse wheel or swipe-style page controls to move between tool pages.

Dev Tools v2 dashboard fix

The previous Dev Tools cleanup package accidentally still shipped the old long-row list. This build replaces it with a visibly different Dev Hub dashboard:

  • Header summary card
  • 2x2 dashboard tiles
  • Prev/Next page controls
  • Page dots
  • Mouse wheel page switching

Scripts scrolling update

The Scripts app is now scrollable. It shows four scripts at a time and supports:

  • Mouse wheel scrolling
  • Up/Down keyboard scrolling
  • Scroll position indicator
  • Runtime launch from the currently visible rows

Additional sample scripts were added so scrolling is visible immediately.

Scripts scroll crash fix

Fixed missing self.scripts_scroll_index initialization in BeeOSSimulator.__init__. The Scripts screen also now has a defensive fallback so it cannot crash if the field is missing.

S
Description
No description provided
Readme
314 KiB
Languages
C 59.3%
Python 40.7%