# Epaste [![build status](https://gitlab.com/zetok/epaste/badges/master/build.svg)](https://gitlab.com/zetok/epaste/commits/master)

**Epaste** encrypts given data and turns encrypted bytes into `base64` text
which can be easily pasted/retrieved on e.g. pastebin website.

User needs to supply a password that will be used to encrypt / decrypt the
data.

Decrypting can fail only if provided data is not valid.


## Usage

To encrypt data:

```bash
epaste 'password' < 'file with text'
```

To decrypt data into a file:

```bash
epaste -d 'password' < 'file with encrypted text' > 'output file'
```

**When decrypting non-plaintext data take care to redirect Epaste output
to a file!**

## Packages

* [Arch Linux](https://aur.archlinux.org/packages/epaste/)


## Dependencies
| **Name** | **Version** |
|----------|-------------|
| libsodium | >=1.0.4 |

## Building

You'll need [Rust] and [libsodium].

When you'll have deps, build debug version with
```bash
cargo build
```

## Install

The easiest way is to use [`Cargo`]:

```bash
cargo install epaste
```

If your distribution has been updated in recent years, it is very likely that
[`Cargo`] is already available. However if that's not the case, you can use
[Nix] package manager to get some newer stuff. Or just install [`Cargo`] without
using package manager. Whatever floats your boat.

## Updating

In case of newer version, updating is almost like installing:

```bash
cargo install --force epaste
```

## Goals
- [x] encrypt/decrypt message with given password
- [x] CLI interface

## Support

If you like Epaste, feel free to help it by contributing, whether that would be
by writing code, suggesting improvements, or by donating.

Donate via Bitcoin: `1FSDbXVbUZSe34UqxJjfNMdAA9P8c6tNFQ`

*If you're interested in some other way of donating, please say so. :smile:*

## License

Licensed under GPLv3+. For details, see [COPYING](/COPYING).

[`Cargo`]: https://doc.rust-lang.org/cargo/
[libsodium]: https://github.com/jedisct1/libsodium
[Nix]: https://nixos.org/nix/
[Rust]: https://www.rust-lang.org/