Downloads

Listam on every device you own. Your lists stay yours on all of them.

Mobile

Android

On the Play Store, with automatic updates. 1 month free trial, then 1 CHF/year.

Get it on Play Store

iOS

The App Store release is on its way.

Coming soon

Desktop

BETA

Listam for desktop

Version 0.12.0 · macOS, Windows & Linux · runs on the Pear runtime

  1. 01 Install the Pear runtime — Listam runs on it and arrives peer-to-peer, no installer download needed.
  2. 02 In your terminal — Terminal on macOS, PowerShell on Windows, your shell on Linux — run the line below. Pear fetches Listam over the swarm and asks you to trust it once.
pear run pear://h1jwexik1m9c75rqng8hico4oxqgmm8xskws684skmjepksq5r3o
  1. 03 That's it. Launch it the same way any time — updates arrive peer-to-peer, automatically.
Native installers are in the works — a drag-install .dmg for macOS, plus installers for Windows and Linux. The beta currently ships through the Pear runtime only.

Headless

BETA

The always-on Listam peer for hardware you own — a Raspberry Pi, a mini PC, a NAS. It is not a cloud service: it keeps your lists available and durable on your own device, even when your phone is off. Requires Node.js 22+ and Linux for the always-on service (Raspberry Pi OS, Debian, Ubuntu).

From npm

RECOMMENDED
npm install -g listam-headless
listam-headless install --storage ~/listam-data --invite <code>

install sets the peer up, registers a systemd user service that survives reboots, starts it, and joins your list. The invite code comes from the share flow in the Listam app on your phone or desktop. Use a global install rather than npx — the service points at the package on disk.

tar xzf listam-headless-0.13.0.tgz && cd package
npm install --omit=dev
node headless.mjs install --storage ~/listam-data --invite <code>

Same peer, no registry account needed. The tarball pulls its dependencies from npm on install.

From source

git clone https://github.com/romme86/listam-headless.git
git clone https://github.com/romme86/listam-packages.git
cd listam-headless && npm install

The checkout expects the shared @listam/* packages cloned next to it. Build it, read it, change it — it's yours.

Living with it

listam-headless status --storage ~/listam-data   # live snapshot
journalctl --user -u listam-headless -n 20       # service log
listam-headless uninstall --storage ~/listam-data

The service restarts itself after crashes and reboots. Your data stays under ~/listam-data, also after an uninstall.

Checksums

Verify what you downloaded before you run it — SHA256SUMS.txt:

listam-headless-0.13.0.tgz   8aaa1a1305115fb630deb4e99cbd5ff698275cd1ca70ef16df82546456a23534
shasum -a 256 -c SHA256SUMS.txt

Want the deep technical story? The AI Wiki covers the desktop app and the headless peer in detail.