Account confirmers, Anti-spam team, Bureaucrats, canmove, Confirmed users, Module owners and peers, smwadministrator, smwcurator, Administrators, MozillaWiki team, Widget editors
8,250
edits
Firefox/CommandLineOptions: Difference between revisions
m
→-new-instance: Remove "'''Note:''' Not available for Windows; see [https://bugzilla.mozilla.org/show_bug.cgi?id=855899 bug 855899]" as quoted bug was closed as "FIXED" March 2019
Dannycolin (talk | contribs) (Add browser specific command line optins) |
m (→-new-instance: Remove "'''Note:''' Not available for Windows; see [https://bugzilla.mozilla.org/show_bug.cgi?id=855899 bug 855899]" as quoted bug was closed as "FIXED" March 2019) |
||
| (5 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
[Work in progress] | [Work in progress] | ||
= Command line options = | |||
Command line options are used to specify various startup options for Mozilla applications. For example, if you have multiple profiles you can use command line configuration options to bypass the Profile Manager and open a specific profile. You can also control how Mozilla applications open, which components open initially, and what the components do when they open. This page describes the commonly used options and how to use them. You can open the command line interface by pressing Shift+F2. | |||
== Syntax rules == | |||
But first, let's describe the syntax rules that apply for all options. | |||
* Command parameters containing spaces must be enclosed in quotes, such as "Joel User". | |||
* Command actions are case insensitive. | |||
* Command parameters, except profile names, are case insensitive. | |||
* Blank spaces ( ) separate commands and parameters. | |||
== Using command line options == | |||
Command line options follow the command to start the application. If the option contains arguments, enter the argument after the option. Some options have abbreviations, for example, -editor can be abbreviated as -edit (available abbreviations are described in the text below). In some cases, option arguments must be enclosed in quotation marks (this is noted in the option descriptions below). Multiple command line options can be specified. In general, the syntax is as follows: | |||
application -option -option "argument" -option argument | |||
=== Examples === | |||
The following examples show the use of the -ProfileManager command, which will open the profile manager prior to starting Firefox: | |||
==== Windows ==== | |||
Select '''Run''' from Windows start menu. Enter the following command: | |||
firefox -ProfileManager | |||
==== macOS ==== | |||
Go to '''Applications ▶︎ Utilities'''. Open terminal and enter the following command: | |||
cd /Applications/Firefox.app/Contents/MacOS | |||
./firefox -ProfileManager | |||
If you use Firefox Nightly, you can enter: | |||
cd /Applications/FirefoxNightly.app/Contents/MacOS | |||
./firefox -ProfileManager | |||
==== Linux ==== | |||
Open a terminal and enter the following command: | |||
cd Firefox installation directory | |||
./firefox -ProfileManager | |||
== User profile == | == User profile == | ||
| Line 32: | Line 79: | ||
<pre>firefox -new-instance -P "Another Profile"</pre> | <pre>firefox -new-instance -P "Another Profile"</pre> | ||
=== -no-remote === | === -no-remote === | ||
| Line 79: | Line 124: | ||
Make this instance the active application. | Make this instance the active application. | ||
=== -wait-for-browser === | |||
Make the launcher process (Windows only) stay alive until the browser shuts down. | |||
=== -headless === | === -headless === | ||
| Line 113: | Line 162: | ||
Open URL in a new private browsing window. If a private browsing window is already open, a new tab is opened in the existing window. '''Firefox 29''' and later only. Does not work in '''Firefox 31''' on linux mint 17 nor on '''Firefox 48''' on Windows 7. URL opens in a non-private window. | Open URL in a new private browsing window. If a private browsing window is already open, a new tab is opened in the existing window. '''Firefox 29''' and later only. Does not work in '''Firefox 31''' on linux mint 17 nor on '''Firefox 48''' on Windows 7. URL opens in a non-private window. | ||
=== -safe-mode === | |||
If the application is not already running, present the troubleshoot mode dialogue for the default profile. | |||
Alternatively, present the dialogue for a specified non-running profile. For example: | |||
<pre>firefox -safe-mode -P JoelUser</pre> | |||
Troubleshoot mode was formerly known as safe mode. | |||
=== -search term === | === -search term === | ||
| Line 127: | Line 186: | ||
'''Note:''' When opening multiple URLs, Firefox always opens them as tabs in a new window. | '''Note:''' When opening multiple URLs, Firefox always opens them as tabs in a new window. | ||
== Other components == | |||
=== -devtools === | |||
Start with native [https://developer.mozilla.org/en-US/docs/Tools developer tools] opened. | |||
=== -inspector URL === | |||
Start with the [https://developer.mozilla.org/en-US/docs/DOM_Inspector DOM Inspector], if installed, and inspect the given URL (where URL is optional). | |||
=== -jsdebugger === | |||
Start application with [https://developer.mozilla.org/en-US/docs/Tools/Browser_Toolbox browser toolbox]. That is different to Venkman debugger (see option -venkman). | |||
=== -jsconsole === | |||
Start Firefox with the [https://developer.mozilla.org/en-US/docs/Tools/Browser_Console browser console]. | |||
=== -purgecaches === | |||
Gecko (layout engine) has a JavaScript cache, which is not reset on startup, this clears it. | |||
=== -start-debugger-server PORT === | |||
Start the debugger server on port. This will enable another instance of Firefox to connect the Firefox developer tools to this Firefox instance. See the article on [https://developer.mozilla.org/en-US/docs/Tools/Remote_Debugging/Debugging_Firefox_Desktop remotely debugging Firefox desktop]. | |||
=== -venkman === | |||
Start with the JavaScript debugger, [https://developer.mozilla.org/en-US/docs/Venkman Venkman], if installed. | |||
The port argument is optional, and if it is omitted, the server will listen on port 6000. | |||
== Linux-specific options == | |||
Firefox is a GTK app, and as such supports the GTK flags documented [https://docs.gtk.org/gtk3/running.html here]. | |||
== Further options == | |||
Additional arguments may be found with this searchfox search: https://searchfox.org/mozilla-central/search?q=CheckArg%28&path=&case=false®exp=false | |||