ezOS Shell Guide

Welcome to the ezOS Shell - a complete embedded operating system for the LilyGo T-Deck Plus.

Quick Start

ezOS provides a Lua-based shell environment for interacting with the T-Deck hardware:

Navigation

Contents

SectionDescription
Menu ItemsMain menu screens and keyboard shortcuts
Settings ReferenceAll 0 device settings organized by category
Offline MapsHow to generate and use offline map tiles
API ReferenceDeveloper documentation (328 functions)

Settings Categories

Configure your device through the Settings app. Settings are organized into these categories:

Generating Offline Maps

ezOS includes an offline map viewer. To create map tiles for your region:

1. Download a PMTiles file for your area from Protomaps

2. Run the conversion tool:

cd tools/maps
pip install -r requirements.txt
python pmtiles_to_tdmap.py input.pmtiles -o map.tdmap

3. Copy map.tdmap to your SD card

See the Maps Guide for detailed instructions and options.

For Developers

ezOS exposes a comprehensive Lua API for building applications. See the

Development API Reference for complete documentation of all

16 modules and 328 functions.

Key modules:

View all 16 modules →