Search

Skip to Projects

userChromeJS allows complete chrome customization when an extension is excessive.

userChromeJS is derived from the original userChrome.js by zeniko. An import function has been added to enable greater flexibility in absolute/relative file management, along with some overlay tweaks. Thanks to zeniko for the original idea; the bug to implement this functionality in core Mozilla is Bug 332529.

Installation:

userChromeJS v2.0 (Gecko 14+, Fx14+ and Tb14+ and Sm2.11+)

userChromeJS v1.7 (Gecko 2.0, Fx4.0+ and Tb3.3+ and Sm2.1+)

Requirements:

Platform: All OSs.
Applications: Gecko 14 and higher.
Firefox: signed userChromeJS v2.0 required for Fx40 and higher.

Features:

• Complete chrome customization is possible by running custom javascript code or overlaying chrome with .xul overlays.
• An extension is not required for small code snippet tweaks or even larger UI modifications.
• An import function lets script and overlay files be organized and shared among profiles and even made portable.
• As of v2.0, xul overlay files are managed to ensure an overlay load is finished before the next one is initiated. Bug 330458 will never be fixed.

Compatibility:

• No known problems.

Known Issues:

• No known issues.

Localization:

There are only a few console error message strings; localizations welcome.

Support and Questions:

Please read the FAQ before posting to the userChromeJS Mozillazine thread. A collection of useful code snippets may be found here.

Version history:

• 2.0

  - Update: create a signed xpi for Firefox addon policy compatibility.
  - Fix: errors due to Components shortcuts; remove Cc, Ci, Cu, Cr.
  - Fix: update is broken on version changes, v2.0 needs to be downloaded from http://userchromejs.mozdev.org/ for future auto updates.
  - New: implement observer for xul overlays to ensure serial loads.
  - NOTE: remove any previous userChromeJS version before installing v2.0.

• 1.7

  - Fix: strict js warning for assigning Components shortcuts.
  

• 1.6

  - Fix: minor code cleanup.
  

• 1.5

  - Fix: scope fix for charSet.
  - Fix: add updateURL in install.rdf.
  - Fix: add unpack=true in install.rdf so that a seed userChrome.js may be created from the template.

• 1.4

  - New: default charSet is now UTF-8.
  - New: allow user settable charSet for files loaded using the import or importFolder functions. See the README.txt in the FAQ.
  - New: add SeaMonkey 2.1 support.

• 1.3

  - Fix: change manifest xpcom registration to support Thunderbird.
  

• 1.2

  - Update: compatibility with Gecko 2.0 (Fx4) xpcom registration changes.
  

• 1.1

  - Fix: handle shortcut constants, when sometimes defined sometimes not.
  - Doc: see the README.txt in the FAQ for info on userChromeJS console logging features.

• 1.0

  - New: initial release.
  

Downloads: