Skip to content
Tweak the web.
Ruby JavaScript
Pull request Compare This branch is 24 commits behind stewart:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


dotcss is a Google Chrome extension that imports .css files in ~/.css based on their filename.

If you go to, dotcss will load ~/.css/

This makes it super simple to change and improve the look of your favourite pages.

how it works

Chrome extensions can't access the local filesystem, so dotcss runs a tiny web server on port 1243 that serves files out of the ~/.css folder


  • OS X or Linux
  • Ruby 1.8 or newer
  • rake (gem install rake)
  • Google Chrome
  • /usr/local/bin in your $PATH
  • on Linux: exo-open (Can be found in exo-utils on Ubuntu. Required until Bug #378783 in xdg-utils is fixed.)


git clone
cd dotcss
rake install

chromium vs. google chrome vs. chrome canary

Multiple versions of Chrome installed? Drag builds/dotcss.crx to whichever is your favourite.

quick notes on css

If your CSS isn't working, it means one of three things:

  1. Your selectors are off - by this, I mean either you're trying to style the wrong element, or your selector isn't specific enough to override the existing CSS
  2. Inline styles are preventing you from styling the element
  3. dotcss fucked up

The first two are more likely than the third, but if you run into something weird, please file an issue and I'll try to help you.


rake uninstall


  • Chris Wanstrath for dotjs, which 90% of this is based on.
Something went wrong with that request. Please try again.