summaryrefslogtreecommitdiff
path: root/alternative_wmiircs/ruby/README
blob: 788e0b4a9d800e05e8318aeba62316d7758d9203 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
This is a modified version of sunaku's wmiirc, designed for
his Rumai Ruby module. Minor configuration changes, namely to
the color scheme and default key bindings, as well as the
configuration search path, exist in this version. Builtin mpd
support has also been removed. Also added is support for
string interpolation in key bindings, as should be apparent in
the included config.yaml.

In particular, not that there is no need to copy any files to
~/.wmii-hg or ~/.wmii other than config.yaml. The script will
happily load the requisite files from their default install
location. They can be loaded either by involing wmii as
follows:

    wmiir -r ruby/wmiirc

or running the following after startup:

    wmiir xwrite /ctl spawn ruby/wmiirc

The rumai gem is still required, as noted below.

The original readme appears below unmodified:

sunaku's Ruby wmiirc
====================

This is my wmii configuration, described in these articles:

  http://wmii.suckless.org/alternative_wmiirc_scripts

  http://snk.tuxfamily.org/lib/rumai/

  http://article.gmane.org/gmane.comp.window-managers.wmii/1704

  http://snk.tuxfamily.org/web/2006-07-01-wmii-3-1-configuration-in-ruby.html

Dependencies:

    wmii 3.6 or newer (preferably wmii-hg)

    Ruby 1.8.6 or newer

    RubyGems 1.3.1 or newer

Installation:

    # library
    gem install rumai     # required
    gem install librmpd   # optional

    # install
    mv ~/.wmii-hg ~/.wmii-hg.backup
    git clone git://github.com/sunaku/wmiirc.git ~/.wmii-hg

    # choose
    cd ~/.wmii-hg
    git checkout --track -b CHOICE origin/CHOICE # choices are:

    +--------+------------------------------------------------+
    | CHOICE | DESCRIPTION                                    |
    +--------+------------------------------------------------+
    | dvorak | sunaku's personal configuration; DSK friendly! |
    | qwerty | QWERTY port of sunaku's personal configuration |
    | strict | port of the default wmiirc shipped with wmii   |
    | master | barebones template for starting from scratch   |
    +--------+------------------------------------------------+

    # run
    ~/.wmii-hg/wmiirc

Documentation:

    # see list of all key bindings
    egrep '^ +\$\{\w+\}' ~/.wmii-hg/config.yaml

    # read the configuration file
    less ~/.wmii-hg/config.yaml

Configuration:

    Edit ~/.wmii-hg/config.yaml to your liking.

    Run ~/.wmii-hg/wmiirc to apply your changes.

Contribution:

    Fork this project on GitHub and send pull requests.

Questions:

    Send me an e-mail (see LICENSE for my address).