https://github.com/janl/dotjs

~/.js
https://github.com/janl/dotjs

Last synced: 3 months ago
JSON representation

~/.js

• Host: GitHub
• URL: https://github.com/janl/dotjs
• Owner: janl
• License: mit
• Fork: true (defunkt/dotjs)
• Created: 2012-10-18T08:16:57.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2012-11-08T14:47:11.000Z (about 12 years ago)
• Last Synced: 2024-04-07T01:27:39.409Z (9 months ago)
• Language: Ruby
• Homepage: http://defunkt.io/dotjs/
• Size: 492 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.markdown
  • License: LICENSE

Awesome Lists containing this project

README

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

dotjs  is a  Google Chrome  extension  that executes

JavaScript files in `~/.js` based on their filename.

If  you navigate to  `http://www.google.com/`, dotjs

will execute `~/.js/google.com.js`.

This makes it super  easy to spruce up your favorite

pages using JavaScript.

On subdomains such as `http://gist.github.com` dotjs

will try to load `~/.js/gist.github.com.js`  as well

as `~/.js/github.com.js` and `~/.js/com.js`.

Bonus:  files  in `~/.js`  have jQuery 1.6.2 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`.

## Example

    $ cat ~/.js/github.com.js

    // swap github logo with trollface

    $('#header .site-logo img')

      .css('width', '97px')

      .css('height', '80px')

      .css('margin-top', '-15px')

      .attr('src', '//bit.ly/ghD24e')

![](http://cl.ly/G3UB)

## 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/convore.com.js any time you

hit a page on convore.com, for example, and executes

the returned JavaScript.

## Requires

- OS X

- Ruby 1.8

- rake (gem install rake)

- Google Chrome

- `/usr/local/bin` in your $PATH

## Install it

    git clone http://github.com/defunkt/dotjs

    cd dotjs

    rake install

Then drag builds/dotjs.crx to your favorite

Google Chrome.

## Uninstall it

    rake uninstall

## Credits

- Icon: 

- jQuery: 

- Ryan Tomayko for:

> "I almost wish you could just

   stick JavaScript in ~/.js. Do

   you know what I'm saying?"

## Linux

- [dotjs-ubuntu](https://github.com/glenbot/dotjs-ubuntu)

## Windows

- [dotjs-win](https://github.com/p3lim/dotjs-win)

## Other Browsers

- [Firefox Add-on](https://github.com/rlr/dotjs-addon)

- [Safari Extension](https://github.com/wfarr/dotjs.safariextension)

- [Fluid UserScript](https://github.com/sj26/dotjs-fluid)