MicroPythonOS is an Android-inspired, touch-UI operating environment built on MicroPython and LVGL.
It runs on ESP32-S3 touchscreen boards and can be tested locally on Linux.
It is not MicroPython's built-in os / uos module — it is a completely separate project.

MicroPythonOS provides:

• Touch UI — built on LVGL; renders a home screen, app launcher, and settings similar to Android.
• App framework — apps are Python packages with a defined folder structure and a manifest. Each app subclasses mpos.Activity and implements lifecycle hooks (onCreate, onResume, onPause, onDestroy).
• App Store — a curated catalogue of installable apps (no account required).
• System services — Wi-Fi management, OTA updates, display/touch abstraction, audio (where supported).
• Desktop simulator — the full OS can run on Linux for rapid app iteration before flashing to hardware.

Note: mpremote is the recommended tool for copying files to the ESP32. It is part of the official MicroPython project.

# 1. Clone the repo (you're already here if reading this in the repo)
cd projects/micropythonos

# 2. Read the installation guide
open docs/installation.md     # macOS
xdg-open docs/installation.md # Linux

# 3. Run the OS on your desktop
#    (see docs/installation.md for the full Linux setup steps)

# 4. Deploy the example countdown timer app
bash scripts/install_app.sh --app apps/com.smaruf.countdown_timer --target desktop

projects/micropythonos/
├── README.md                          ← you are here
├── docs/
│   ├── installation.md                ← Linux desktop + ESP32 flashing
│   ├── app-development.md             ← app structure, lifecycle, Hello World
│   ├── deployment.md                  ← mpremote, filesystem layout
│   ├── troubleshooting.md             ← common problems & fixes
│   └── resources.md                   ← links to upstream docs
├── apps/
│   └── com.smaruf.countdown_timer/    ← example app
│       ├── META-INF/
│       │   └── MANIFEST.JSON
│       ├── assets/
│       │   └── main.py                ← LVGL + mpos.Activity app code
│       └── res/
│           └── ICONS.md               ← icon generation instructions
└── scripts/
    ├── install_app.sh                 ← Bash helper (desktop + mpremote)
    └── install_app.py                 ← Cross-platform Python equivalent

The apps/com.smaruf.countdown_timer/ folder contains a fully-annotated example app that demonstrates:

• Correct MANIFEST.JSON structure
• Subclassing mpos.Activity with all lifecycle hooks
• Building a UI with LVGL widgets (label, button, arc)
• Handling touch events and state transitions
• Deploying to both desktop and ESP32 with the provided scripts

See docs/app-development.md for a line-by-line walkthrough.

• MicroPythonOS official docs: https://docs.micropythonos.com/
• Creating apps guide: https://docs.micropythonos.com/app-development/creating-apps/
• MicroPython ESP32 docs: https://docs.micropython.org/en/latest/esp32/quickref.html
• MicroPython downloads: https://micropython.org/download/
• DroneBot Workshop tutorial: https://dronebotworkshop.com/micropythonos/

Back to repo root → python-study