Skip to content


Subversion checkout URL

You can clone with
Download ZIP
An Ubuntu Friendly Version of the popular dotjs
Ruby JavaScript
Branch: master

Merge pull request #6 from kix/patch-1

Removed ~/Library/LaunchAgents mention
latest commit 87cfe152f3
@glenbot authored


..................... dotjs-ubuntu .................

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

This version of dotjs is maintained for users under Ubuntu. The original dotjs for Mac OSX can be found here:

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.

The dotjs executable is installed into ~/bin and then should be added into crontab, so that the server's started when the OS starts.

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.


  • Ubuntu
  • Ruby 1.8
  • rake (gem install rake)
  • Google Chrome
  • /path/to/home/bin in your $PATH


git clone
cd dotjs-ubuntu
rake install

After installation add the following line to your crontab

$ crontab -e
@reboot /path/to/home/bin/djsd -d

For the impatient run the daemon right away

djsd -d

For the patient reboot and enjoy!

Now open https://localhost:3131 in Chrome and enable the SSL.

Then install the Google Chrome extension:


rake uninstall


"I almost wish you could just stick JavaScript in ~/.js. Do you know what I'm saying?"


Other Browsers

Something went wrong with that request. Please try again.