a CLI tool for www.file.io -- the ephemeral file sharing site
Added build file and badge. Updated makefile to include test target.
Merge branch 'i-flag'
Added the -i flag and -o flag, Added more error checking, updated man pages and readme, version bump.


browse  log 



You can also use your local clone with git send-email.


License builds.sr.ht status

file.io uploader 📑 🡆 ☁️

A command line utility for using www.file.io; the ephemeral file sharing site. Encrypt and upload your file with one easy command from the comfort of your favourite shell!


fiou is compatible with any POSIX shell, i.e. bash, zsh, ksh, etc.


git clone https://git.sr.ht/~voidraven/fiou
cd fiou
make deps

# as root
make install

# to uninstall
make uninstall


fiou to_share.txt                  # upload to_share.txt
  fiou -e ./workdir/                 # encrypt workdir and upload*
  fiou -a song.mp3                   # get pass from xpg, encrypt file, and upload**
  fiou -x 4m secret.txt              # upload to_share.txt, expires after 4 months
  fiou -x 1y -e temp\ dir/           # encrypt temp\ dir and upload, setting expiration to one year
  fiou -x 12w -a song.mp3            # get pass from xpg, encrypt file, then upload, setting expiration to twelve weeks
  fiou -o                            # output your settings from ~/.fiourc
  fiou -i to_share.txt               # ignore the ~/.fiourc settings file (use defaults)
  fiou -h                            # show this help message
  fiou -v                            # show the version info
  (-e flag requires the qe application *)
  (-a flag requires the xpg and qe application **)
  (both of these applications can be found at https://git.zerohack.xyz/lotus)
#Video Example


fiou will tar and gzip directories by default prior to upload. If you install the optional dependency qe, it can handle more customizable settings like changing the compression algorithm and flags (as well as encryption).


If you would like to set the default behavior of fiou, it looks for a configuration file in your home directory ~/.fiourc. This will help you by allowing you to skip entering flags manually.


While this tool will work fine without installing xpg or qe, I've included them because it streamlines the process of protecting your file uploads. If you have a lot of files it is a pain to encrypt each one by hand before uploading it. There is a 5GB limit to what you can upload; fiou will check before beginning the upload to make sure we don't exceed this limit. If you are close to this limit it would be advisable to compress your file prior to calling fiou to make it past this size check successfully.

#License / Disclaimer

This project is licensed under the ISC license. I am not associated with the file.io team or introvert.com in any capacity. I cannot guarantee against any potential problems with using this service or tool, including site uptime. I would recommend having a backup of whatever files you upload to this service in order to prevent data loss.