~voidraven/fiou

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.

refs

master
browse  log 

clone

read-only
https://git.sr.ht/~voidraven/fiou
read/write
git@git.sr.ht:~voidraven/fiou

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

#fiou

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!

#Dependencies

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

#Installation

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

# as root
make install

# to uninstall
make uninstall

#Usage

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

asciicast

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).

#Configuration

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.

#Notes

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.