whyblocked/README.md

Whyblocked allows you to store the reason why you blocked someone, along with "receipts", URLs to the posts that led you to block them.

It has a text- and a Qt-interface and uses an SQLite-database.

Usage

For the text interface start whyblocked, for the Qt interface whyblocked-gui. You can also start it from the menu of your desktop environment.

Install

Packages

Every release includes a .deb-package, an .rpm-package and a .tar.gz-package with precompiled binaries for x86_64(amd64) (more info). These are automatically built and not tested. You can install them with dpkg -i or rpm -i, respectively. The packages are signed with the PGP key 242E5AC4DA587BF9 (Fingerprint: F730 1ADF C9ED 2624 48C4 2B64 242E 5AC4 DA58 7BF9).

Gentoo ebuilds are available via my repository.

From source

Dependencies

• C++ compiler (tested: gcc 6/7/8, clang 3/5/6)
• cmake (at least 3.2)
• vsqlite++ (tested: 0.3)
• libxdg-basedir (tested: 1.2)
• qtcore (tested: 5.11/5.5)
• qtwidgets (tested: 5.11/5.5)
• libconfig++ (tested: 1.5)
• Optional
  • Translations: lupdate & lrelease (tested: 5.11/5.5)

Get sourcecode

Download the current release and copy xdgcfg into xdgcfg/.

If you clone from git, be sure to git submodule init and git submodule update afterwards. See the [submodules article in the git book] (https://git-scm.com/book/en/v2/Git-Tools-Submodules#_cloning_submodules) for further info.

Compile

mkdir build
cd build
cmake ..
make
make install

cmake options:

• -DCMAKE_BUILD_TYPE=Debug for a debug build
• -DWITHOUT_TRANSLATIONS=YES to not compile translations
• One of:
  • -DWITH_DEB=YES if you want to be able to generate a deb-package
  • -DWITH_RPM=YES if you want to be able to generate an rpm-package

Contributing

Contributions are always welcome. You can submit them as pull requests or via email to tastytea@tastytea.de.

Translations

To start a new translation, go to translations/ and copy whyblocked_en.ts to a file appropriate for the new language. If you want to translate to french for example, that file name would be whyblocked_fr.ts.

Use Linguist to edit the .ts-files.

Bugs

Please report them on the issue tracker or to tastytea@tastytea.de.

Licence & Copyright

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.

The icon is derived from the icons messagebox critical and help of the Gartoon icon theme. The original authors were Zeus, Patrick Yavitz and La Mula Francis, who released them under the terms of the GPL2+ and DSL. The new icon is released under the same terms.