← Plugins

File downloads

Download files linked in agent replies through expiring HTTP links.

$ paseo plugin add ntr5uki/file-download
Report a bug
ntr5ukiUtils26installsa54670376343Source
File downloads screenshot 1File downloads screenshot 2File downloads screenshot 3File downloads screenshot 4

Download files linked in agent replies from a card below the conversation. Installers, archives, documents and other regular files use the same download action. A card appears after a completed reply contains explicit Markdown file links. The /download command can also add a specific file or collect links from the latest reply.

Requires Paseo 0.15.4 through 0.16.x. By default, each device automatically finds and verifies a reachable local, LAN or Tailscale download address. Download settings includes Test connection; Advanced settings has an optional custom URL for reverse proxies and other network arrangements. The HTTP service uses port 6768 and listens on all interfaces by default. It still needs a network path to that port or a proxy. HTTPS web clients should use an HTTPS custom URL when browser policy blocks HTTP discovery. The plugin does not modify Paseo or create a relay tunnel.

Discovery checks a short-lived proof from the selected daemon before using an automatically selected address; probe requests contain no download ticket. Address caches belong to each client, so different devices can use different routes. Clicking Download requests a single-use link valid for five minutes. File bytes stream directly from the daemon host to your browser, without passing through the model or being assembled in plugin RPC responses. Desktop and web use the browser download manager. Linux desktop downloads have been verified. Native mobile opens the link in the system browser, where downloads have been reported to stall with WireGuard/VPN configurations. General mobile download support remains unverified.

Only non-hidden regular files inside the agent's workspace can be downloaded. Symlinks escaping the workspace, hidden directories, folders and external URLs are excluded. A file changed since the link was issued requires a new link. The plugin reads replies and file metadata to build cards, and reads file contents only when you download. File contents and credentials are not stored in cards or sent to an external service. Anyone holding an unexpired link can download that one file once. Resuming a transfer with the same link is not supported.