TRMNL iNaturalist Nearby Live (INTL)

International BYOS plugin for Terminus/TRMNL (7.5" e-ink friendly layout).

Features

• latest nearby iNaturalist observation;
• species name + taxonomy group;
• observed/uploaded timestamps;
• distance from home point;
• photo panel + high-contrast mini-map;
• QR to the original iNaturalist observation.

What is included

• byos/scripts/update-inaturalist-nearby-intl-extension.sh – updater script (API fetch + DB upsert + render).
• byos/scripts/inat_render_map.py – e-ink map rasterizer.
• byos/templates/inaturalist_nearby_live_intl.liquid – screen template.
• byos/.inaturalist_nearby_intl.env.example – configuration template.

Install on Raspberry Pi (Terminus host)

1. Copy files into your Terminus directory:

cd ~/terminus
cp /path/to/repo/byos/scripts/update-inaturalist-nearby-intl-extension.sh scripts/
cp /path/to/repo/byos/scripts/inat_render_map.py scripts/
cp /path/to/repo/byos/templates/inaturalist_nearby_live_intl.liquid templates/
cp /path/to/repo/byos/.inaturalist_nearby_intl.env.example .inaturalist_nearby_intl.env
chmod +x scripts/update-inaturalist-nearby-intl-extension.sh scripts/inat_render_map.py

2. Edit .inaturalist_nearby_intl.env (set your coordinates and timezone).

3. Run once:

cd ~/terminus
./scripts/update-inaturalist-nearby-intl-extension.sh

4. Add cron job (every 5 minutes):

*/5 * * * * cd /home/$USER/terminus && ./scripts/update-inaturalist-nearby-intl-extension.sh >> /tmp/inat-intl.log 2>&1

Main configuration

• INAT_INTL_LAT, INAT_INTL_LON – home coordinates.
• INAT_INTL_RADIUS_KM – search radius.
• INAT_INTL_TZ – timezone (Europe/London, Europe/Moscow, etc.).
• INAT_INTL_LOCALE – language for iNaturalist API (en recommended for intl).
• INAT_INTL_MAP_STYLE – balanced, contrast, eink_clean, eink_detail, auto.
• INAT_INTL_MODEL_ID – TRMNL model id (use your 7.5" model id in Terminus).

Privacy

This repository does not contain personal credentials, private email, or private calendar data.
The screenshot uses public iNaturalist observation data.