manifestVersion: 1.1
id: esetheyers-alby-automation
category: bitcoin
name: Alby Automation
version: "1.1.2"
tagline: Threshold-triggered Lightning payouts via NWC
icon: https://git.huveme.com/esetheyers/umbrel-apps/raw/branch/main/esetheyers-alby-automation/icon.svg
description: >-
  Drains an Alby Hub wallet automatically. When the balance rises above
  a configured threshold, sends fixed-amount payments to a list of
  Lightning Addresses via Nostr Wallet Connect.


  Atomic round semantics: if any payment in a round fails, the round
  pauses until that payment succeeds, preventing partial double-payment.


  Everything is set up from the app's own page: the wallet connection, the
  threshold, who gets paid and how much, and optional Telegram alerts when
  something fails. The page also shows the balance, the payments made and
  any round that is still pending. Settings persist across app updates and
  umbrelOS upgrades.


  It needs a Nostr Wallet Connect secret from Alby Hub (or any other NWC
  wallet) with only the permissions to read the balance and send payments.
developer: esetheyers
website: https://git.huveme.com/esetheyers/alby-automation-umbrel
repo: https://git.huveme.com/esetheyers/alby-automation-umbrel
support: https://git.huveme.com/esetheyers/alby-automation-umbrel/issues
port: 3420
gallery: []
path: ""
defaultPassword: ""
releaseNotes: |
  1.1.2
  - The app header now shows the right version. Same program as 1.1.1,
    with exactly the same dependencies.

  1.1.1
  - The code and this app store moved to https://git.huveme.com/esetheyers.
    To report a problem, write to esetheyers@huveme.com.
  - Manifest-only release; container image unchanged from 1.1.0.

  1.1.0
  - Web interface: the "Open" button now shows the status and lets you
    change every setting. No more SSH or editing files by hand.
  - The app starts without any configuration and waits to be set up.
  - Settings apply at once, without restarting the app.
  - New: pause switch, test buttons for the wallet, the addresses and
    Telegram, a list of recent payments, and a way to discard a round that
    can never be paid.
  - Telegram alerts in English or Spanish (English by default: pick Spanish
    under Alerts if you want them as before).
  - Existing config.json files keep working unchanged.

  1.0.4
  - Suppress noisy Telegram alerts for transient NWC/relay timeouts.
    Only notify after N consecutive failed ticks (default 3 = ~15 min of
    real degradation). Configurable via ERROR_NOTIFY_THRESHOLD in
    /data/config.json. Sends a one-shot "recovered" message when the
    streak ends, but only if an alert was actually fired.

  1.0.3
  - Add custom app icon (forked lightning bolt, amber).
  - Manifest-only release; container image unchanged from 1.0.2.

  1.0.2
  - Config (NWC URL, Telegram tokens, threshold, addresses, amounts) now read
    from /data/config.json — survives app updates and OS upgrades.
  - docker-compose.yml no longer holds user secrets.

  1.0.1
  - Add WebSocket polyfill (ws) — fixes "WebSocket is not defined" on Node 20.
  - Run container as user 'node' (UID 1000) — fixes EACCES on /data volume.

  1.0.0
  - Initial release.
submitter: esetheyers
submission: ""