whyblocked/README.md

93 lines
2.3 KiB
Markdown
Raw Normal View History

2018-10-14 03:12:30 +02:00
**Whyblocked** reminds you why you blocked someone. It is developed with
2018-08-30 14:03:25 +02:00
Mastodon in mind, but can be used for other contexts, of course.
It has a text interface and uses a SQLite-database.
2018-08-30 14:30:55 +02:00
## Usage
2018-08-30 16:40:06 +02:00
### Example
2018-08-30 14:30:55 +02:00
```PLAIN
$ whyblocked
2018-08-30 16:54:34 +02:00
This is whyblocked 0.4.1.
2018-08-30 14:30:55 +02:00
Type add, remove, view or details. Or just the first letter.
2018-08-30 16:40:06 +02:00
Type quit or q to quit the program.
: add
User or instance: @tastytea@soc.ialis.me
Blocked(b) or silenced(s): b
Reason: Too nice
2018-08-30 16:54:34 +02:00
@tastytea@soc.ialis.me added.
2018-08-30 16:40:06 +02:00
Add receipt? [y/n] y
URL: https://tastytea.de/
2018-08-30 16:54:34 +02:00
Receipt added.
2018-08-30 16:40:06 +02:00
Add receipt? [y/n] n
: view
Blocked: @tastytea@soc.ialis.me because: Too nice
: details
User or instance: @tastytea@soc.ialis.me
@tastytea@soc.ialis.me is blocked, because: Too nice
2018-08-30 14:30:55 +02:00
Receipts:
2018-08-30 16:40:06 +02:00
https://tastytea.de/
: remove
User or instance: @tastytea@soc.ialis.me
2018-08-30 16:54:34 +02:00
@tastytea@soc.ialis.me removed.
: view
: details
User or instance: @tastytea@soc.ialis.me
@tastytea@soc.ialis.me is not in the database.
2018-08-30 16:40:06 +02:00
: quit
2018-08-30 14:30:55 +02:00
```
## Install
2018-08-30 23:53:58 +02:00
### Packages
Every [release](https://schlomp.space/tastytea/whyblocked/releases) includes
a .deb-package, an .rpm-package and a .tar.gz-package with precompiled binaries
for x86_64(amd64). These are automatically built and not tested. You can install
them with `dpkg -i` or `rpm -i`, respectively.
Gentoo ebuilds are available via my
[repository](https://schlomp.space/tastytea/overlay).
### From source
#### Dependencies
2018-08-30 14:30:55 +02:00
2018-10-13 23:33:13 +02:00
* C++ compiler (tested: [gcc](https://gcc.gnu.org/) 6/7/8,
[clang](https://llvm.org/) 6)
* [cmake](https://cmake.org/) (at least 3.6)
2018-08-30 14:30:55 +02:00
* [vsqlite++](http://vsqlite.virtuosic-bytes.com/) (tested: 0.3.13)
* [libxdg-basedir](http://repo.or.cz/w/libxdg-basedir.git) (tested: 1.2)
2018-10-13 23:33:13 +02:00
* [qtwidgets](https://www.qt.io/) (tested: 5.9/5.7)
2018-08-30 14:30:55 +02:00
2018-08-30 23:53:58 +02:00
#### Get sourcecode
Download the current
[release](https://schlomp.space/tastytea/whyblocked/releases).
#### Compile
2018-08-30 14:30:55 +02:00
```SH
mkdir build
cd build
cmake ..
make
make install
```
2018-08-30 18:10:59 +02:00
2018-08-31 16:09:02 +02:00
## Bugs
Please report them on the
[issue tracker](https://schlomp.space/tastytea/whyblocked/issues) or to
`tastytea`@`tastytea.de`.
2018-08-30 23:53:58 +02:00
## Copyright
2018-08-30 18:10:59 +02:00
```PLAIN
Copyright © 2018 tastytea <tastytea@tastytea.de>.
License GPLv3: GNU GPL version 3 <https://www.gnu.org/licenses/gpl-3.0.html>.
This program comes with ABSOLUTELY NO WARRANTY. This is free software,
and you are welcome to redistribute it under certain conditions.
```