2022-01-10 19:36:31 +01:00
|
|
|
.TH bisc 1 "January 11, 2022" "bisc 0.4.1" "User Commands"
|
2021-09-07 13:56:43 +02:00
|
|
|
|
|
|
|
|
.SH NAME
|
|
|
|
|
bisc - a small tool that clears cookies (and more)
|
|
|
|
|
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B bisc
|
|
|
|
|
.RI [ option ]
|
|
|
|
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.PP
|
|
|
|
|
Websites can store unwanted data using all sorts of methods: besides the usual
|
|
|
|
|
cookies, there are also the local and session storage, the IndexedDB API and
|
|
|
|
|
more caches as well.
|
|
|
|
|
.PP
|
|
|
|
|
Bisc will try to go through each of them and remove all information from
|
|
|
|
|
websites that are not explicitly allowed (ie. a whitelist of domains).
|
|
|
|
|
It was created for qutebrowser, but it actually supports the storage format
|
|
|
|
|
used by Chromium-based browsers, which (sadly) means almost every one nowadays.
|
|
|
|
|
|
|
|
|
|
.SH USAGE
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
Create an empty whitelist file (see the FILES section) and write the domains of
|
|
|
|
|
the allowed cookies, one per line. For example:
|
|
|
|
|
.IP
|
|
|
|
|
.nf
|
|
|
|
|
\fC
|
|
|
|
|
\&.example.com
|
|
|
|
|
example.com
|
|
|
|
|
\fR
|
|
|
|
|
.fi
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
Run \fCbisc --dry-run\fR to see what would be deleted without actually
|
|
|
|
|
doing it.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
Run \fCbisc\fR to delete all non-whitelisted data from qutebrowser.
|
|
|
|
|
|
|
|
|
|
.SH OPTIONS
|
|
|
|
|
.TP
|
|
|
|
|
.BR -c ","\ --config\ FILE
|
|
|
|
|
Use FILE as the configuration file.
|
|
|
|
|
.TP
|
|
|
|
|
.BR -n ","\ --dry-run
|
|
|
|
|
Don't actually remove anything, just show what would be done.
|
|
|
|
|
.TP
|
2022-01-02 01:31:35 +01:00
|
|
|
.BR -u ","\ --unsafe
|
|
|
|
|
Ignore database locks.
|
|
|
|
|
This will probably corrupt the databases, but works while the browser is
|
|
|
|
|
running.
|
|
|
|
|
.TP
|
2021-09-07 13:56:43 +02:00
|
|
|
.BR -h ","\ --help
|
|
|
|
|
Show the program information and help screen.
|
|
|
|
|
|
|
|
|
|
.SH FILES
|
|
|
|
|
.TP
|
|
|
|
|
.I $XDG_CONFIG_HOME/bisc/bisc.conf
|
|
|
|
|
Bisc configuration
|
|
|
|
|
.TP
|
|
|
|
|
.I $XDG_CONFIG_HOME/qutebrowser/whitelists/cookies
|
|
|
|
|
Domain whitelist
|
|
|
|
|
.TP
|
|
|
|
|
.I $XDG_DATA_HOME/qutebrowser/webengine
|
|
|
|
|
Chromium/QtWebEngine state directory
|
|
|
|
|
.PP
|
|
|
|
|
Note: when the variable $XDG_CONFIG_HOME or $XDG_DATA_HOME is not set,
|
|
|
|
|
$HOME/.config and $HOME/.local/share respectively, will be used instead.
|
|
|
|
|
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
|
\fBbisc.conf\fR(5) for the bisc configuration file
|
|
|
|
|
|
|
|
|
|
.SH AUTHORS
|
2022-01-10 19:57:53 +01:00
|
|
|
Copyright © 2022 Michele Guerini Rocco.
|
2021-09-07 13:56:43 +02:00
|
|
|
.TP 0
|
|
|
|
|
Released under the GPL, version 3 or greater.
|
|
|
|
|
This software carries no warranty of any kind.
|
