125 lines
3.0 KiB
Markdown
125 lines
3.0 KiB
Markdown
# 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
|
|
|
|
```powershell
|
|
py run_beeos.py
|
|
```
|
|
|
|
or:
|
|
|
|
```powershell
|
|
python run_beeos.py
|
|
```
|
|
|
|
## Useful tools
|
|
|
|
Validate the project:
|
|
|
|
```powershell
|
|
py tools/validate_project.py --project-root .
|
|
```
|
|
|
|
Clean Python cache files:
|
|
|
|
```powershell
|
|
py tools/clean_project.py --project-root .
|
|
```
|
|
|
|
Create a package template:
|
|
|
|
```powershell
|
|
py tools/create_package_template.py app local.test.app "Test App"
|
|
```
|
|
|
|
Create a starter HiveStore repo:
|
|
|
|
```powershell
|
|
py tools/create_hivestore_repo.py .\my-hivestore "My HiveStore Repo"
|
|
```
|
|
|
|
Import a HiveStore repo:
|
|
|
|
```powershell
|
|
py tools/import_hivestore_repo.py .\my-hivestore\hivestore_index.json --project-root .
|
|
```
|
|
|
|
Rebuild icon assets:
|
|
|
|
```powershell
|
|
py tools/convert_icons_for_lvgl.py --project-root . --sizes 24,34
|
|
```
|
|
|
|
Rebuild theme assets:
|
|
|
|
```powershell
|
|
py tools/export_themes_for_lvgl.py --project-root .
|
|
```
|
|
|
|
## Documentation
|
|
|
|
```text
|
|
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.
|