User.js file: Difference between revisions

From MozillaZine Knowledge Base
Jump to navigationJump to search
m (add a link for about:config)
(added TB info, how to delete user.js prefs, links for profile folder and texturizer; rearragned paragraphs to improve (?) flow)
Line 1: Line 1:
: ''This article is also to serve as a dual reference for the Firefox counterpart of user.js and prefs.js''
: ''This article also serves as a reference for the Firefox counterparts of user.js and prefs.js. It also applies to Thunderbird, except where noted.''
'''user.js''' is a file that contains preferences that will be loaded into the Mozilla Application Suite every time the suite is started up.  Each time Mozilla is started up, the valid preferences from user.js are copied into prefs.js, which Mozilla uses to store all the preferences for the current user.
'''user.js''' is a file that contains preferences that will be loaded into the Mozilla Application Suite every time the suite is started up.  Each time Mozilla is started up, the valid preferences from user.js are copied into prefs.js, which Mozilla uses to store all the preferences for the current user.


Similar to the user.js file, entering [[about:config]] in the URL bar will edit the preferences for the current Mozilla user profileChanges made in this manner will directly modify the prefs.js file.
The user.js file is located in your [[Profile Folder | profile directory]], the same directory as prefs.js, but it is '''not''' created by Mozilla. So if the file doesn't exist, simply create a new text file with any text editor, such as notepad, emacs, or vi, and save it with the name "user.js"Make sure you save the file in the same directory as prefs.js.


Mozilla will '''never''' modify the contents of user.js.  However, the contents of prefs.js is frequently modified by Mozilla.  If you wish do modify prefs.js directly, you should take care to shut down Mozilla completely before you open the file.  Otherwise your edits may be overwritten.
Mozilla will '''never''' modify the contents of user.js.  However, the contents of prefs.js is frequently modified by Mozilla.  If you wish do modify prefs.js directly, you should take care to shut down Mozilla completely before you open the file.  Otherwise your edits may be overwritten.


The user.js file is located in the same directory as prefs.js.  user.js is never created by Mozilla, so if the file doesn't exist, don't worry!  Simply create the text file with any text editor, such as notepad, emacs, or viMake sure you save the file in the same directory as prefs.js.
Similar to the user.js file, entering [[about:config]] in the URL bar will allow you to edit the preferences for the current Mozilla user profileChanges made in this manner will directly modify the prefs.js file. (''Does not apply to Thunderbird.'')


Valid preferences are via the user_pref command, as demonstrated below.
To undo preferences that you set using the user.js file, you cannot simply delete the preferences that you inserted previously into user.js, as these will remain written in prefs.js. You should instead delete the preferences from prefs.js by editing that file with a text editor or via about:config.
 
Valid preferences are via the user_pref command, as demonstrated below.  


'''//''' denotes a comment.  Anything after these two characters on a line are ignored.
'''//''' denotes a comment.  Anything after these two characters on a line are ignored.


Following are a number of preferences and what they do.  For lack of a better way of ordering them, they are alphabetical via preference name.  These can be copied "as-is" into your user.js file.
Following are a number of preferences and what they do.  For lack of a better way of ordering them, they are alphabetical via preference name.  These can be copied "as-is" into your user.js file. (''These browser-specific examples do not apply to Thunderbird.'')


  // Type-Ahead-Find allows the user to search for text or links on a site by just
  // Type-Ahead-Find allows the user to search for text or links on a site by just
Line 23: Line 25:
  // Default: true
  // Default: true
  user_pref("accessibility.typeaheadfind", true);
  user_pref("accessibility.typeaheadfind", true);


  // Allow type-ahead-find to work on text as well as links by default
  // Allow type-ahead-find to work on text as well as links by default
Line 98: Line 101:
* [http://www.geocities.com/pratiksolanki/ Hidden Mozilla Prefs]
* [http://www.geocities.com/pratiksolanki/ Hidden Mozilla Prefs]
* [http://texturizer.net/firefox/tips.html Firefox Help: Tips and Tricks]- Most should also apply to Mozilla
* [http://texturizer.net/firefox/tips.html Firefox Help: Tips and Tricks]- Most should also apply to Mozilla
* [http://texturizer.net/thunderbird/tips.html Thunderbird Help: Tips and Tricks] has a number of tweaks you can make by modifying user.js in your Thunderbird profile.

Revision as of 07:38, 5 October 2004

This article also serves as a reference for the Firefox counterparts of user.js and prefs.js. It also applies to Thunderbird, except where noted.

user.js is a file that contains preferences that will be loaded into the Mozilla Application Suite every time the suite is started up. Each time Mozilla is started up, the valid preferences from user.js are copied into prefs.js, which Mozilla uses to store all the preferences for the current user.

The user.js file is located in your profile directory, the same directory as prefs.js, but it is not created by Mozilla. So if the file doesn't exist, simply create a new text file with any text editor, such as notepad, emacs, or vi, and save it with the name "user.js". Make sure you save the file in the same directory as prefs.js.

Mozilla will never modify the contents of user.js. However, the contents of prefs.js is frequently modified by Mozilla. If you wish do modify prefs.js directly, you should take care to shut down Mozilla completely before you open the file. Otherwise your edits may be overwritten.

Similar to the user.js file, entering about:config in the URL bar will allow you to edit the preferences for the current Mozilla user profile. Changes made in this manner will directly modify the prefs.js file. (Does not apply to Thunderbird.)

To undo preferences that you set using the user.js file, you cannot simply delete the preferences that you inserted previously into user.js, as these will remain written in prefs.js. You should instead delete the preferences from prefs.js by editing that file with a text editor or via about:config.

Valid preferences are via the user_pref command, as demonstrated below.

// denotes a comment. Anything after these two characters on a line are ignored.

Following are a number of preferences and what they do. For lack of a better way of ordering them, they are alphabetical via preference name. These can be copied "as-is" into your user.js file. (These browser-specific examples do not apply to Thunderbird.)

// Type-Ahead-Find allows the user to search for text or links on a site by just
// typing the search term.
// Find next instance of the search term is <F3>.
// Find previous instance of the search term is <Shift-F3>.
// Turn on Type-Ahead-Find
// Default: true
user_pref("accessibility.typeaheadfind", true);


// Allow type-ahead-find to work on text as well as links by default
// Default: true (Type-Ahead-Find will only work on links)
user_pref("accessibility.typeaheadfind.linksonly", false);
// Block new windows from opening up.
// Default: false (Allow popups)
user_pref("browser.block.target_new_window", true);
// IE Favorites (bookmarks) are imported the first time Mozilla is run.
// This preference is to determine whether they are shown in the bookmarks menu
// Default: true (Show IE Favorites under bookmarks)
user_pref("browser.bookmarks.import_system_favorites", false);
// Site icons are icons that show up in the URL bar when visiting a site. 
// Favicons are a broken implementation of site icons used by Internet Explorer. 
// Web pages are supposed to tell us if they have a site icon.   
// Since IE looks for favicons on *all* sites, this causes unnecessary page hits.
// Mozilla can do the same by setting the following preference.
// Default: false (Don't look for favicons unless they're 
// explicitly specified in the web page.)
user_pref("browser.chrome.favicons", true);
// Look for site icons if site specifies them
// Default: true (Load site icons if they are specified in the web page)
user_pref("browser.chrome.site_icons", true);
// 0 - No
// 1 - Show icons only if they're cached
// 2 - Always show icons
// Default: 0
user_pref("browser.chrome.load_toolbar_icons", 2);
// Allow images that are too big to be resized.
// Image resizing is used if a image is viewed that's too large to fit in the browser
// window.
// Default: false
user_pref("browser.enable_automatic_image_resizing", true);
// When opening a link in a new tab, the default behavior is to 
// put focus on the new tab.
// Default: false (Focus always goes to the newly created tab)
user_pref("browser.tabs.loadInBackground", true);
// Open a link in a new tab if you 'middle click' on the link. Clicking down on a
//    mouse wheel is concidered a middle click.
// Default: false (Middle click will open the link in a new browser window)
user_pref("browser.tabs.opentabfor.middleclick", true);
// If multiple tabs are open and you close the window, the default behaviour is
// to warn you that there are open tabs.
// Default: true (Warn if closing the browser window will close multiple tabs)
user_pref("browser.tabs.warnOnClose", false);
// The browser window has a throbber. By default, all throbbers will take the
//    browser window to www.mozilla.org, but this is easy to change.
// Default: "http://www.mozilla.org/"
user_pref("browser.throbber.url", "http://www.yahoo.com/");


// Automatically complete text typed into location bar.
// Default: true (Browser will try to autocomplete what the user types into the
// location bar)
user_pref("browser.urlbar.autocomplete.enabled", true);
// Show a dropdown list of possible matches for what the user has typed in.
// Default: true
user_pref("browser.urlbar.showPopup", true);
// Enable smooth scroll on PgUP/PgDn, similar to IE.
// Default: false
user_pref("general.smoothScroll", true);

External Links