bisc/README.md

67 lines
1.9 KiB
Markdown
Raw Normal View History

2018-09-21 21:34:31 +02:00
# Bisc
2020-09-23 18:56:00 +02:00
2018-09-21 21:34:31 +02:00
### A small tool that clears qutebrowser cookies
2020-09-23 18:56:00 +02:00
## Installation
bisc is Haskell program available on [Hackage][hackage] and can
be installed with one of the Haskell package managers. For
example, with [cabal-install][cabal] you would do
```
cabal install bisc
```
and similarly for [stack][stack].
Alternatively, if you are using Nix or NixOS, bisc is available
under the attribute `haskellPackages.bisc`. It should also be in
the Nix binary cache so you don't have to build from source.
Finally, a statically compiled binaries can be found in the
[releases](/git/rnhmjoj/bisc/releases).
[hackage]: http://hackage.haskell.org/package/bisc
[cabal]: https://github.com/haskell/cabal/blob/master/cabal-install/README.md
[stack]: https://docs.haskellstack.org/en/stable/README/
2019-03-25 00:15:26 +01:00
## Configuration
The bisc configuration file is `$XDG_CONFIG_HOME/bisc/bisc.conf`.
It allows to change the paths of the QtWebEngine/Chromium
directory and the whitelist file.
The default settings are:
```
whitelist-path = $(XDG_CONFIG_HOME)/qutebrowser/whitelists/cookies
webengine-path = $(XDG_DATA_HOME)/qutebrowser/webengine
```
2018-09-21 21:34:31 +02:00
## Usage
2019-03-25 00:15:26 +01:00
Create an empty whitelist file and write the domains of the
allowed cookies, one per line.
2018-09-21 21:34:31 +02:00
Eg.
```
.example.com
example.com
```
2019-03-25 00:15:26 +01:00
Run `bisc` to delete all non-whitelisted data from qutebrowser.
2018-09-21 21:34:31 +02:00
## License
2020-09-23 18:56:00 +02:00
Copyright (C) 2020 Michele Guerini Rocco
2018-09-21 21:34:31 +02:00
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.