Think Greasemonkey for developers.
Witchcraft is a Google Chrome extension for loading custom Javascript and CSS directly from a folder in your file system, injecting them into pages that match their files names.
It works by matching every page domain against script file names available in the scripts folder. For instance, if one navigates to www.google.com, Witchcraft will try to load and run google.com.js and google.com.css.
For more information on how to install and use it, head to Witchcraft's home page.
Node.js is required, but just to run tests. I also use nvm to manage Node.js versions, but that's not required (just make sure your Node.js version is similar to the one .nvmrc currently points to). To install test dependencies:
cd <project-folder>
nvm install
npm install
Then you're ready to run tests:
npm test
You can load the folder directly into Chrome:
-
Go to Chrome’s extension management page:
- Open Chrome and go to
chrome://extensions/. - Enable Developer Mode (a toggle switch in the top right corner).
- Open Chrome and go to
-
Load the unpacked extension:
- Click the Load unpacked button.
- Select the folder that contains your
manifest.jsonfile (or the build folder likechrome-extension/if you used a build process).
-
Test the extension: Once loaded, you should see your extension in the Chrome toolbar or in the extensions list. You can now test and debug it.
If you want to distribute your extension via the Chrome Web Store:
-
Go to the Chrome Developer Dashboard:
-
Package the extension:
- Click the Pack extension button on the
chrome://extensions/page. - Select your extension's folder, and Chrome will generate a
.crxfile (the packaged extension) and a.pemfile (the private key used to sign the extension).
- Click the Pack extension button on the
-
Upload the
.zipfile:- Zip your extension’s files (including the
manifest.json). - Upload it to the Chrome Web Store for review.
- Zip your extension’s files (including the
Loading files from http://127.0.0.1:5743/
v2.7.3
- updated for Chrome v3
Witchcraft is my rendition of defunkt's original extension, dotjs. Although I never got to actually use dotjs (it only worked for MacOS and the installation process was not easy), I really wanted something like that. Thanks, defunkt, for having such a cool idea.
Thanks arimus for the idea of using Web Server for Chrome.
The little witch and the witch hat icons were provided by Freepik.