Skip to content

A chunkwm plugin that blurs your wallpaper when you have open windows.

License

Notifications You must be signed in to change notification settings

splintersuidman/blur

Repository files navigation

blur Build Status

This is a plugin for chunkwm that blurs your wallpaper when you open an application or a window.

Demonstration

Content

Settings

These settings can be set in your .chunkwmrc file. The syntax is chunkc set [setting] [value]. Example: chunkc set wallpaper ~/Pictures/wallpaper.jpg

  • wallpaper (string [path]): path to your wallpaper. Default: path to your current wallpaper. This is the 'global' wallpaper.

  • <space>_wallpaper (string [path]): path to a wallpaper. This wallpaper will be used on space <space>.

  • wallpaper_blur (float): changes the blur intensity. Default: 0.0 (imagemagick selects a suitable value when 0.0 is used).

  • wallpaper_mode (fill, fit, stretch or center): the way a wallpaper is displayed. Default: fill.

  • wallpaper_tmp_path (string [path]): where to store the blurred wallpaper. Default: /tmp/.

Runtime commands

These commands can be used while chunkwm is running, whithout the need of reloading the plugin. The syntax is chunkc blur::[command] [args]. Example: chunkc blur::wallpaper ~/Pictures/wallpaper.jpg

  • help: show help about the settings and commands.

  • wallpaper (string [path]): path to you wallpaper.

  • enable: enable blurring. Blurring is enabled by default.

  • disable: disable blurring. Every desktop will get its wallpaper specified with <space>_wallpaper, but not blurred.

  • reset: reset wallpaper on all spaces. The wallpaper will be set to the wallpaper specified with chunkc set wallpaper. This also disables blurring.

How to install

With Homebrew

Thanks to crisidev for providing a homebrew formula, and to koekeishiya for adding it to their tap.

# Clone the tap.
brew tap koekeishiya/formulae

# Install the plugin.
brew install chunkwm-blur --HEAD

# Get info about the plugin (e.g. loading it from your chunkwmrc).
brew info chunkwm-blur

Downloading from GitHub

The precompiled releases can often be found on the GitHub releases page.

  • Download the file
  • Place it into your plugin directory
    • This is the directory specified in your chunkwmrc file after chunkc core::plugin_dir.
    • It may be convenient to create a folder for your plugins in your home directory (e.g. ~/.chunkwm_plugins).
  • Load it in you chunkwmrc file: chunkc core::load blur.so.

How to build from source

Required

  • xcode-8 command line tools
  • imagemagick

Build process

  • Clone this repo.
  • Run make in this folder.
  • The binary can be found in ./bin.

Changelog

CHANGELOG.md