Dark Themes for Popular Websites
Switch branches/tags
Nothing to show
Clone or download

README.md

Darkness: Dark Themes for Popular Websites

Darkness Logo

Darkness is a browser extension for Chrome and Firefox that provides dark themes for popular websites such as Google, Facebook, Gmail and YouTube.

Using dark themes reduces the eye strain and fatigue caused by a bright screen, helps you sleep faster and better at night, and generally makes you awesome!

Major contributors (10+ commits): Lior Grossman, Theis Villumsen, Nicolas Botello, Derek Bytheway, Matt Tayler

Submit fixes and improvements to Darkness

Join the Darkness developers community on Facebook

Screenshot

Features

  • Supports over 20 websites: Google, Facebook, YouTube, Gmail, Inbox, Google Docs, Google Photos, Google Keep, Google Calendar and Contacts, Dropbox, Twitter, Reddit, Quora, Facebook Messenger, StackOverflow, GitHub, Trello, CloudFlare, ShareLaTeX and others (help us add more)
  • Select from 5 dark color themes: Iceberg, Tomorrow, Material Design, Dusk, Red Alert (help us add more)
  • Written in JavaScript, uses SASS
  • Self-hosted. Easy to install on Windows, Mac, Linux
  • Also available on Chrome Web Store and Firefox Add-on Store

Installation

Installing Darkness Developer Edition:

  1. Recommended: join our developers community to discuss and ask questions
  2. Fork the Darkness repo: https://github.com/liorgrossman/darkness/fork
  3. Clone your fork locally:
    • If you use SSH: git clone git@github.com:YOUR_GITHUB_USER/darkness.git
    • or using HTTPS: git clone https://github.com/YOUR_GITHUB_USER/darkness.git
  4. Go to the root Darkness directory: cd darkness
  5. Set up a the original repo as a remote:
    • If you use SSH: git remote add upstream git@github.com:liorgrossman/darkness.git
    • or using HTTPS: git remote add upstream https://github.com/liorgrossman/darkness.git
  6. Get the code: git fetch upstream
  7. Install Node.js, unless you already have it installed
  8. Install packages and compile all SCSS files to CSS: npm install (run it from the same directory as package.json)

Loading it in Chrome:

  1. Open Chrome and browse to chrome://extensions
  2. If you already Darkness installed Darkness from Chrome Web Store, disable it
  3. Check Developer mode in the top of the Extensions page
  4. Click Load unpacked extension...
  5. Choose the sub-directory darkness/darkness-chrome (where manifest.json resides)

Loading it in Firefox:

  1. Run gulp ff to transform the darkness-chrome directory to darkness-firefox
  2. Open Firefox and browse to about:debugging
  3. If you already Darkness installed Darkness from Firefox Add-on store, disable it
  4. Click Load Temporary Add-on
  5. Choose the file darkness/darkness-firefox/manifest.json

To keep Darkness up-to-date, please pull occasionally:

git checkout master
git pull upstream master
npm install

If you use it on Firefox, also run: gulp ff

Contributing fixes and new themes

Pull requests are welcome! Please see our contribution guide to quickly improve and extend Darkness

Be in touch

Misc

Darkness is licensed GPLv3. Please read our privacy policy here