new README

Signed-off-by: fbt <fbt@fleshless.org>
This commit is contained in:
Jack L. Frost 2016-03-06 07:18:59 +03:00
parent 71744b6325
commit f05682e9a7
2 changed files with 44 additions and 26 deletions

View File

@ -1,38 +1,50 @@
LICENSE ufw-tools
======= =========
All scripts here are released uder the ISC permissive free software license (http://en.wikipedia.org/wiki/ISC_license).
It basically says that you can do whatever you like with the code as long as you credit the author and provide the license with it. ufw-tools are two simple-ish scripts for uploading files to 8fw.me.
Also see LICENSE in the repo.
Support Support
======= =======
I do not promise any support for any of the provided scripts. That said, I'll do what I can for you if I'm not too busy and/or drunk. I do not promise any support for any of the provided scripts. That said, I'll do what I can for you if I'm not too busy and/or drunk.
General information
===================
The paths are all configurable of course.
The help information that the scripts give is dynamic and is provided here only for reference.
Scripts Scripts
======= =======
ufw ufw
--- ---
A very simple tool to upload files to the zfh.so file hosting
ufw is the main one, it uploads shit.
Usage: ufw [-RsF] [-D num] [file/url]" Usage: ufw [-RsF] [-D num] [file/url]"
Flags: Flags:
-R # Remove the file after uploading. -R # Remove the file after uploading.
-s # Make a screenshot and upload it instead of a file. -s # Make a screenshot and upload it instead of a file.
-F # Make a fullscreen shot instead of prompting for a window/area. Implies -s. -F # Make a fullscreen shot instead of prompting for a window/area. Implies -s.
-D <num> # Delay the shot by <num> seconds. -d # Supply a dexcription.
-p # Make the file private. Requires $secret to be set in the config. -D <num> # Delay the shot by <num> seconds.
-m # Maximum filesize (takes K, M and G suffixes). -p # Make the file public.
-u # Generate a shortlink from URL.
-m # Maximum filesize (takes K, M and G suffixes).
-a # Add the file to an album.
-A # API response format.
Config options (~/.config/ufw): Config options (~/.config/ufw):
secret # Your personal token. Get it at https://zfh.so/settings_form secret # Your personal token. Get it at https://zfh.so/settings_form
cfg_screenshot_ext # Screenshot file type, used by scrot. cfg_screenshot_ext # Screenshot file type, used by scrot.
# Others are self-explanatory: cfg_max_filesize # Maximum filesize in megabytes.
cfg_url_regex # Others are self-explanatory:
cfg_tmp_dir cfg_url_regex
cfg_script_url cfg_tmp_dir
cfg_service_url
ufwd
----
ufwd periodically checks a directory of your choosing (defaults to $XDG_RUNTIME DIR/ufwd) and invokes ufw to upload the files and remove them.
Usage: ufwd [-hn] [-d workdir] -D [check delay]
-h # Show this message.
-n # Enable notifications with notify-send. Must be installed.
-d [path] # Set the dir that is to be watched.
-D [sec] # Set the check interval.

8
ufwd
View File

@ -13,7 +13,13 @@ cfg_scan_delay='30'
msg() { printf '%s\n' "$*"; } msg() { printf '%s\n' "$*"; }
err() { echo "$*" >&2; } err() { echo "$*" >&2; }
usage() { echo "No help available."; } usage() {
printf 'Usage: ufwd [-hn] [-d workdir] -D [check delay]\n'
printf ' -h # Show this message.\n'
printf ' -n # Enable notifications with notify-send. Must be installed.\n'
printf ' -d [path] # Set the dir that is to be watched.\n'
printf ' -D [sec] # Set the check interval.\n'
}
main() { main() {
while (( $# )); do while (( $# )); do