Skip to content

Linux Mint Cinnamon Applet to control the amount of blue light emitted from your monitor

Notifications You must be signed in to change notification settings

samuel12sam/BlueLightBlocker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 

Repository files navigation

🌘 What is Blue Light Blocker

This applet is the Linux Mint equivalent of 'Night Light' (on Windows), and 'Night Shift' (on macOS).

Night Light in Windows Night Shift in MacOS

It acts as a blue light filter and makes your display use warmer colors, according to your likings. This applet, Blue Light Blocker, also allows you to control the brightness of your screen at will.

😎 YOU are in control!

Some applets are time-based, meaning they only block blue light at certain times of the day. The user has no control over the blue light filtering.

With Blue Light Blocker, however, you are in total control!

Is it still day time? Is it night time? Who cares! Don't let the clock dictate when your screen has to block blue light from entering your precious little eyes! 👁️ 👄 👁️

You want to block blue light all day? You got it!

You want to block blue light only at night? It's your call, boss!

You want to block blue light only when you feel like it? No problemo!

You can enable and disable this applet anytime in merely 2 clicks! Adjusting the warmth tone of your screen or it's brightness has never been easier, thanks to simple sliders with real-time feedback!

What a time to be alive 😌 ✨

🔋 Batteries Included!

This version of Blue Light Blocker comes with everything it needs right out of the box!

You won't need to install additionnal packages (*unless you perform an automatic installation) or enter commands in your terminal!

💻 Manual Installation

  • Download the github repository as a ZIP file

  • Extract the ZIP file

  • Place the Blue-light-blocker@samuel12sam folder inside /home/[your_name]/.local/share/cinnamon/applets/

    If you do not see .local, make sure you have enabled 'Show Hidden Files' by going into the 'View' tab of your File Explorer and ticking the option or by using the CTRL+H keyboard shortcut.

  • Open the 'Applets' window, through the 'System Settings' or by right-clicking on any panel and clicking on 'Applets'.

    Applets window
  • Select Blue Light Blocker by clicking on it, press the '+' sign at the bottom of the window to add Blue Light Blocker to your panel.

    Button to click in order to add the applet to the panel

👷 Usage

Click on the Blue Light Blocker Applet in the panel and use the sliders to modify the color temperature of your screen or its brightness.

Using Blue Light Blocker

🔧 Configuration

Right click on the Blue Light Blocker applet in your panel and click on 'Configure...'

Opening the configuration window Configuration window

🚮 Uninstalling Blue Light Blocker

  • Make sure to first remove the applet from your panel by pressing the '-' button.
Uninstalling Blue Light Blocker
  • Then uninstall it by pressing the trashcan button from the same window
Uninstalling Blue Light Blocker

🚧 Possible Future Features

  • Allow the user to use a custom icon/image for the applet in the panel
  • Allow the user to display a custom format for the color temperature in brightness info in the panel
  • Translations for other languages

⚡ Automatic Installation

Note

Please note that users who install Blue Light Blocker from the 'Download' tab in the 'Applet' window on Linux Mint will be prompted to install the xsct package, as opposed to users who manually install it. That is because the installation process through Cinnamon tempers with pre-compiled code permissions and compiling the code automatically after the applet gets downloaded from the 'Download' tab would require users to have 2 libraries/packages installed on their computer that most people don't have by default (libx11-dev and libxrandr-dev).

What's xsct and why is it required?

xsct is a public domain (open-source, but better) UNIX tool that allows you to change the color temperature of your screen. However, it only functions via terminal commands, which is a total pain in the butt to use if you frequently change the color temperature of your screen.

Blue Light Blocker uses this UNIX tool at its core and provides a user-friendly interface to let the user block the blue light from their screen using precise sliders while also adding a layer of security by making it impossible for the user to set the brightness of their screens to 0, which is possible with xsct via the terminal commands. Blue Light Blocker also adds a lot of Quality of Life features that simply don't exist with the xsct package alone.

In short, Blue Light Blocker reduces the amount of tinkering necessary to change the brightness or the color temperature of your screen while also offering a simple yet very nice user experience.

For more information about xsct : https://github.com/faf0/sct

About

Linux Mint Cinnamon Applet to control the amount of blue light emitted from your monitor

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages