TerminalOS

TerminalOS is designed to launch quickly and reload modules automatically. Follow these steps to get up and running.

# Clone
git clone https://github.com/NatBuilds/TerminalOS.git
cd TerminalOS

# Virtual environment
python -m venv .venv
.\.venv\Scripts\Activate.ps1

# Dependencies
pip install -r requirements.txt

# Run
python run.py

If you see the menu, the app is ready.

from app.core import status

def greet() -> None:
    status.success("Hello, World!")

def register(menu) -> None:
    menu.add("Say Hello", greet)

Create app/modules/helloworld/controller.py, save it, and select the module in TerminalOS. No restart required.

• Install Android Platform Tools (ADB)
• Enable USB debugging on your device
• Connect the device and accept the prompt
• Open Device Tools in TerminalOS

• Missing packages: run pip install -r requirements.txt again
• Module not shown: ensure controller.py exports register(menu)
• ADB missing: install Android Platform Tools and restart the terminal
• No debug output: enable Verbose mode in Settings