Repository navigation
v0.2.0 — Desktop + Web Preview (Experimental Windows/Linux)
Pre-releaseWeb editor preview
Launch online on Operation Embedded — no installation needed.
For a downloadable, self-hostable build, get lvgl-game-engine-2d-0.2.0-web.zip. Extract it and follow the included README.txt; it can be served by a simple local HTTP server. Do not open index.html directly as a file. A local static-server example is:
cd lvgl-game-engine-2d-web
python3 -m http.server 8080 --bind 127.0.0.1 --directory webThen open http://127.0.0.1:8080/ in a modern desktop browser.
- Supports scene/prefab editing, tilesets, Play preview, project imports/downloads, code editing and LVGL C ZIP export.
- Native C playtesting and board build/flash require the desktop app. Browser Play does not compile or execute native C.
- Browser recovery and preview saves stay in that browser/origin. Download editable project backups; there is no cloud project storage.
- Includes the engine license, third-party notices and build provenance. Private 3D code, paid asset packs and private campaigns are excluded.
- Web source snapshot:
443cc768f273496fa699ffe0e6b3354e2dae8d77, also attached aslvgl-game-engine-2d-0.2.0-web-source.zip. This web build is newer than the desktop tag; the original desktop downloads are unchanged. Browser-specific source wording remains reviewable in PR #2. - Verify these two web archives with
SHA256SUMS-web.txt. The originalSHA256SUMS.txtcontinues to cover the desktop assets andLICENSE.md.
Web validation: ZIP integrity, exact hosted-build match and local static-server delivery of every bundled file passed. The hosted browser editor passed selection/inspector updates, editing/undo, gameplay movement, project downloads and C ZIP export checks.
Desktop preview
First public LVGL Game Engine 2D desktop preview: macOS Apple Silicon (ARM64), plus experimental Windows x64 and Linux x64 builds.
Download the DMG and drag the app to Applications, or download and unzip the ZIP. The editor launches directly: no browser, Node.js, npm or dev server is required. Intel Macs are not supported by these downloads. Windows users can run the experimental .exe installer. Linux users can make the experimental AppImage executable (chmod +x) and run it; --appimage-extract-and-run is available on systems without FUSE.
Includes the visual 2D scene/prefab editor, tilemaps and animated tiles, pixel-art rendering, 2D physics, gameplay/RPG tools, audio integration, C code editing and LVGL export, native C playtesting, CLI, target guidance and hardware input authoring. This public edition excludes the private edition's 3D implementation.
Requirements and limitations
- macOS 13.0 or newer is the app and bundled native SDK deployment target. Tested on macOS 26.5.1; older versions have not been physically tested.
- This preview is ad-hoc signed, not Developer ID signed or notarized. macOS may block the first launch. If offered, use System Settings → Privacy & Security → Open Anyway for this app. Do not disable Gatekeeper globally.
- Native LVGL playtesting needs Apple Command Line Tools (
xcode-select --install). Editing, Play preview and export do not require a compiler. - DK builds/flashing require the separate ARM firmware toolchain and STM32 programmer; these are not included.
- Experimental Windows/Linux: editing, built-in Play preview and LVGL C export are included. Native LVGL C playtesting is unavailable and the app explains this. Board hardware/driver behavior is unverified on these platforms. The Windows installer is not Authenticode-signed and may trigger publisher/SmartScreen warnings. Use copies of important projects for preview testing.
License
Noncommercial source-available software. Commercial use is prohibited without separate written permission; engine distributions must provide corresponding source and fork interfaces must retain the specified persistent visible attribution. Independent third-party components retain their original terms. Read the attached LICENSE.md and the license in the tagged source.
Verify downloads using the attached SHA256SUMS.txt:
shasum -a 256 -c SHA256SUMS.txtKeep both archives and LICENSE.md beside the checksum file to verify all entries. The desktop source archive is available below under the v0.2.0 tag. Use the separate web source snapshot above for the browser build.
Validation: Mac archive checks, full app signatures, standalone editor launch/Play/export, and packaged native C playtesting passed. Experimental Windows and Linux packaged startup, Play movement, unavailable-native feedback and CLI C export passed on their native GitHub runners. No board was flashed during this release.