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 --pin <file> Upload as PIN protected 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 PIN protected file that expires in 1 week

tt upload --pin -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 PIN protected

tt config default_visibility pin_protected

Alternative Installation

Using pip directly

pip install tidytransfer

Using pipx (isolated install)

pipx install tidytransfer