An Ubuntu Friendly Version of the popular dotjs
Ruby JavaScript
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


..................... 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.

SSL certificate

In Google Chrome the server will give an error saying that the Certificate Authority is invalid. You can simply go to: Settings > Show advanced settings > HTTPS/SSL > Manage certificates > Authorities > Import Here you can upload the cert.pem file in this project.


  • 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