Chrome Extension Building Tools
Tools to help compile a Chrome extension from a userscript
view on

Converts a Javascript userscript (.user.js) into a chrome extension (.crx)

Required software


Command line usage is mainly designed as a command line application. It includes a template Windows batch script build.bat which can be easily edited to auto-build a project. Simply edit the EDIT_THIS parts in it.

Arguments are passed into using short (-v) or verbose (--version) flags. Executing --usage will list the available flags, their aliases, and a short description. Reading build.bat also helps.

Library import usage should also be able to be imported as a library and executed in a similar manner to the command line version. This is untested/undocumented, but there's no real reason why it shouldn't work. If this functionality is required, reading through's main should give some insight.

Userscript metadata

Typical userscript files contain a metadata block at the top of the file. To specify additional info for building the .crx file, an additional ==ChromeExtension== metadata block should follow it. For example:

// ==ChromeExtension== // @permission storage // @icon-size 16:bilinear // @icon-size 32:bilinear // @icon-size 128:neighbor // @require additional_javascript.js // @resource resource_filename.html // @update-url // @download-url // ==/ChromeExtension==

The following tags are allowed: