1ICECAT(1) User Commands ICECAT(1)
2
6 icecat - IceCat - GNU version of IceCat browser
7
9 icecat [ options ... ] [URL]
10
12 Gnuzilla IceCat is an open-source web browser, designed for standards
13 compliance, performance and portability.
14 GNUzilla is the GNU version of the GNU suite, and GNU IceCat is the GNU
16 version of the IceCat browser. Its main advantage is an ethical one: it
17 is entirely free software. While the IceCat source code from the GNU
18 project is free software, they distribute and recommend non-free soft‐
19 ware as plug-ins and addons.
20 In addition, GNU IceCat includes some privacy protection features,
22 included in a separate addon:
23 Some sites refer to zero-size images on other hosts to keep track of
25 cookies. When IceCat detects this mechanism it blocks cookies from the
26 site hosting the zero-length image file. (It is possible to re-enable
27 such a site by removing it from the blocked hosts list.) Other sites
28 rewrite the host name in links redirecting the user to another site,
29 mainly to "spy" on clicks. When this behavior is detected, IceCat shows
30 a message alerting the user.
31 Origin of the name
33 The name IceCat was coined to show our relationship to the GNU IceCat
35 browser. Ice isn't Fire and a Cat isn't a Fox, so it is clearly a dif‐
36 ferent package (we don't want GNU blamed for our mistakes, nor cause
37 confusion with their trademarks), but is equally clearly intimately
38 related (of course nearly all of the work comes from the GNU foundation
39 effort, so we want to give credit).
40
42 A summary of the options supported by icecat is included below.
43 X11 options
45 --display=DISPLAY
47 X display to use
48 --sync Make X calls synchronous
50 --g-fatal-warnings Make all warnings fatal
52 IceCat options
54 -h or --help
56 Print this message.
57 -v or --version
59 Print IceCat version.
60 -P <profile>
62 Start with <profile>.
63 --profile <path>
65 Start with profile at <path>.
66 --migration
68 Start with migration wizard.
69 --ProfileManager
71 Start with ProfileManager.
72 --no-remote
74 Do not accept or send remote commands; implies --new-instance.
75 --new-instance
77 Open new instance, not a new window in running instance.
78 --UILocale <locale> Start with <locale> resources as UI Locale.
80 --safe-mode
82 Disables extensions and themes for this session.
83 --allow-downgrade
85 Allows downgrading a profile.
86 --MOZ_LOG=<modules> Treated as MOZ_LOG=<modules> environment variable,
88 overrides it.
89 --MOZ_LOG_FILE=<file> Treated as MOZ_LOG_FILE=<file> environment vari‐
91 able,
92 overrides it. If MOZ_LOG_FILE is not specified as an argument or
93 as an environment variable, logging will be written to stdout.
94 --headless
96 Run without a GUI.
97 --save-recordings
99 Save recordings for all content processes to a directory.
100 --browser
102 Open a browser window.
103 --new-window <url> Open <url> in a new window.
105 --new-tab <url>
107 Open <url> in a new tab.
108 --private-window <url> Open <url> in a new private window.
110 --preferences
112 Open Preferences dialog.
113 --screenshot [<path>] Save screenshot to <path> or in working direc‐
115 tory.
116 --window-size width[,height] Width and optionally height of screenshot.
118 --search <term>
120 Search <term> with your default search engine.
121 --setDefaultBrowser Set this app as the default browser.
123 --jsconsole
125 Open the Browser Console.
126 --jsdebugger
128 Open the Browser Toolbox.
129 --wait-for-jsdebugger Spin event loop until JS debugger connects.
131 Enables debugging (some) application startup code paths. Only
132 has an effect when `--jsdebugger` is also supplied.
133 --devtools
135 Open DevTools on initial load.
136 --start-debugger-server [ws:][ <port> | <path> ] Start the debugger
138 server on
139 a TCP port or Unix domain socket path. Defaults to TCP port
140 6000. Use WebSocket protocol if ws: prefix is specified.
141 --recording <file> Record drawing for a given URL.
143 --recording-output <file> Specify destination file for a drawing
145 recording.
146
149 /usr/bin/icecat - shell script wrapping icecat
150 /usr/lib64/icecat/icecat-bin - icecat executable
151
154 78.x
155
158 To report a bug, please mail to help-gnuzilla@gnu.org
159
162 For a full list of the people who are credited with making a contribu‐
163 tion to Mozilla. See https://www.mozilla.org/credits/
164 The Free Software Foundation (FSF) is a nonprofit with a worldwide mis‐
166 sion to promote computer user freedom. We defend the rights of all
167 software users. See https://www.gnu.org/gnu/
168icecat 78.x July 2020 ICECAT(1)