Skip to content

Releases

OOTT v0.2.4

Choose a tag to compare

@rzuasti rzuasti released this 22 Jun 16:00

v0.2.4 — 2026-06-22

A reliability and release-readiness pass: cleaner shutdown, clearer error
reporting, working API docs, and the groundwork for App Store / Play Store
submission.

Improvements

  • Graceful shutdown. The backend now catches SIGTERM and SIGINT (so
    docker stop and Kubernetes no longer have to force-kill it). A shared
    cancellation token stops every scanner, the retention cleaner, and the
    notification loop at their next safe point, the web server drains in-flight
    requests, and the database WAL is checkpointed on the way out.
  • Surfaced scanner errors. A scanner that failed to start (e.g. DHCP unable
    to bind port 67) previously just showed as "off" with no log; each task's
    error is now logged instead of being silently dropped.

Fixes

  • API docs "Try it out". Every API operation now has a unique operationId,
    so Swagger UI's "Try it out" calls the endpoint you're actually looking at
    instead of always hitting the first one (e.g. the DHCP scanner's docs no
    longer execute against the ARP scanner).
  • Narrow-screen config dialog. The backend-config Test/Save/Cancel actions
    are laid out full size in a row on wide screens and stacked vertically on
    narrow phones, instead of being shrunk to tiny buttons by a uniform scale.

Internal

  • New deploy/fly/ Fly.io deployment for an App Store review test server:
    an env-driven flyImage Nix output (backend plus bundled web UI), a
    persistent volume, scanners disabled, the API key supplied via a Fly secret,
    and an idempotent demo-data seed (seed.sql) applied on boot when
    OOTT_SEED is set.
  • Android release builds are now signed with an upload keystore loaded from a
    gitignored key.properties (falling back to the debug key when absent), with
    a build_android_release.sh helper and a documented keytool setup. Added Play
    Store listing graphics and the cupertino_icons dependency.
  • The iOS app is now iPhone-only (TARGETED_DEVICE_FAMILY = 1) to drop the iPad
    screenshot requirement.
  • Documentation: README screenshots, a complete and functional sample_oott.toml
    baseline, the "push" notification method documented, and true-vector OOTT icon
    SVGs for a dashboardicons submission.

OOTT v0.2.3

Choose a tag to compare

@rzuasti rzuasti released this 15 Jun 17:50

v0.2.3 — 2026-06-15

A small fix-and-polish release.

Fixes

  • "Device changed" notifications. A registered, typed device that changed
    its IP or vendor was reported in the notification as "Not registered" with
    type "-". The notification now describes the device as it is stored.

Improvements

  • The first-run experience now opens straight into the backend-config dialog,
    with the welcome message folded into it and its actions kept on a single row.

OOTT v0.2.2

Choose a tag to compare

@rzuasti rzuasti released this 12 Jun 14:31

v0.2.2 — 2026-06-12

A polish release: more themes to choose from, the ability to permanently delete
a device, and a round of UI and iOS push refinements.

Features

  • More themes. Five new selectable themes join Catppuccin Mocha and Gruvbox
    Dark — Catppuccin Latte, Dracula, Alucard, Nord, and Tokyo Night — each using
    the same shared theme builder so they stay visually consistent.
  • Permanent device deletion. Not-registered devices can now be deleted
    outright (from the device detail screen or the list row), and the Forget
    dialog gains an opt-in "permanently delete" checkbox that erases the device
    and its events for good.

Fixes

  • iOS foreground push. Push notifications now display as a banner on iOS
    even while the app is open, instead of being silently suppressed or
    double-shown.
  • Narrow-screen layout. The device detail action buttons now wrap instead
    of overflowing horizontally on phone widths.

Improvements

  • Button emphasis follows Material 3 more closely: a single filled primary
    action, error-colored text buttons for destructive actions, and the Test
    button demoted to filled-tonal.
  • The backend-config Test button flashes red when a connection test fails.
  • Snackbars now render above dialogs via a top-level messenger host.
  • The Android adaptive launcher icon shows a larger OOTT wordmark.
  • The About screen links to the project website instead of the source and
    license.

Internal

  • The backend adds db::devices::delete and a DELETE /api/devices/{mac}/permanently endpoint (wired into OpenAPI), both covered by
    tests.
  • The README documents the one-time paid app model, and the project reserves the
    "OOTT" name and logo as a trademark while keeping the source under AGPL-3.0.

OOTT v0.2.1

Choose a tag to compare

@rzuasti rzuasti released this 09 Jun 18:11

v0.2.1 — 2026-06-09

A follow-up to v0.2.0 that makes mobile push notifications actually arrive on
iOS, and adds a way to verify delivery yourself.

Features

  • Send test notification. Settings now has a "Send test notification" button
    that asks the backend to push a test alert to every registered device and
    reports back how many devices it reached, so you can confirm push is working
    end to end.

Fixes

  • iOS push delivery. Firebase is now initialised at startup and the app
    waits for the native APNs token before requesting its FCM token, so iOS
    devices reliably obtain a push token instead of leaving it null. The push
    token is also re-registered on each launch to recover from rotation.

Internal

  • The iOS AppDelegate and push_service surface the native APNs registration
    outcome for diagnostics, and push_service was refactored for clarity.
  • The backend's test-notification endpoint returns the delivered device count.

OOTT v0.2.0

Choose a tag to compare

@rzuasti rzuasti released this 09 Jun 14:50

v0.2.0 — 2026-06-09

The headline of this release is mobile push notifications: OOTT can now alert
you on your phone when a new or changed device appears, without keeping the app
open. The settings screen was also reorganised, and there are several transition
and caching fixes.

Features

  • Push notifications. When the backend's notification method is set to
    "push", the app can register each device to receive alerts through Firebase
    Cloud Messaging, relayed by a small project-owned Cloud Function. Payloads are
    privacy-preserving: only the already-sanitized alert title and body are sent —
    no MAC, IP, or device data, and tapping a notification simply opens the app.
    A per-device push toggle in settings turns it on (shown only on platforms that
    support push and when the backend is configured for it).
  • Reorganised settings. Backend URL and API key now live in a dedicated
    Test/Save dialog reachable via "Re-configure", and open automatically on first
    run. The settings screen shows the connection read-only (with a key reveal)
    and groups Theme and Push into an "App settings" card; theme and push changes
    apply immediately.

Improvements

  • Duration displays (e.g. the passive scanners' "Listening for …" line) now
    scale up through months instead of capping at minutes, showing the two largest
    relevant units.

Fixes

  • Fixed ghosting in native screen transitions: routed pages now paint opaque so
    a pushed screen cleanly covers the one beneath, and detail screens slide in
    with the covered page parallaxing out on the native iOS curve.
  • Front-end assets are now served with Cache-Control: no-cache, so upgrades no
    longer leave the browser (and service worker) serving stale icons and images;
    unchanged files still return a cheap 304.
  • The Android app label is now "OOTT" rather than the placeholder, so the
    notification-permission dialog reads correctly.

Internal

  • New push_relay/ service: a TypeScript Firebase Cloud Function exposing
    POST /v1/push (FCM sendEach with per-token status mapping and dead-token
    pruning), a /health liveness route, payload validation, and per-IP rate
    limiting, with Jest tests and setup docs.
  • Backend gains a push_tokens migration, model and data layer, PUT/DELETE /api/push_tokens endpoints, a GET /api/config endpoint exposing the
    notification method, and a relay-backed "push" sender — all wired into the
    router and OpenAPI.
  • Android package renamed to net.oottsecurity.app; Firebase is configured from
    a committed firebase_options.dart, and iOS gains the aps-environment
    entitlement and remote-notification background mode.
  • Dev shell adds nodejs_22, firebase-tools, and google-cloud-sdk for
    building and deploying the relay.
  • Refreshed frontend and backend dependency lockfiles within existing version
    ranges (e.g. tokio 1.49 → 1.52.3).
  • Documented the Codemagic webhook prerequisite so tag pushes actually trigger
    builds.

OOTT v0.1.2

Choose a tag to compare

@rzuasti rzuasti released this 07 Jun 13:17

v0.1.2 — 2026-06-07

A maintenance release focused on more accurate change/return notifications and
a fix for the API docs link when running under the bundled server.

Fixes

  • The "API Docs" link now works when the app is served from the backend (e.g.
    in Docker). The origin-relative /api/docs path is resolved against the
    current page so it carries a scheme and host; absolute URLs pass through
    unchanged.
  • A device gaining its first IP address no longer raises a spurious "changed"
    notification (an empty → value fill is no longer treated as a change).
  • A recent routine sighting no longer suppresses a genuine change or
    return-online notification. Each event kind is now deduplicated
    independently, keyed on device, scanner and event type rather than on the
    reported address.

Improvements

  • Each known-device sighting now records a specific event type — a baseline
    DeviceSeen heartbeat (no notification), plus DeviceChanged and
    DeviceBackOnline. The device history chart reads the recorded event type
    directly for its markers and tooltips instead of inferring it from the
    device's current state.

Internal

  • The backend events code was split into focused modules: events (device-event
    recording) with a pure change-detection submodule, a new notifications
    module owning rendering, delivery and sending, and a shared DeviceChange
    contract in model. Data flows one way: events produce changes,
    notifications consume them.

OOTT v0.1.1

Choose a tag to compare

@rzuasti rzuasti released this 06 Jun 20:32

v0.1.1 — 2026-06-06

A maintenance release with bug fixes and small refinements on top of v0.1.0.

Fixes

  • Fixed a blank /web UI when running under the bundled server: the Flutter web
    bundle is now built with --base-href=/web/ so its asset URLs resolve against
    the mount point instead of the site root.
  • The bare / URL now redirects to the /web UI.

Improvements

  • Added an /api → /api/docs redirect and corrected the root guidance text to
    point at the API explorer (/api/docs).
  • Added an "API Docs" link to the wide navigation rail.
  • New-device notifications no longer include the status block, which only ever
    read "Not registered" and added no information.
  • Absent names, vendors, and device types now render consistently as a dash,
    both in notifications and across the web UI.

OOTT v0.1.0

Choose a tag to compare

@rzuasti rzuasti released this 06 Jun 15:59

v0.1.0 — 2026-06-06

First public release of OOTT — an easy to setup network device discovery and
alert system that notifies you when new or unknown devices join your local area
network.

Highlights

  • Regular network scanning using ARP probes, plus mDNS/Bonjour, SSDP/UPnP and
    DHCP discovery, and an optional SNMP scanner that reads a gateway's ARP table.
    Each scanner can be enabled or disabled independently.
  • Alerts when a new device is found, when a device changes its IP address or
    network interface vendor (by MAC address), and when a device comes back
    online after a configurable offline period. Pushover delivery, or log-only.
  • Device type inference from MAC vendor data.
  • Web front-end (Flutter/Material 3) for configuration and browsing stored data,
    responsive across desktop, tablet and phone, with native iOS and Android apps.
    Includes selectable themes (Gruvbox Dark by default), paginated and sortable
    device and notification lists, filtering, and activity charts.
  • Rust backend exposing a documented REST API (OpenAPI / Swagger UI) backed by
    SQLite with incremental migrations.
  • Configurable history retention with automatic daily purging, and per-scanner
    event deduplication to keep the database compact.

Configuration & security

  • Single config file in TOML; every option falls back to a
    sensible default except for a small required set.
  • Backend access is gated by an API key. OOTT has no built-in user accounts —
    put it behind a reverse-proxy auth layer if you need login/SSO. See the
    README for HTTPS, domain-name and access-control guidance.

Installation

  • Available as a pre-built Docker image (rzuasti/oott) and as a NixOS flake
    module. See the README for deployment and configuration details.