Modified by jmatsu

If u’ll request to ‘’, this dotjs will read ‘~/.js/’

※ If u’ll use this, u must install the extension of Chrome from ext/*. (Not from Chrome store) ………………… 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.

On subdomains such as dotjs will try to load ~/.js/ as well as ~/.js/ and ~/.js/com.js.

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

Double bonus: ~/.js/default.js is loaded on every request, meaning you can stick plugins or helper functions in it.

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
        .attr('src', '//')
        .css({'width': 'auto', 'height': '22px'})

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

Now open https://localhost:3131 in Chrome and follow these steps:

  • Click the “X” Padlock icon in the address bar
  • Click “Certificate Information”
  • Drag the large cert icon to your desktop
  • Open it with Keychain
  • Configure its Trust section as shown:

Finally install the Google Chrome extension:

Uninstall it

rake uninstall


“I almost wish you could just stick JavaScript in ~/.js. Do you know what I’m saying?”



Other Browsers

Related Repositories



~/.js — No longer maintained, sorry. ...



An Ubuntu Friendly Version of the popular dotjs ...



holman's dotjs scripts ...



My dotjs scripts ...



~/.js using node. (No longer maintained.) ...

Top Contributors

defunkt arvindsv tmuellerleile stroborobo theshortcut jmatsu adamvduke surma cobracmder danp byroot jc00ke hujinpu capitalist johan jdan josh jaw6 schacon smgt eFrane To1ne fukayatsu


-   2.0 zip tar
-   1.9.1 zip tar
-   1.9 zip tar
-   1.6 zip tar
-   1.5 zip tar
-   1.4 zip tar
-   1.3 zip tar
-   1.2 zip tar
-   1.1 zip tar