PBinCLI/README.md

66 lines
1.7 KiB
Markdown
Raw Normal View History

2019-05-31 12:44:14 +00:00
[![GitHub license](https://img.shields.io/github/license/r4sas/PBinCLI.svg)](https://github.com/r4sas/PBinCLI/blob/master/LICENSE)
[![GitHub tag](https://img.shields.io/github/tag/r4sas/PBinCLI.svg)](https://github.com/r4sas/PBinCLI/tags/)
2019-05-31 12:44:14 +00:00
[![GitHub release](https://img.shields.io/github/release/r4sas/PBinCLI.svg)](https://github.com/r4sas/PBinCLI/releases/)
2017-02-18 18:00:40 +00:00
PBinCLI
2017-02-18 18:27:24 +00:00
=====
2017-02-18 18:00:40 +00:00
#### [PrivateBin](https://github.com/PrivateBin/PrivateBin/) CLI
2017-02-18 18:27:24 +00:00
2017-02-18 18:30:56 +00:00
Installing
2017-02-18 18:27:24 +00:00
-----
2017-02-18 18:30:56 +00:00
```bash
2018-02-16 06:35:27 +00:00
$ virtualenv --python=python3 venv
2017-02-18 18:30:56 +00:00
$ . venv/bin/activate
2018-09-21 22:33:21 +00:00
$ pip install pbincli
2017-02-18 18:30:56 +00:00
```
2017-02-19 20:27:37 +00:00
2017-02-21 02:09:38 +00:00
Usage
2017-02-19 20:27:37 +00:00
-----
2018-09-21 22:33:21 +00:00
By default pbincli configured to use https://paste.i2pd.xyz/ for sending and receiving pastes. No proxy used by default.
You can create config file with variables `server` and `proxy` in `~/.config/pbincli/pbincli.conf` to use different settings.
Example contents:
```
server=https://paste.i2pd.xyz/
proxy=http://127.0.0.1:3128
```
2017-02-21 02:12:13 +00:00
Run inside `venv` command:
2017-02-21 02:09:38 +00:00
2018-09-21 22:33:21 +00:00
$ pbincli send --text "Hello!"
Or use stdin input to read text for paste:
2018-09-21 22:33:21 +00:00
$ pbincli send - <<EOF
Hello! This is test paste!
EOF
2017-02-21 02:09:38 +00:00
2018-09-21 22:33:21 +00:00
It will send string `Hello! This is test paste!` to PrivateBin.
2017-02-21 02:09:38 +00:00
To send file use `--file` or `-f` with filename. Example:
2018-09-21 22:33:21 +00:00
$ pbincli send -c "My document" -f info.pdf
2017-02-21 02:09:38 +00:00
To retrieve paste from server, use `get` command with paste info.
2017-02-21 02:12:13 +00:00
2017-02-21 02:09:38 +00:00
It must be formated like `pasteID#passphrase`. Example:
2018-09-21 22:33:21 +00:00
$ pbincli get 49eeb1326cfa9491#vfeortoVWaYeJlviDdhxQBtj5e0I2kArpynrtu/tnGs=
2017-02-21 02:09:38 +00:00
More info you can find by typing
2018-09-21 22:33:21 +00:00
$ pbincli [-h] {send, get, delete}
TODO
----
Write a more complete usage documentation.
2017-03-02 11:23:05 +00:00
License
-------
2019-05-31 12:00:28 +00:00
This project is licensed under the MIT license, which can be found in the file
2019-05-31 12:44:14 +00:00
[LICENSE](https://github.com/r4sas/PBinCLI/blob/master/LICENSE) in the root of the project source code.