SHARING

Sharing files.

Pick files, get a link. The files stay on your computer, and recipients download them from it through the xposed relay. We don't keep a copy.

Right-click#

In GNOME Files, right-click a file (or select several first), choose Scripts, then Share with xposed. A control panel for the new share opens in your browser. If something goes wrong, for example a file that is too large, Files shows a notification with the reason. Other file managers don't have this action yet; use the command line.

The command line#

xposed share [--pin] [--max-downloads N] [--expires 48h] <file...>

Give it one file or several; several files share under one link. It prints the link, when it expires, the PIN if you asked for one, and the address of the control panel, and opens the control panel in your browser.

Flag	What it does
`--pin`	Require a 6-digit PIN. It is printed once when you share; you can also add or replace one later from the control panel.
`--max-downloads N`	Close the link once N different people have downloaded. The default, 0, means no limit.
`--expires 48h`	How long the link stays live, for example `6h` or `72h`. The default is 24 hours, and it is capped at your plan's maximum: 24 hours on Free, up to 7 days on Pro.

$ xposed share --pin --max-downloads 3 --expires 72h ~/Clients/wedding-selects.zip

The control panel#

Every share has its own control panel on your computer, at an address like http://xposed.localhost/control/<token>. It shows the link and a QR code, and lets you:

Add, replace or remove a PIN. Recipients then need it before they can download. Five wrong tries lock the share for 30 seconds. The PIN is there to stop casual guessing, so treat it as a lock on a door, not a vault.
Set a download limit. The link closes on its own once that many different people have downloaded.
Change the expiry. Pick a length and the clock restarts from now. Lengths beyond your plan's maximum are marked Pro.
Close the share. The link and QR code stop working at once, for everyone, and downloads in progress are cut off.
See who downloaded. Each download's file, time, browser and bytes sent are logged live, and you can export the log as a CSV file.

The local dashboard#

Everything you're sharing is listed at http://xposed.localhost, with a copy button and a close button for each share, totals for downloads and data sent, and how much time each link has left. Open it from the terminal with xposed open (or xposed open <token> for one share's control panel), or pick xposed from your app menu. It also shows your plan and this month's transfer usage.

Only you can open the dashboard and control panels. Requests that arrive through the relay, or from other users of your computer, are refused. If port 80 isn't available it is at http://xposed.localhost:9767.

xposed list

lists your open shares in the terminal, with their links and download counts. xposed close <token> closes one.

What recipients see#

Anyone with the link opens a plain page, "Files shared with you", that lists the files with their sizes and a Download button for each. They don't need an account or to install anything. Downloads resume if the connection drops. If you set a PIN, they enter it first.

If the link can't be used, they see why: it was closed, it expired, it reached its download limit, or the file is no longer on your computer. Every recipient page has a link to report abuse. Sharing links unfurl with a small preview in chat apps; a PIN-protected share shows only a generic one.

Links expire#

xposed is for handing files over, not for hosting them. A link stops working when it expires, whether or not anyone has downloaded, and you can close it sooner. On Free links last 24 hours. On Pro you can choose up to 7 days. Share again for a fresh link.

Your computer stays on#

Your computer serves the file, so it has to stay on, online and running xposed while a link is open. The daemon starts when you log in, and links reconnect after a reboot. If your computer is off or asleep, the link won't open until it's back.

Who can find a link#

Links use long random tokens, but anyone who has one can download, so treat a link like the file itself. Share pages are never indexed by search engines: they carry a noindex tag and header, and the relay's robots.txt disallows everything. The download log stays on your computer.