.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.4.
.TH ICECAT "18" "March 2017" "IceCat 52.0.1" "User Commands"
.SH NAME
IceCat \- GNU version of Firefox browser
.SH SYNOPSIS
.B icecat
[ \fI\,options \/\fR... ] [\fI\,URL\/\fR]
.SH DESCRIPTION
GNUzilla is the GNU version of the Mozilla suite, and GNU IceCat is the GNU version of the Firefox browser. Its main advantage is an ethical one: it is entirely free software. While the Firefox source code from the Mozilla project is free software, they distribute and recommend non-free software as plug-ins and addons.

In addition, GNU IceCat includes some privacy protection features, included in a separate addon:

Some sites refer to zero-size images on other hosts to keep track of cookies. When IceCat detects this mechanism it blocks cookies from the site hosting the zero-length image file. (It is possible to re-enable such a site by removing it from the blocked hosts list.)
Other sites rewrite the host name in links redirecting the user to another site, mainly to "spy" on clicks. When this behavior is detected, IceCat shows a message alerting the user.


Origin of the name

The name IceCat was coined to show our relationship to the Mozilla Firefox browser. Ice isn't Fire and a Cat isn't a Fox, so it is clearly a different package (we don't want Mozilla blamed for our mistakes, nor cause confusion with their trademarks), but is equally clearly intimately related (of course nearly all of the work comes from the Mozilla foundation effort, so we want to give credit).

The gNewSense BurningDog browser and the Debian IceWeasel browser are similarly derived from Firefox, also with the intent of being free software. Technically, however, these projects are maintained entirely independently of IceCat. (Previously, this GNU browser project was also named IceWeasel, but that proved confusing.)

Extensions included to this version of IceCat:

- LibreJS
  GNU LibreJS aims to address the JavaScript problem described in Richard
  Stallman's article The JavaScript Trap.

- SpyBlock
  Blocks privacy trackers while in normal browsing mode, and all third party
  requests when in private browsing mode. Based on Adblock Plus.

- AboutIceCat
  Adds a custom "about:icecat" homepage with links to information about the
  free software and privacy features in IceCat, and check-boxes to enable
  and disable the ones more prone to break websites.

- HTML5-video-everywhere
  Uses the native video player to play embedded videos from different sources

- Fingerprinting countermeasures: Fingerprinting is a series of techniques
  allowing to uniquely identify a browser based on specific characterisics of
  that particular instance (like what fonts are available in that machine).
  Unlike cookies the user cannot opt-out of being tracked this way,
  so the browser has to avoid giving away that kind of hints.

`icecat' generates a man page out of `--help' and `--version' output.
.IP
where options include:
.PP
X11 options
.TP
\fB\-\-display\fR=\fI\,DISPLAY\/\fR
X display to use
.TP
\fB\-\-sync\fR
Make X calls synchronous
.HP
\fB\-\-g\-fatal\-warnings\fR Make all warnings fatal
.PP
IceCat options
.TP
\fB\-h\fR or \fB\-\-help\fR
Print this message.
.TP
\fB\-v\fR or \fB\-\-version\fR
Print IceCat version.
.TP
\fB\-P\fR <profile>
Start with <profile>.
.TP
\fB\-\-profile\fR <path>
Start with profile at <path>.
.TP
\fB\-\-migration\fR
Start with migration wizard.
.TP
\fB\-\-ProfileManager\fR
Start with ProfileManager.
.TP
\fB\-\-no\-remote\fR
Do not accept or send remote commands; implies \fB\-\-new\-instance\fR.
.TP
\fB\-\-new\-instance\fR
Open new instance, not a new window in running instance.
.HP
\fB\-\-UILocale\fR <locale> Start with <locale> resources as UI Locale.
.TP
\fB\-\-safe\-mode\fR
Disables extensions and themes for this session.
.TP
\fB\-\-jsconsole\fR
Open the Browser Console.
.TP
\fB\-\-jsdebugger\fR
Open the Browser Toolbox.
.TP
\fB\-\-devtools\fR
Open DevTools on initial load.
.TP
\fB\-\-start\-debugger\-server\fR [port|path] Start the debugger server on a TCP port or Unix domain socket path.
Defaults to TCP port 6000.
.TP
\fB\-\-browser\fR
Open a browser window.
.HP
\fB\-\-new\-window\fR <url> Open <url> in a new window.
.TP
\fB\-\-new\-tab\fR <url>
Open <url> in a new tab.
.HP
\fB\-\-private\-window\fR <url> Open <url> in a new private window.
.TP
\fB\-\-preferences\fR
Open Preferences dialog.
.TP
\fB\-\-search\fR <term>
Search <term> with your default search engine.
.HP
\fB\-\-recording\fR <file> Record drawing for a given URL.
.HP
\fB\-\-recording\-output\fR <file> Specify destination file for a drawing recording.
.HP
\fB\-\-setDefaultBrowser\fR Set this app as the default browser.
.PP
Gnuzilla IceCat 52.0.1
.SH FILES

/usr/bin/icecat - icecat executable

/usr/lib(64)/icecat-52.0.1/icecat-bin - icecat executable
.SH BUGS
To report a bug, please mail to bug-gnuzilla@gnu.org
.SH VERSION
52.0.1
.SH AUTHORS
For a full list of the people who are credited with making a contribution to Mozilla, see http://www.mozilla.org/credits/ .
.SH "SEE ALSO"
https://www.gnu.org/software/gnuzilla/