um-pmag

um-pmag submits a magnet link to the premiumize transfer API, prints live transfer progress, and opens um-pmdl when the transfer finishes so the new content can be browsed and downloaded.

Setup

• curl for the transfer API calls.
• jq for parsing the API responses.

• A credentials file ~/.config/premiumize/creds containing one line:

• wl-paste (Wayland) or xclip (X11), only when no magnet link is passed as an argument.

The credentials line:

apikey=...

The key comes from the premiumize control panel, API section, key type "api key". Keep the file readable only by you (chmod 600).

Usage

um-pmag "magnet:?xt=urn:btih:..."   # explicit link
um-pmag                             # link from the clipboard

An argument always wins over the clipboard. A value that does not start with magnet: is rejected before anything is sent.

Behavior

• The transfer is created first; um-pmag then polls the transfer list every two seconds and prints status, percentage and name on one line.
• When the transfer finishes, um-pmdl opens for browsing and downloading.
• Exiting um-pmag early never cancels the transfer; it keeps running on the server. Re-running um-pmag with the same link creates a second transfer — use the premiumize web panel to remove duplicates.

Statuses

The progress line shows the API status verbatim: waiting while queued, downloading with a percentage, finished on success, error on failure.