rays
0990f2a90d
Works through TODO.md from the 2026-09-11 review. Unread badges, dots and download bars take the icon's amber; the playing item is marked by EQ bars that move only while it plays. The feed list is usable from the keyboard, focus rings show everywhere, and folders get a mosaic of their shows' art with the triangle hung in the margin. Sentence-case labels, fewer bold weights, tinted initials tiles, shorter header lines, "Kept" everywhere, and the list gets the room the empty panes had. Reduced motion is honoured. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TAC7sLVqfKmY6rsTLXzNgk
3.4 KiB
Command line
ipx [--config PATH] [--local] <command>
Every command that has a wire form probes the control socket first: if a daemon is running, the
daemon does the work and the CLI just renders the events it streams back. That is deliberate — two
processes must never download the same thing. --local forces the work to happen in-process.
| Command | What it does |
|---|---|
ipx list |
Subscriptions and their state |
ipx status |
Counts: feeds, pending, downloaded |
ipx fetch [FEED] [--force] |
Scan everything, or one feed. --force ignores the TTL |
ipx add <url> [--folder X] [--keywords a,b] |
Subscribe; the id comes from the feed title |
ipx rm <feed> |
Unsubscribe; downloads and history are kept |
ipx import <file.opml> / ipx export <file.opml> |
Move subscriptions in or out. Import subscribes the first admin, as the shared web token does; in the web UI it subscribes whoever is signed in |
ipx reap [--dry-run] |
Run retention now |
ipx user <add|list|passwd|rm> |
Accounts for the web UI |
ipx daemon [--web ADDR] |
Scheduler, control socket and web UI |
Accounts
Passwords are read from stdin, so they miss the shell history and any ps listing.
echo -n 'a good password' | ipx user add ray # local account
ipx user add ray@example.com --no-password # signs in through the proxy only
echo -n 'a good password' | ipx user passwd admin # change a password
ipx user list # who exists, and how each signs in
ipx user rm sam # account, subscriptions and read state
The first account created is an admin; later ones are ordinary users. A database with no accounts at all gets admin / ipodderx on the next daemon start, announced in the log — change it.
To avoid even the command line, read it interactively:
read -s PW && echo -n "$PW" | ipx user passwd admin
Scanning
ipx fetch # everything due
ipx fetch atp --force # one feed, ignoring its TTL and schedule
A scan: conditional GET (If-None-Match / If-Modified-Since), parse, record new entries, apply
the filters, then download up to the per-scan cap, newest first. A feed nothing has changed in
answers 304 and costs one request.
Retention
ipx reap --dry-run # what would go, oldest first
ipx reap # actually delete
Files are deleted to get back under max_total_gb, oldest first, and items past max_age_days
with no file are pruned from the database. An item anyone kept keeps its file, and one only counts
as read when everyone subscribed has read it. The enclosure row survives as reaped, which is what
stops the next scan fetching it again.
The daemon
ipx daemon # scheduler + socket + web UI
ipx daemon --web 0.0.0.0:8099 # override the configured bind for one run
One daemon per socket; a second refuses to start rather than fight over the database. It shuts down cleanly on SIGTERM, including mid-download.
To kill it, match the binary exactly:
pkill -x ipx
pkill -f ipx matches the shell running the command too, and kills your own session.
Talking to it directly
printf '{"cmd":"fetch","force":true}\n' | socat - UNIX-CONNECT:$XDG_RUNTIME_DIR/ipx.sock
See architecture.md for the protocol.