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

Windows

10 & 11 · 64-bit

One download, nothing to set up first — Listam brings the Pear runtime with it and fetches itself over the swarm on first launch. Version 0.19.13.

Download for Windows

14 MB · SHA-256 f9d30654d9a3c8724d2c4d9918aa198d7ef75b6cd19414d3b77920d380a4f671

  1. 01 Run the installer. It installs just for you, so there is no administrator prompt, and it adds Listam to your Start menu.
  2. 02 Windows shows a blue “Windows protected your PC” box. Click More info, then Run anyway — the button only appears after “More info”, which is what makes this step easy to miss. You see this once, on the installer; the app itself opens with no warning afterwards.
  3. 03 First launch fetches the app peer-to-peer behind the splash screen, so give it a moment. After that it starts straight away.
Why the warning? Listam is not code-signed yet, so Windows cannot name the publisher and marks it “unknown”. That is a statement about the certificate, not about the file — nothing needs to be switched off, and you should not turn off any protection to run it. If you want to confirm you have the genuine build, compare the SHA-256 above against your download: run Get-FileHash .\Listam-Setup-0.19.13-win32-x64.exe -Algorithm SHA256 in PowerShell. Signed builds are on the way.

Would rather not run an installer? Download the portable zip (17 MB) instead — unzip it and keep Listam.exe and splash.png together in the same folder.

macOS & Linux

via the Pear runtime

Version 0.19.13. A native installer is still to come here — for now Listam arrives through Pear, with no installer to download.

  1. 01 Install the Pear runtime — Listam runs on it and arrives peer-to-peer.
  2. 02 In Terminal on macOS, or 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.

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.14.2.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.14.2.tgz   38863937d20aed4a0bb665b270ba0840ed62ed7fe77ed9690fd4f63c6b6d8003
shasum -a 256 -c SHA256SUMS.txt

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