TidyTransfer CLI

Upload and manage files from your terminal

Install with one command:

curl -sSL https://tidytransfer.com/install.sh | bash

Requires Python 3.6+

Quick Start

1

Login to your account

tidytransfer login

You'll be prompted for your email and password. Your session stays active until you logout.

2

Upload a file

tidytransfer upload myfile.pdf

Your file is uploaded and you get a shareable link instantly.

3

Share the link

✓ Upload complete!

  Share URL: https://tidytransfer.com/f/abc123
  Visibility: private
  Expires: 1d

→ URL copied to clipboard

Commands

Command Description
tt login Log in to your TidyTransfer account
tt logout Log out and clear saved credentials
tt whoami Show current logged in user
tt upload <file> Upload a file (private by default)
tt upload -p <file> Upload as public file
tt upload -e 1w <file> Upload with 1 week expiry (1h, 1d, 1w, 1m)
tt list List all your uploaded files
tt download <id> Download a file by ID
tt delete <id> Delete a file
tt config View or change configuration

💡 Tip: Use tt as a shortcut for tidytransfer

Examples

Upload a public file that expires in 1 week

tt upload -p -e 1w presentation.pdf

Upload multiple files

for f in *.pdf; do tt upload "$f"; done

Download to a specific folder

tt download 123 -o ~/Downloads/

Set default visibility to public

tt config default_visibility public

Alternative Installation

Using pip directly

pip install tidytransfer

Using pipx (isolated install)

pipx install tidytransfer