Usage

This page covers all the ways you can use fileup.

Basic Usage

Upload a file with:

fu filename

Command Line Options

usage: fu [-h] [-t TIME] [-d] [-i] filename

Publish a file.

Create a config file at ~/.config/fileup/config.ini with the following structure:

[default]
protocol = ftp  # or scp
hostname = example.com  # or the Host from your ~/.ssh/config
base_folder = /path/to/files  # where files are stored on the server
file_up_folder =  # subdirectory in URL, can be empty
url = files.example.com  # the actual URL where files are accessible

[ftp]
username = my_user_name
password = my_difficult_password

[scp]
# If empty, will use your SSH config
username =
# If using SSH config, no need for these
private_key =
password =

positional arguments:
  filename

options:
  -h, --help       show this help message and exit
  -t, --time TIME  If time is 0 the file will never be deleted, default is 90 days.
  -d, --direct
  -i, --img

Options Explained

-t DAYS, --time DAYS: Set an expiration time in days (default: 90, use 0 for no expiration)
-d, --direct: Return a direct URL without any prefixes
-i, --img: Return the URL formatted for markdown image embedding

Special Features

Jupyter Notebooks: If you're uploading a Jupyter notebook (.ipynb), the returned URL will be accessible via nbviewer.jupyter.org
Automatic Deletion: Files with expiration times are automatically removed when their time is up
URL Copying: On macOS, the URL is automatically copied to your clipboard

macOS Integration

fileup currently supports the pbcopy command, so the URL will be automatically copied to your clipboard on macOS systems.