Pull request Compare This branch is 6 commits ahead, 88 commits behind defunkt:master.
Latest commit 8d69ec8 Feb 21, 2011 @jeromeetienne working greasemonkey support
	modified:   bin/djsd-node
	modified:   bin/node-greasemonkey.js
Failed to load latest commit information.
bin working greasemonkey support Feb 21, 2011
builds remix Feb 17, 2011
ext remix Feb 17, 2011
HACKING hax Feb 18, 2011
LICENSE first draft Feb 7, 2011
README.markdown requires os x Feb 18, 2011
Rakefile remix Feb 17, 2011
com.github.dotjs.plist remix Feb 17, 2011


..................... dotjs ........................

dotjs is a Google Chrome extension that executes JavaScript files in ~/.js based on their filename.

If you navigate to, dotjs will execute ~/.js/

This makes it super easy to spruce up your favorite pages using JavaScript.

Bonus: files in ~/.js have jQuery 1.4.4 loaded, regardless of whether the site you're hacking uses jQuery.

GreaseMonkey user scripts are great, but you need to publish them somewhere and re-publish after making modifications. With dotjs, just add or edit files in ~/.js.


$ cat ~/.js/
// swap github logo with trollface
$('#header .logo img')
  .css('width', '100px')
  .css('margin-top', '-15px')
  .attr('src', '//')

How It Works

Chrome extensions can't access the local filesystem, so dotjs runs a tiny web server on port 3131 that serves files out of ~/.js.

You don't have to worry about starting or stopping this web server because we put a pretty great plist into ~/Library/LaunchAgents that handles all that for us.

The dotjs Chrome extension then makes ajax requests to http://localhost:3131/ any time you hit a page on, for example, and executes the returned JavaScript.


  • OS X
  • Ruby 1.8
  • rake (gem install rake)
  • Google Chrome
  • /usr/local/bin in your $PATH

Install it

git clone
cd dotjs
rake install

Chromium vs Google Chrome

Multiple Chromes installed? Drag builds/dotjs.crx to whichever is your favorite.

Uninstall it

rake uninstall