Nimbus

A weather app for NextUI on TrimUI handheld devices.

Built with PakKit and Apostrophe. Weather data provided by WeatherAPI.com.

Features

• Current conditions -- temperature, feels like, humidity, wind, precipitation, cloud cover, UV index
• 3-day forecast -- daily high/low, condition, chance of rain with weather icons
• Hourly forecast -- next 24 hours with temperature, condition, and rain chance
• Sun & Moon -- sunrise/sunset, day length, moonrise/moonset, moon phase and illumination for 3 days
• Multi-location -- save up to 10 locations, switch with L1/R1
• Offline cache -- view last-known weather data when WiFi is unavailable
• WiFi detection -- retry/continue dialog on launch, graceful fallback to cached data
• F / C toggle in settings
• Location search -- search by city name, zip code, or postal code via on-screen keyboard
• QR code setup -- enter your API key from your phone by scanning a QR code on the device screen
• Auto-detect location -- uses IP geolocation on first launch if no location is configured
• Weather condition icons -- fetched from WeatherAPI and cached locally
• 4-page layout -- swipe between Current, Forecast, Hourly, and Sun & Moon with page dot indicator
• Smooth scrolling -- animated scroll with easing for a polished feel
• Minimal UI -- clean PakKit screens with subtle button hints

Supported Devices

Device	Platform	Status
TrimUI Brick	tg5040	Working
TrimUI Smart Pro	tg5040	Working
TrimUI Brick Hammer	tg5040	Working

Screenshots

Current	Forecast	Hourly

Sun & Moon	Locations	Cached

Setup

1. Get an API Key

Sign up for a free account at weatherapi.com and copy your API key.

2. Install

Download the latest Nimbus.tg5040.pak.zip from Releases.

Extract and copy the Nimbus.pak folder to your SD card:

/mnt/SDCARD/Tools/tg5040/Nimbus.pak/

3. Enter Your API Key

Launch Nimbus from the Tools menu. On first launch you'll see a QR code screen:

1. Scan the QR code with your phone (or visit the URL shown on screen)
2. Enter your API key on the web page that opens
3. Tap Save -- Nimbus will pick up the key and load your weather

Alternatively, you can manually create the file:

/mnt/SDCARD/.userdata/tg5040/nimbus/config/api_key.txt

with your API key as the only line.

4. Set Your Location

On first launch, Nimbus auto-detects your location from your IP address. To add or change locations:

1. Press Y to open settings
2. Select Locations
3. Press X to add a new location
4. Type a city name, zip code, or postal code
5. Select your location from the results

Use L1/R1 on the weather screen to switch between saved locations.

Controls

Weather Screen

Button	Action
L/R	Switch pages (Current, Forecast, Hourly, Sun & Moon)
L1/R1	Switch locations (with 2+ locations)
Up/Down	Scroll
Y	Settings menu
B	Quit

Settings Menu

Option	Description
Units	Toggle between F and C
Locations	Add, delete, or set home location
Change API Key	Re-run the QR code setup
About	Version and credits

Keyboard

Button	Action
A	Type selected key
B	Backspace
Start	Confirm input
Y	Cancel
L1	Toggle shift
R1	Toggle symbols

Device Paths

Path	Description
/mnt/SDCARD/Tools/tg5040/Nimbus.pak/	App installation
/mnt/SDCARD/.userdata/tg5040/nimbus/config/api_key.txt	API key
/mnt/SDCARD/.userdata/tg5040/nimbus/config/locations.txt	Saved locations
/mnt/SDCARD/.userdata/tg5040/nimbus/config/settings.txt	User settings
/mnt/SDCARD/.userdata/tg5040/nimbus/cache/	Cached weather icons and offline data
/mnt/SDCARD/.userdata/tg5040/logs/nimbus.txt	Log file (current session only)

Building from Source

Requires Docker and the NextUI tg5040 toolchain image.

Prerequisites

Clone the repo with submodules:

git clone --recurse-submodules https://github.com/ericreinsmidt/nextui-nimbus.git
cd nextui-nimbus

First-Time Setup

Build the static curl and OpenSSL libraries (only needed once):

docker run --rm -v "$(pwd)":/workspace ghcr.io/loveretro/tg5040-toolchain \
  /workspace/third_party/apostrophe/scripts/build_third_party.sh ensure-curl tg5040

Stage CA certificates (only needed once):

mkdir -p build/tg5040
docker run --rm -v "$(pwd)":/workspace ghcr.io/loveretro/tg5040-toolchain \
  /workspace/third_party/apostrophe/scripts/build_third_party.sh stage-runtime-libs tg5040 \
  /workspace/build/tg5040/nimbus /workspace/build/tg5040/lib

Build

make build

Package

make package

This builds the binary, stages all artifacts, and creates dist/Nimbus.tg5040.pak.zip.

Deploy

Copy ports/tg5040/pak/ to /Tools/tg5040/Nimbus.pak/ on your SD card.

Tech Stack

• Language: C (single-file architecture)
• UI Components: PakKit + Apostrophe by Helaas
• Weather Data: WeatherAPI.com (free tier)
• JSON Parsing: cJSON
• QR Code Generation: QR-Code-generator by nayuki
• HTTP: libcurl with static OpenSSL
• Target: TrimUI Brick / Smart Pro / Brick Hammer (tg5040) running NextUI

Credits

• Nimbus by Eric Reinsmidt
• PakKit UI components by Eric Reinsmidt
• Apostrophe UI toolkit by Helaas
• NextUI by LoveRetro
• Weather data by WeatherAPI.com
• QR code generation by nayuki
• JSON parsing by DaveGamble/cJSON
• QR code setup inspired by LogJack by Brandon Kowalski

License

MIT -- see LICENSE for details.