Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings
This repository was archived by the owner on Sep 17, 2019. It is now read-only.

crisidev/homebrew-chunkwm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

88 Commits
 
 
 
 
 
 

Repository files navigation

homebrew-chunkwm

Homebrew Tap for Chunkwm tiling window manager (https://github.com/koekeishiya/chunkwm)

NOTE: plugins folder has been moved to /usr/local/opt/chunkwm/share/chunkwm/plugins

Table of contents

  1. Supported OSX versions
  2. Brew Options
  3. Caveats
  4. Usage examples
  5. Plugins

Supported OSX versions

Chunkwm works with MacOSX >= 10.11

Brew options

--with-logging
	Redirect stdout and stderr to log files to standard brew path.
--with-purify
    Build purify plugin.
--with-tmp-logging
	Redirect stdout and stderr to /tmp.
--without-border
	Do not build border plugin.
--without-ffm
	Do not build focus-follow-mouse plugin.
--without-tiling
	Do not build tiling plugin.
--HEAD
	Install HEAD version

Caveats

Copy the example configuration into your home directory:

cp /usr/local/opt/chunkwm/share/chunkwm/examples/chunkwmrc ~/.chunkwmrc

Opening chunkwm will prompt for Accessibility API permissions. After access has been granted, the application must be restarted:

brew services restart chunkwm

If both --with-logging and --with-tmp-logging are specified, the former takes precedence over the latter.

Codesign chunkwm binary

Accessibility API must be granted after every update to chunkwm, unless you codesign the binary with self-signed certificate before restarting

Create code signing certificate named "chunkwm-cert" using Keychain Access.app:

  • Open Keychain Access.app
  • From menu select Keychain Access -> Certificate Assistant -> Create a certificate
  • Fill the certificate form:
    • Name: chunkwm-cert
    • Identity Type: Self Signed Root
    • Certificate Type: Code Signing

Sign the binary:

codesign -fs "chunkwm-cert" /usr/local/opt/chunkwm/bin/chunkwm

To have launchd start crisidev/chunkwm/chunkwm now and restart at login:

brew services start crisidev/chunkwm/chunkwm

Or, if you don't want/need a background service you can just run:

chunkwm

Logging

If the formula has been built with --with-logging, logs will be found in

/usr/local/var/log/chunwm/chunkwm.[out|err].log

Usage examples

Clone tap

brew tap crisidev/homebrew-chunkwm

Install latest stable version

brew install chunkwm

Install from git repo

brew install --HEAD chunkwm

Do not install border, tiling, and ffm plugins

brew install --without-border --without-tiling --without-ffm chunkwm

Log chunkwm stdout and stderr on /tmp

brew install --with-tmp-logging chunkwm

Plugins

In the repo I am also distributing other chunkwm plugins.

Blur wallpaper when there are open windows.

brew install --HEAD chunkwm-blur

About

Homebrew Tap for Chunkwm tiling window manage (https://github.com/koekeishiya/chunkwm)

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 5

Morty Proxy This is a proxified and sanitized view of the page, visit original site.