4 stable releases

Uses old Rust 2015

2.0.0 Jun 11, 2017
1.2.0 Jul 16, 2016
1.1.0 Jun 27, 2016
1.0.0 Jun 22, 2016

MPL-2.0 license

2.5K SLoC


A tool for pasting from the terminal.

Travis Crates.io Crates.io license

Supports GitHub Gist, Pastebin, hastebin, sprunge, Bitbucket snippets, and fedora pastebin.


bins is built with the latest Rust nightly. Other versions can be used, but your mileage may vary.


No Rust

Don't want to install Rust? A precompiled binary may be available for your architecture at the latest release.


If you want to install the latest release from crates.io:

# If you don't have Rust installed:
# curl https://sh.rustup.rs -sSf | sh
cargo install bins


Building from source requires the nightly compiler!


Depending on the features of bins you have enabled, there are different requirements for building bins from source.

  • openssl
    • libssl-dev
  • clipboard_support
    • xorg-dev on Linux
  • file_type_checking
    • libmagic-dev
  • rustls
    • No requirements

If you want to install the latest version from the repository:

git clone https://github.com/jkcclemens/bins
cd bins
# If you don't have Rust installed:
# curl https://sh.rustup.rs -sSf | sh
cargo install

Add $HOME/.cargo/bin to your $PATH or move $HOME/.cargo/bin/bins to /usr/local/bin.


To upgrade an existing installation from crates.io:

cargo install --force bins

To upgrade an existing installation from source:

cd bins
git fetch origin && git reset --hard origin/master
cargo install --force


To get help, use bins -h. bins accepts a list of multiple files, a string, or piped data.

Take a look at some of the written examples below:


Creating a paste from stdin

$ echo "testing123" | bins -b gist

Creating pastes from files

Pasting a single file:

$ bins -b gist hello.c

bins supports pasting multiple files, too. With services such as GitHub's gist, these are natively supported. For services which don't support multiple file pastes, an index paste is created and returned which links to individual pastes for each file.

$ bins -b gist hello.c goodbye.c

Specifying visibility options

By default, bins will use the defaults.private option from the config file to determine whether or not to create a private paste. The default value of this is true - so new pastes will be private for a fresh install. You can override this at the command line:

$ bins --public --bin gist hello.c


Running bins at least once will generate a configuration file. Its location is dependent on the environment that bins is run in. The configuration file will be created at the first available location in the list below:

  • $XDG_CONFIG_DIR/bins.cfg
  • $HOME/.config/bins.cfg
  • $HOME/.bins.cfg

If none of these paths are available ($XDG_CONFIG_DIR and $HOME are either both unset or unwritable), bins will fail and not generate a config file.

The configuration file is documented when it is generated, so check the file for configuration documentation.


~296K SLoC