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.