Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
FB(1)			  BSD General Commands Manual			 FB(1)

     fb	-- a client for

     fb	[options] file|directory|id://ID|URL ...
     fb	[-dg] [options]	ID|URL ...
     fb	[-hv]

     fb	is a client to which allows the user to easily
     upload, delete or download	files.	By default, files will be uploaded as-
     is	and a link to the file will be printed to stdout after each upload. If
     multiple files are	uploaded a multipaste (	see --multipaste ) will	be
     created automatically.

     Directories will be packed	into a tarball and the resulting upload.tar
     file will be uploaded.  If	no arguments are given,	data will be read from
     stdin into	a temporary file that will be uploaded as soon as EOF is re-
     ceived.  If the file being	uploaded is bigger than	10MiB fb will query
     the server	for the	maximum	upload size and	abort the upload if the	file
     would be rejected.	 Before	terminating, fb	will try to copy all links
     into the X	clipboard if xclip(1) or on Darwin pbcopy is installed.

     If	you want to use, you need	to create an account there and
     then run `fb -a' to create	an API key.

     IDs of existing pastes can	either be given	as URLs	pointing to that paste
     or	by prefixing the ID with "id://".

     -c, --compress
	     Compress the files	to be uploaded using gzip(1).  This affects
	     all files including piped content and directories.	 If specified
	     twice, xz(1) will be used rather than gzip.  If used in conjunc-
	     tion with the -g option this decompresses the download before
	     it's output to stdout.

     -d, --delete
	     Delete the	IDs. You can no	longer upload files in this mode. If
	     the argument is a URL, fb will try	to extract the ID. This	option
	     also accepts IDs without the "id://" prefix.

     --config _config file_
	     Use an alternative	configuration file. The	default	value is

     -e	extension, --extension extension
	     Change the	extension used for highlighting. You can also do this
	     if	you have already uploaded the file by appending	the extension
	     to	the URL.<ID>/bash will change the syn-
	     tax highlighting to bash.

     -n	_file name_, --name _file name_
	     Use the specified file name for the upload	when pasting from
	     stdin. Defaults to	"stdin"

     -a, --create-apikey
	     Create a new API key. Asks	for username and password.

     -H, --history
	     Display a history of uploads.

     -g, --get
	     Download the IDs and output on stdout. Please take	care when us-
	     ing this, as binary data may cause	unexpected results when	being
	     output directly to	a terminal. You	can no longer upload files in
	     this mode.	If the argument	is a URL, fb will try to extract the
	     ID. This option also accepts IDs without the "id://" prefix.

     -m, --multipaste
	     Create a multipaste of the	IDs/files/directories/URLs. This up-
	     loads files as always, but	then creates a multipaste combining
	     all of them. URLs starting	with the pastebin URL will have	their
	     ID	extracted and will not be downloaded. Only the multipaste URL
	     will be displayed and copied to the clipboard. This option	is en-
	     abled automatically if multiple files are uploaded.

     -h, --help
	     Display a short help message.

     -t, --tar
	     Upload a tar file containing all files and	directories specified
	     on	the command line. The file name	can be specified with the -n
	     option. (don't add	any extensions)

     -v, --version
	     Display the client	version.

     -D, --debug
	     Display debugging information.

	     This file contains	the API	key to use for authentication.

	     This file allows to override certain variables by using the for-
	     mat 'option_name="value"'.	 Both, the option value	and name, are
	     case-sensitive string literals.  Environment variables can	be
	     used in the value by using	the $VARIABLE_NAME syntax.

	     The following option names	are supported:

		     The URL of	the pastebin you want to use

		     The command used to copy URLs of uploaded files to	the
		     clipboard.	This defaults to pbcopy	on Darwin and xclip

		     The file that contains the	API key. This defaults to

     Some options can be changed by modifying environment variables:

     GZIP     Assigning	GZIP will make the gzip-program	treat it's value as if
	      they had been appended to	the command line.

     XZ_OPTS  The XZ_OPTS environment variable can be used in order to pass
	      additional options to xz,	in case	xz is used for compression.

     TMPDIR   Setting TMPDIR to	some directory where fb	creates	temporary
	      files inside this	directory rather than the system default.

     fb	-tc directory file
	     This will create a	.tar archive containing	the directory and the
	     file and compress it using	gzip and upload	one archive.

     fb	-c directory file
	     This will create a	.tar archive containing	only the directory.
	     Both (directory and file) will be compressed using	gzip and up-
	     loaded independently.

     fb	-cc directory
	     This will create a	.tar archive containing	only the directory and
	     compress it using xz.

     fb	id://1bAc directory file
	     This will create a	multipaste containing an existing paste	with
	     the ID 1bAc, a tarball of the directory, the file,	the existing
	     paste 42SomeID, the file example.png, which will be downloaded by
	     the client	and then uploaded to the server.

     make |& fb
	     This will upload the output of make (stdout and stderr) in	csh
	     and similar shells.

     curl(1), gzip(1), tar(1), xz(1), xclip(1)

     fb	was written by
     +o	 Florian Pritz <>
     +o	 Moritz	Wilhelmy <>
     and may be	copied under the terms of the GPLv3.

BSD				April 11, 2016				   BSD


Want to link to this manual page? Use this URL:

home | help