1ICECAT(1) Linux User's Manual ICECAT(1)
2
3
4
6 IceCat - GNU version of Firefox browser
7
8
10 icecat [OPTIONS ...] [URL]
11
12 icecat-bin [OPTIONS] [URL]
13
14
16 Gnuzilla IceCat is an open-source web browser, designed for standards
17 compliance, performance and portability.
18
19 GNUzilla is the GNU version of the Mozilla suite, and GNU IceCat is the
20 GNU version of the Firefox browser. Its main advantage is an ethical
21 one: it is entirely free software. While the Firefox source code from
22 the Mozilla project is free software, they distribute and recommend
23 non-free software as plug-ins and addons.
24
25 In addition, GNU IceCat includes some privacy protection features,
26 included in a separate addon:
27
28 Some sites refer to zero-size images on other hosts to keep track of
29 cookies. When IceCat detects this mechanism it blocks cookies from the
30 site hosting the zero-length image file. (It is possible to re-enable
31 such a site by removing it from the blocked hosts list.) Other sites
32 rewrite the host name in links redirecting the user to another site,
33 mainly to "spy" on clicks. When this behavior is detected, IceCat shows
34 a message alerting the user.
35
36 Origin of the name
37
38 The name IceCat was coined to show our relationship to the Mozilla
39 Firefox browser. Ice isn't Fire and a Cat isn't a Fox, so it is clearly
40 a different package (we don't want Mozilla blamed for our mistakes, nor
41 cause confusion with their trademarks), but is equally clearly inti‐
42 mately related (of course nearly all of the work comes from the Mozilla
43 foundation effort, so we want to give credit).
44
45
47 icecat is a simple shell script that will set up the environment for
48 the actual executable, icecat-bin.
49
50
52 A summary of the options supported by icecat is included below.
53
54
55 X11 options
56 --display=DISPLAY
57 X display to use
58
59 --sync Make X calls synchronous
60
61 --g-fatal-warnings
62 Make all warnings fatal
63
64
65 IceCat options
66 -h, -help
67 Show summary of options.
68
69 -v, -version
70 Print IceCat version.
71
72 -P profile
73 Start with profile.
74
75 --profile path
76 Start with profile at path.
77
78 --migration
79 Start with migration wizard.
80
81 --ProfileManager
82 Start with ProfileManager.
83
84 --no-remote
85 Do not accept or send remote commands; implies --new-instance.
86
87 --new-instance
88 Open new instance, not a new window in running instance.
89
90 --UILocale locale
91 Start with locale resources as UI Locale.
92
93 --save-mode
94 Disables extensions and themes for this session.
95
96 --headless
97 Run without a GUI.
98
99 --marionette
100 Enable remote control server.
101
102 --browser
103 Open a browser window.
104
105 --new-window url
106 Open url in a new window.
107
108 --new-tab url
109 Open url in a new tab.
110
111 --private-window url
112 Open url in a new private window.
113
114 --preferences
115 Open Preferences dialog.
116
117 --screenshot [path]
118 Save screenshot to path or in working directory.
119
120 --window-size width[,height]
121 Width and optionally height of screenshot.
122
123 --search term
124 Search term with your default search engine.
125
126
127
128 --jsconsole
129 Open the Browser Console.
130
131 --jsdebugger
132 Open the Browser Toolbox.
133
134 --wait-for-jsdebugger
135 Spin event loop until JS debugger connects. Enables debugging
136 (some) application startup code paths. Only has an effect when
137 --jsdebugger is also supplied.
138
139 --devtools
140 Open DevTools on initial load.
141
142 --start-debugger-server [ws:][port|path]
143 Start the debugger server on a TCP port or Unix domain socket
144 path. Defaults to TCP port 6000. Use WebSocket protocol if ws:
145 prefix is specified.
146
147 --recording file
148 Record drawing for a given URL.
149
150 --recording-output file
151 Specify destination file for a drawing recording.
152
153 --setDefaultBrowser
154 Set this app as the default browser.
155
156
158 /usr/bin/icecat - shell script wrapping icecat
159 /usr/lib64/icecat/icecat-bin - icecat executable
160
161
163 60.x
164
165
167 To report a bug, please mail to bug-gnuzilla@gnu.org/
168
169
171 For a full list of the people who are credited with making a contribu‐
172 tion to Mozilla, see http://www.mozilla.org/credits/ .
173 http://www.mozilla.org/about.html
174
175 Tobias Girstmair
176 https://www.gnu.org/software/gnuzilla/
177
178
179
180icecat December 12, 2018 ICECAT(1)