Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Ruby configuration for wmii window manager
Ruby

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
control
display
lib
.gitignore
EXAMPLE.config.yaml
LICENSE
README.md
wmiirc

README.md

sunaku's Ruby wmiirc

screenshot

This is a Ruby and YAML based configuration of the wmii window manager. It manipulates wmii through the Rumai library, which comes with an interactive shell for live experimentation.

This configuration is also discussed in the following articles:


Prerequisites


Installing

Backup:

mv ~/.wmii ~/.wmii.backup
mv ~/.wmii-hg ~/.wmii-hg.backup

Install:

git clone git://github.com/sunaku/wmiirc.git ~/.wmii
ln -s ~/.wmii ~/.wmii-hg

Branch:

cd ~/.wmii
git checkout -b personal
cp -vb EXAMPLE.config.yaml config.yaml

Configuring

  • Edit ~/.wmii/config.yaml to your liking. For a real-life example, see my personal configuration file.

  • If wmii is already running, run ~/.wmii/wmiirc or invoke the "reload" action to apply your changes.


Running

  • Ensure that your ~/.xinitrc supports crash recovery by allowing you to restart wmii without losing your applications if it crashes or if you accidentally kill it:

      xterm -e tail -F ~/.wmii/wmiirc.log &
    
      while true; do
        ck-launch-session wmii
        xmessage 'Do you really want to quit wmii?' \
                 -buttons 'Yes:0,No:1' -center \
                 -default 'No' -timeout 30 \
        && break
      done
    
  • If wmii is already running, run ~/.wmii/wmiirc to start the configuration. Otherwise, run startx normally and wmii will automatically recognize and apply this configuration.


Upgrading

# assuming that "origin" points to github.com/sunaku/wmiirc
git fetch origin
git checkout master
git rebase origin/master
git checkout personal
git rebase master

Hacking

To use the development version of Rumai directly from its source code repository (instead of the currently published gem version), do this:

cd ~/.wmii
git clone git://github.com/sunaku/rumai.git
sed '2a$:.unshift File.expand_path("../rumai/lib", __FILE__)' -i wmiirc

Contributing

Fork this project on GitHub and send pull requests.


Bugs, Features, Issues, Questions

File a report on the issue tracker.


License

Released under the ISC license. See the LICENSE file for details.

Something went wrong with that request. Please try again.