-
Notifications
You must be signed in to change notification settings - Fork 0
Troubleshooting
Argus is a PWA with a service worker. When a new version is deployed a bar offers Reload; if you never see it, force it — Ctrl+Shift+R on a desktop, or close and reopen the tab on a phone. Almost every "that feature isn't there" turns out to be this.
Android's predictive keyboard delivers the commit of a word as an input event of its own, on top of what the composition already produced, so the terminal receives it twice. Argus drops a second identical chunk within 250ms of a composition ending. If it still happens, say which keyboard: the guard is deliberately narrow so that a keyboard which does not duplicate never loses a word.
It asks tmux to leave copy-mode, so it only works when tmux is holding the history. When a
program has taken the mouse — an agent's own transcript view, a pager — that program is
scrolling itself and only its own key returns to the end. Scroll with ^B [ instead and
the button works.
http://localhost:5002 printed in a session is correct on the machine and meaningless on
the phone reading it. Argus can serve it for you, but only with --allow-proxy. Without
it, the link says so rather than opening a dead tab.
In a terminal Ctrl+C is SIGINT and has to stay SIGINT. Use the ⧉ button: it takes the browser selection, or tmux's paste buffer when there is none.
It should not any more — but if it happens, it is nearly always the pause. The text goes in one write and the return follows in another, and an agent that assembles a paste needs a gap between the two or it takes the return as more of the paste.
Settings → Sending → Pause before the Enter. Half a second suits everything tried here; make it longer for an agent that wants longer. Press Enter twice is the last resort, and it is off on purpose: a second return also answers whatever dialog the first one opened.
If the prompt is not meant to send itself, there is nothing wrong — a prompt sends itself only when it carries the ↵ mark, which is set where the prompt is written.
On a phone there is no Ctrl, and Firefox keeps Ctrl+B for its bookmarks sidebar. Use the ^B key in the bar.
Look at the first lines Argus printed when it started:
tmux NOT FOUND — no sessions and no terminals until it is installed
(files, documents and the machine page work regardless)
Argus drives tmux by running it; without tmux on the machine there is nothing to attach to.
It does not refuse to start, because the file browser, the documents and the machine page
work perfectly well without it — but everything about sessions is dead until you
dnf install tmux (or apt, or brew).
If it does say a version, that line is worth quoting in a bug report: capture-pane -p
crashes the server outright on some 3.3a builds, and more than one oddity here has turned
out to be the tmux version rather than Argus.
Every default now takes two modifiers — Ctrl+Alt for the screens down the side,
Ctrl+Shift for the desk you are on — because a bare letter fires anywhere that is not a
terminal or a text box, and a listing, a document and the journal are none of those. If
yours are still bare letters, or single-Ctrl ones the browser eats, they are what an older
version set: open the list with ? and Put the original keys back.
Two clients on one session cannot both choose the size. Press 🔒 on the one that is only watching, or ⤢ on the one you are working in. See Sessions and the terminal.
A listing re-reads itself every few seconds and redraws when something changed. In tree view it does not — that would close every branch you opened — so use the ↻ button.
Start the server with --allow-write. Browsing works without it; nothing that changes a
file does.
Searching needs pdftotext (poppler) on the machine. If the file itself is a scan there is
no text in it to find, and Argus says which of the two it is.