# Turn Off the Lights Browser Extension

<img alt="Turn Off the Lights Browser Extension Logo" src="https://github.com/turnoffthelights/Turn-Off-the-Lights-Chrome-extension/blob/master/src/icons/icon48.png" align="left" style="padding: 0 10px 5px 0">

**Turn Off the Lights** is a popular browser extension that works on all major web browsers such as Google Chrome, Firefox, Opera, Safari, Yandex, Maxthon, Brave, Vivaldi, Cốc Cốc, and Microsoft Edge.

![Chrome Web Store](https://img.shields.io/chrome-web-store/d/bfbmjmiodbnnpllbbbfblcplfjjepjdn.svg?color=#44cc12&style=flat-square)
![Chrome Web Store](https://img.shields.io/chrome-web-store/rating/bfbmjmiodbnnpllbbbfblcplfjjepjdn?color=#44cc12&style=flat-square)
![Chrome Web Store](https://img.shields.io/chrome-web-store/v/bfbmjmiodbnnpllbbbfblcplfjjepjdn.svg?color=#44cc12&style=flat-square)

Project<br>
[![CodeQL](https://github.com/turnoffthelights/Turn-Off-the-Lights-Chrome-extension/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/turnoffthelights/Turn-Off-the-Lights-Chrome-extension/actions/workflows/codeql-analysis.yml)
[![Language grade: JavaScript](https://img.shields.io/lgtm/grade/javascript/g/turnoffthelights/Turn-Off-the-Lights-Chrome-extension.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/turnoffthelights/Turn-Off-the-Lights-Chrome-extension/context:javascript)

Using Turn Off the Lights to dims the web page and reduces the eye strain caused by the bright screen. And it will highlight the video player on that web page such as on YouTube.


**[Join our growing community on Facebook](https://www.facebook.com/turnoffthelight) to stay up to date!**

**[Join our growing Translators community on Crowdin](https://www.crowdin.com/project/turnoffthelights) to stay up to date!**

**[Please use and enjoy it, and if you can make a donation of any amount, I'd appreciate it immensely](https://www.turnoffthelights.com/donate.html)**

<div style="text-align:center">
<img alt="Turn Off the Lights Browser extension Screenshot in Google Chrome" src="https://www.turnoffthelights.com/images/turnoffthelights-twitter.png">
</div>

## Features
* Turn the lights back on, by clicking on it
* Support multiple video sites: YouTube, HTML5 video,... and more
* Customize your YouTube:
  * Auto HD: Set videos to play in HD automatically. Users can select from highres > 8K > 5K> 4K > 1080p > 720p > 480p > 360p > 240p > 144p > default
  * Auto Wide: Automatically plays the video on the widest mode
     ,... and more
* Easter Eggs:
  * Shortcut key: T -> Do you like a real movie theater feeling?
* Option to make the screen dark when the user clicks on the play button
* Option to turn on/off the fade in and fade out effects
* Custom colors
* Option to Flash Detection
* Option to Show Dimness Level Bar
* Option Eye Protection for when it's night. And with whitelist/blacklist filter
* Option atmosphere lighting that shows a glow around the video player
* Option to show the dark layer on the top of the window
* Options to shortcut keys:
  * Ctrl + Shift + L to toggle the lights
  * Alt + F8 to restore the default opacity value
  * Alt + F9 to save the current opacity value
  * Alt + F10 to enable/disable the Eye Protection feature
  * Alt + (arrow up) to increase the opacity
  * Alt + (arrow down) to decrease the opacity
  * Alt + * to toggle the lights on all open tabs
* Option Camera Motion
* Option Speech Recognition
* Option for Mouse Wheel Volume Control for each HTML5 video player
* Option to add a filter to the current HTML5 video player (grayscale, sepia, invert, contrast, saturate, hue rotation and brightness)
* Option to show the Audio Visualization effect on top of the current HTML5 video (Blocks, Frequency and Music Tunnel)
* Option to loop the current HTML5 video player
* Option to place the Night Mode switch to toggle YouTube in black or white theme. And with whitelist/blacklist filter
  * Time stamp: Activate the Night Mode within the chosen time
  * Blackout: Dims the web page and activates the Night Mode
* Option to stop YouTube and HTML5 videos from automatically playing.

## Installation
#### Loading it in Chrome:
1. Open your Google Chrome web browser, browse to [chrome://extensions](chrome://extensions)
1. If you have already Turn Off the Lights Chrome extension installed, disable it
1. Check **Developer mode** in the top of the Extensions page
1. Click **Load unpacked extension...**
1. Choose the sub-directory **src** (where manifest.json resides)

#### Store hyperlinks:
The Browser extension is available in the following stores:
* [Google Chrome in the Chrome web store](https://chrome.google.com/webstore/detail/turn-off-the-lights/bfbmjmiodbnnpllbbbfblcplfjjepjdn)
* [Opera in the Opera Extension gallery](https://addons.opera.com/extensions/details/turn-off-the-lights/)
* [Firefox in the Firefox Extension gallery](https://addons.mozilla.org/firefox/addon/turn-off-the-lights/)
* [Safari in the Safari Extension gallery](https://itunes.apple.com/us/app/turn-off-the-lights-for-safari/id1273998507?ls=1&mt=12&at=1010lwtb)
* Available for Yandex: See Yandex built-in extension
* [Maxthon in the Maxthon Extension gallery](http://extension.maxthon.com/detail/index.php?view_id=1813)
* [Microsoft Edge in the Windows Store](https://microsoftedge.microsoft.com/addons/detail/turn-off-the-lights/fmamkbgpnienhphflfdamlhnljffjdgm)
