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, in‐
22 cluded 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 re‐
38 lated (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 --display=DISPLAY
45 X display to use
46 --sync Make X calls synchronous
48 --g-fatal-warnings Make all warnings fatal
50 IceCat options
52 -h or --help
54 Print this message.
55 -v or --version
57 Print IceCat version.
58 --full-version
60 Print IceCat version, build and platform build ids.
61 -P <profile>
63 Start with <profile>.
64 --profile <path>
66 Start with profile at <path>.
67 --migration
69 Start with migration wizard.
70 --ProfileManager
72 Start with ProfileManager.
73 --no-remote
75 Do not accept or send remote commands; implies --new-instance.
76 --new-instance
78 Open new instance, not a new window in running instance.
79 --safe-mode
81 Disables extensions and themes for this session.
82 --MOZ_LOG=<modules> Treated as MOZ_LOG=<modules> environment variable,
84 overrides it.
85 --MOZ_LOG_FILE=<file> Treated as MOZ_LOG_FILE=<file> environment vari‐
87 able,
88 overrides it. If MOZ_LOG_FILE is not specified as an argument or
89 as an environment variable, logging will be written to stdout.
90 --headless
92 Run without a GUI.
93 --browser
95 Open a browser window.
96 --new-window <url> Open <url> in a new window.
98 --new-tab <url>
100 Open <url> in a new tab.
101 --private-window <url> Open <url> in a new private window.
103 --preferences
105 Open Preferences dialog.
106 --screenshot [<path>] Save screenshot to <path> or in working direc‐
108 tory.
109 --window-size width[,height] Width and optionally height of screenshot.
111 --search <term>
113 Search <term> with your default search engine.
114 --setDefaultBrowser Set this app as the default browser.
116 --first-startup
118 Run post-install actions before opening a new window.
119 --kiosk Start the browser in kiosk mode.
121 --jsconsole
123 Open the Browser Console.
124 --jsdebugger [<path>] Open the Browser Toolbox. Defaults to the local
126 build
127 but can be overridden by a icecat path.
128 --wait-for-jsdebugger Spin event loop until JS debugger connects.
130 Enables debugging (some) application startup code paths. Only
131 has an effect when `--jsdebugger` is also supplied.
132 --devtools
134 Open DevTools on initial load.
135 --start-debugger-server [ws:][ <port> | <path> ] Start the devtools
137 server on
138 a TCP port or Unix domain socket path. Defaults to TCP port
139 6000. Use WebSocket protocol if ws: prefix is specified.
140 --recording <file> Record drawing for a given URL.
142 --recording-output <file> Specify destination file for a drawing
144 recording.
145 --remote-debugging-port [<port>] Start the IceCat remote agent,
147 which is a low-level debugging interface based on the CDP proto‐
148 col.
149
152 /usr/bin/icecat - shell script wrapping icecat
153 /usr/lib(64)/icecat/icecat-bin - icecat executable
154
157 9x.x
158
161 To report a bug, please mail to help-gnuzilla@gnu.org
162
165 For a full list of the people who are credited with making a contribu‐
166 tion to Mozilla. See https://www.mozilla.org/credits/
167 The Free Software Foundation (FSF) is a nonprofit with a worldwide mis‐
169 sion to promote computer user freedom. We defend the rights of all
170 software users. See https://www.gnu.org/gnu/
171Fedora June 2022 ICECAT(1)