Skip to content

libvibrant/libvibrant

Repository files navigation

Logo vibrant

⚠️ NOTE ⚠️

libvibrant is in maintenance-only right now, as it's rather feature-complete. As I (@Scrumplex) have switched to Wayland for some time now, I can't and won't work on this library anymore. An effort for Wayland is planned in the future, though it will take some time until this can be implemented in a compositor-agnostic way.


A simple library to adjust color saturation of X11 outputs.

vibrant, with it's library libvibrant and it's command-line tool vibrant-cli, allows you to adjust the color saturation on X11 outputs, as long as the CTM property is supported.

Usage

$ vibrant-cli OUTPUT [SATURATION]

Get or set saturation of output.

OUTPUT is the name of the X11 output. You can find this by running xrandr. SATURATION is a floating point value between (including) 0.0 and (including) 4.0.

  • 0.0 or 0 means monochrome
  • 1.0 or 1 is normal color saturation (100%)
  • if empty the saturation will not be changed

Examples

150% on DisplayPort-0

$ vibrant-cli DisplayPort-0 1.5

Monochrome on DisplayPort-0

$ vibrant-cli DisplayPort-0 0

Reset DisplayPort-0

$ vibrant-cli DisplayPort-0 1

Only query current saturation on DisplayPort-0

$ vibrant-cli DisplayPort-0

Compatibility

Check the wiki: https://github.com/libvibrant/libvibrant/wiki/Compatibility

Installation

Arch Linux

vibrant is available on the Arch Linux User Repository.

  • vibrantAUR - Latest release of the vibrant library and vibrant-cli
  • vibrant-gitAUR - Latest revision from Git master of the vibrant library and vibrant-cli

Other Distros

See Bulding

Building

This project uses CMake.

Dependencies

  • libX11
  • libXrandr (possibly bundled with libX11)
  • libXNVCtrl (possibly bundled with nvidia-settings)

Basic building

$ cd <project directory>
$ mkdir build
$ cd build
$ cmake ..
$ make

The binary will be called vibrant-cli and will be linked to libvibrant.so.0

License

This project is licensed under the terms of the GNU General Public License 3.0. You can read the full license text in LICENSE.

Additionally this project is based on color-demo-app written by Leo (Sunpeng) Li sunpeng.li@amd.com, licensed under the terms of the MIT license. You can read it's full license text in NOTICE