@medialit/cli

Upload and manage MediaLit files from the terminal.

npm install -g @medialit/cli
medialit login
medialit upload photo.jpg --public

Log in

medialit login

Your browser opens to sign in. If you have more than one app, you choose the app the CLI works with. Run medialit login again to choose a different one.

For a self-hosted MediaLit, pass its URL once. Later commands use the server you last logged in to:

medialit login --endpoint https://medialit.example.com

Without a browser, for example over SSH, use --no-browser and open the printed URL on another device whose browser can reach this machine's 127.0.0.1.

In CI, skip logging in and set MEDIALIT_API_KEY (and MEDIALIT_ENDPOINT if you self-host).

Commands

| Command | What it does | | -------------------------- | -------------------------------------------------- | | medialit upload <files…> | Uploads and seals files, then prints their URLs | | medialit ls | Lists sealed files, newest first | | medialit get <id> | Prints a file's URL, a fresh one for private files | | medialit seal <id> | Keeps a temporary upload | | medialit rm <id> | Deletes a file | | medialit whoami | Shows the server, account, app and storage used | | medialit logout | Logs out of the server |

Uploads are private unless you pass --public. Add --caption <text> or --group <name> to label them, or --temp to leave them unsealed so MediaLit deletes them after 24 hours. Large files are uploaded in chunks and retried if the connection drops.

ls takes --public, --private, --group <name>, --page <n> and --limit <n>.

Every command takes --json. URLs and JSON go to stdout and messages to stderr, so you can pipe the output:

medialit upload report.pdf --public | pbcopy

Where your login is stored

In ~/.config/medialit/credentials.json (%APPDATA%\medialit on Windows), readable only by you. Set MEDIALIT_CONFIG_DIR to use another folder.