{"id":13427348,"url":"https://github.com/splintersuidman/blur","last_synced_at":"2025-03-15T23:30:42.566Z","repository":{"id":158873594,"uuid":"103951343","full_name":"splintersuidman/blur","owner":"splintersuidman","description":"A chunkwm plugin that blurs your wallpaper when you have open windows.","archived":false,"fork":false,"pushed_at":"2018-12-17T17:18:08.000Z","size":739,"stargazers_count":44,"open_issues_count":5,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-04-10T06:09:14.476Z","etag":null,"topics":["blur","chunkwm","macos","plugin","wallpaper"],"latest_commit_sha":null,"homepage":"","language":"Objective-C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/splintersuidman.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-09-18T14:42:15.000Z","updated_at":"2024-03-03T01:46:49.000Z","dependencies_parsed_at":"2023-08-01T16:00:28.260Z","dependency_job_id":null,"html_url":"https://github.com/splintersuidman/blur","commit_stats":null,"previous_names":["splintersuidman/blur"],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/splintersuidman%2Fblur","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/splintersuidman%2Fblur/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/splintersuidman%2Fblur/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/splintersuidman%2Fblur/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/splintersuidman","download_url":"https://codeload.github.com/splintersuidman/blur/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243510115,"owners_count":20302294,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blur","chunkwm","macos","plugin","wallpaper"],"created_at":"2024-07-31T00:02:00.418Z","updated_at":"2025-03-15T23:30:42.561Z","avatar_url":"https://github.com/splintersuidman.png","language":"Objective-C++","readme":"# blur [![Build Status](https://travis-ci.org/splintah/blur.svg?branch=master)](https://travis-ci.org/splintah/blur)\nThis is a plugin for [chunkwm](https://github.com/koekeishiya/chunkwm) that blurs your wallpaper when you open an application or a window.\n\n![Demonstration](demo.gif)\n\n## Content\n- [Content](#content)\n- [Settings](#settings)\n- [Runtime commands](#runtime-commands)\n- [How to install](#how-to-install)\n- [How to build from source](#how-to-build-from-source)\n- [Changelog](#changelog)\n\n## Settings\nThese settings can be set in your `.chunkwmrc` file.\nThe syntax is `chunkc set [setting] [value]`.\nExample: `chunkc set wallpaper ~/Pictures/wallpaper.jpg`\n\n- `wallpaper` (string [path]): path to your wallpaper. Default: path to your current wallpaper. This is the 'global' wallpaper.\n\n- `\u003cspace\u003e_wallpaper` (string [path]): path to a wallpaper. This wallpaper will be used on space `\u003cspace\u003e`.\n\n- `wallpaper_blur` (float): changes the blur intensity. Default: `0.0` (imagemagick selects a suitable value when `0.0` is used).\n\n- `wallpaper_mode` (`fill`, `fit`, `stretch` or `center`): the way a wallpaper is displayed. Default: `fill`.\n\n- `wallpaper_tmp_path` (string [path]): where to store the blurred wallpaper. Default: `/tmp/`.\n\n## Runtime commands\nThese commands can be used while chunkwm is running, whithout the need of reloading the plugin. The syntax is `chunkc blur::[command] [args]`.\nExample: `chunkc blur::wallpaper ~/Pictures/wallpaper.jpg`\n\n- `help`: show help about the settings and commands.\n\n- `wallpaper` (string [path]): path to you wallpaper.\n\n- `enable`: enable blurring. Blurring is enabled by default.\n\n- `disable`: disable blurring. Every desktop will get its wallpaper specified with `\u003cspace\u003e_wallpaper`, but not blurred.\n\n- `reset`: reset wallpaper on all spaces. The wallpaper will be set to the wallpaper specified with `chunkc set wallpaper`. This also disables blurring.\n\n## How to install\n### With Homebrew\nThanks to [crisidev](https://github.com/crisidev) for providing a homebrew formula, and to [koekeishiya](https://github.com/koekeishiya) for adding it to their tap.\n\n```bash\n# Clone the tap.\nbrew tap koekeishiya/formulae\n\n# Install the plugin.\nbrew install chunkwm-blur --HEAD\n\n# Get info about the plugin (e.g. loading it from your chunkwmrc).\nbrew info chunkwm-blur\n```\n\n### Downloading from GitHub\nThe precompiled releases can often be found on the GitHub releases page.\n\n- [Download the file](https://github.com/splintah/blur/releases)\n- Place it into your plugin directory\n    - This is the directory specified in your `chunkwmrc` file after `chunkc core::plugin_dir`.\n    - It may be convenient to create a folder for your plugins in your home directory (e.g. `~/.chunkwm_plugins`).\n- Load it in you `chunkwmrc` file: `chunkc core::load blur.so`.\n\n## How to build from source\n### Required\n- xcode-8 command line tools\n- imagemagick\n\n### Build process\n- Clone this repo.\n- Run `make` in this folder.\n- The binary can be found in `./bin`.\n\n## Changelog\n[CHANGELOG.md](https://github.com/splintah/blur/blob/master/CHANGELOG.md)\n","funding_links":[],"categories":["Objective-C++"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsplintersuidman%2Fblur","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsplintersuidman%2Fblur","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsplintersuidman%2Fblur/lists"}