Awesome入门指南

如果希望改变默认的布局和修改布局的切换顺序，可以通过修改 rc.lua 文件来实现。找到像这样的一段代码：

layouts =
 {
     awful.layout.suit.floating,
     awful.layout.suit.tile,
     awful.layout.suit.tile.left,
     awful.layout.suit.tile.bottom,
     awful.layout.suit.tile.top,
     awful.layout.suit.fair,
     awful.layout.suit.fair.horizontal,
     awful.layout.suit.spiral,
     awful.layout.suit.spiral.dwindle,
     awful.layout.suit.max,
     awful.layout.suit.max.fullscreen,
     awful.layout.suit.magnifier
 }   

这是所有Awesome提供的布局方案，并且是按切换顺序排列的。可以通过调整顺序来改变实际的布局切换顺序。如果不喜欢其中的一些布局方案，你可以把相应的代码给去掉。比如，对于我而言，全屏、放大和螺旋式布局都是不常用的，并且我希望第一个布局是平铺，而不是浮动，因此可以改成：

layouts =
{
    awful.layout.suit.tile,
    awful.layout.suit.tile.left,
    awful.layout.suit.tile.bottom,
    awful.layout.suit.tile.top,
    awful.layout.suit.fair,
    awful.layout.suit.fair.horizontal,
    awful.layout.suit.floating,
    awful.layout.suit.max
}

完成后保存修改，然后按 Mod4 + Control + r 重启 Awesome看看变化。

有些程序的窗口不适合采用平铺的方式，比如Firefox的下载窗口，或者Gimp的图层窗口、工具栏窗口等，这时候我们希望将这样的窗口设置为浮动：

-- 需要自动设置为浮动的程序
-- 只需要把你想要设置为浮动窗口的程序的Instance或者class按照下面的格式写进去就行
-- 了。在awesome下用Mod4 + Ctr + i就可以看到当前程序的instance和class名字
-- {{{ Rules
awful.rules.rules = {
   -- All clients will match this rule.
   {rule = {},
    properties = {border_width = beautiful.border_width,
                  border_color = beautiful.border_normal,
                  focus = true,
                  keys = clientkeys,
                  buttons = clientbuttons}},
   {rule = {class = "MPlayer"},
    properties = {floating = true}},
   {rule = {class = "Smplayer"},
    properties = {floating = true, tag = tags[1][6]}},
   { rule = { class = "pinentry" },
     properties = { floating = true } },
   { rule = { class = "gimp" },
     properties = { floating = true } },
   {rule = {class = "Firefox"},
     properties = {tag = tags[1][1]}},
   {rule = {class = "Firefox", name = "Download"},
     properties = {floating = true}},
   {rule = {class = "VirtualBox"},
     properties = {floating = true, tag = tags[1][2]}},
   -- Set Firefox to always map on tags number 2 of screen 1.
   -- { rule = { class = "Firefox" },
   --   properties = { tag = tags[1][2] } },
} -- }}}

只要你愿意，你可以为每一个标签命名，并为每一个标签设置默认布局。这是 rc.lua 里默认的标签设置：

-- {{{ Tags
-- Define a tag table which hold all screen tags.
tags = {}
for s = 1, screen.count() do
    -- Each screen has its own tag table.
    tags[s] = awful.tag({ 1, 2, 3, 4, 5, 6, 7, 8, 9 }, s, layouts[1])
end
-- }}}
    #+END_EXAMPLE

    现在我们可以改变每个标签的名字，并为每一个设置默认布局。参考下面这段代码：

    #+BEGIN_EXAMPLE 
 -- {{{ Tags
 -- Define a tag table which will hold all screen tags.
 tags = {
   names  = { "main", "www", "im", "gimp", "office", "music", "virtual", 8, 9 },
   layout = { layouts[1], layouts[8], layouts[8], layouts[7], layouts[1],
              layouts[7], layouts[8], layouts[1], layouts[1]
 }}
 for s = 1, screen.count() do
     -- Each screen has its own tag table.
     tags[s] = awful.tag(tags.names, s, tags.layout)
 end
 -- }}}    

在这个例子中，我们还为前5个标签分别命名为"main", "www", "im", "gimp" 和 "office"，你可以根据自己的喜好进行更改。另外，我们还使用 layouts 来指定每一个标签的布局，"[]"里的数字就是我们刚刚 定制布局 的时候设置的布局的顺序，例如[ 1 ]就是第1个布局。

觉得默认的主题不够漂亮？Awesome自带了三套主题： default 、 sky 和 zenburn 。要更换主题，可以打开 rc.lua 配置文件，找到这一行内容：

beautiful.init("/usr/share/awesome/themes/default/theme.lua")

把其中的 default 更换成其他主题名字即可。如果嫌主题太少，这里有很多PP的用户定制主题：Beautiful_themes 。到它的 Github主页 下载下来然后拷贝到~/.config/awesome/themes即可以使用。

不喜欢那个黑不溜秋的背景图片？可以修改一下你正在使用的主题的theme.lua文件，将这一句

theme.wallpaper_cmd = { "awsetbg /usr/share/awesome/themes/default/background.png" }

里的图片的文件路径更改为你喜欢的图片的文件路径即可。

可以通过修改 rc.lua 的相应内容来定制主菜单的内容。下面是我的配置。里面的设置完全根据我个人口味，而且用了几个第三方的icon。因此代码仅供参考，不建议照搬：

-- {{{ Menu
-- Create a laucher widget and a main menu
myawesomemenu = {
   { "manual", terminal .. " -e man awesome" },
   { "edit config", editor_cmd .. " " .. awesome.conffile },
   { "restart", awesome.restart },
   { "quit", awesome.quit }
}

-- 创建一个favorite子菜单
myfavoriteapps = {
   { "Terminal", terminal },
   { "Firefox", "firefox" },
   { "QQ", "qq2012"},
   { "XMind", "/usr/local/xmind/xmind" },
   { "Synaptic", "gksudo synaptic" },
   { "Transmission", "transmission-gtk"},
   { "Software-Center", "gksudo software-center" },
   { "Update-Manager", "gksudo update-manager" },
   { "JabRef", "sh /home/ehome/JabRef.sh" }
}

mymainmenu = awful.menu({ items = { { "awesome", myawesomemenu, beautiful.awesome_icon },
                                    { "Debian", debian.menu.Debian_menu.Debian , theme.deb_icon },
                                    -- 添加Favorite菜单，并将icon设置为theme.fav_icon
                                    { "Favorite", myfavoriteapps, theme.fav_icon },
                                    { "Home", "dolphin" , theme.home_icon },
                                    -- 添加Emacs菜单项
                                    { "Emacs", "emacs" },
                                    -- 添加Chrome菜单项
                                    { "Chrome", "google-chrome" },
                                    -- 添加一个关机对话框
                                    { "Log out", "/usr/local/shutdown.sh" }
                                  }
                        })

mylauncher = awful.widget.launcher({ image = image(beautiful.awesome_icon),
                                     menu = mymainmenu })
-- }}}

修改的主菜单如右图所示。

Awesome 自己不提供音量控制插件，如果未经设置，还会发现原本键盘上的多媒体按键都会失效，这是因为没有让 Awesome 绑定这些热键。下面实现一个音量控制插件，并且将音量控制绑定到多媒体键盘的音量加（XF86AudioRaiseVolume）、音量减（XF86AudioLowerVolume）、静音（XF86AudioMute）几个按键上。

首先实现一个音量控制插件，将它保存为 ~/.config/awesome/volume.lua：

-- Create a volume control

volume_widget = widget({ type = "textbox", name = "tb_volume",
                         align = "right" })

function update_volume(widget)
   local fd = io.popen("amixer sget Master")
   local status = fd:read("*all")
   fd:close()

   local volume = tonumber(string.match(status, "(%d?%d?%d)%%")) / 100
   -- volume = string.format("% 3d", volume)

   status = string.match(status, "%[(o[^%]]*)%]")

   -- starting colour
   local sr, sg, sb = 0x3F, 0x3F, 0x3F
   -- ending colour
   local er, eg, eb = 0xDC, 0xDC, 0xCC

   local ir = volume * (er - sr) + sr
   local ig = volume * (eg - sg) + sg
   local ib = volume * (eb - sb) + sb
   interpol_colour = string.format("%.2x%.2x%.2x", ir, ig, ib)
   if string.find(status, "on", 1, true) then
      volume = " <span background='#" .. interpol_colour .. "'>   </span>"
   else
      volume = " <span color='red' background='#" .. interpol_colour .. "'> M </span>"
   end
   widget.text = volume
end

update_volume(volume_widget)
awful.hooks.timer.register(1, function () update_volume(volume_widget) end)

然后编辑 rc.lua ，在开头引入这个插件：

-- Volume contrl
require("volume")

在 wibox 中添加这个插件，例如放在系统托盘的右侧：

mywibox[s].widgets = {
 {
    ..
    volume_widget,
    s == 1 and mysystray or nil,
    ..

最后绑定到几个多媒体键：

-- volume control
awful.key({ }, "XF86AudioRaiseVolume", function ()
             awful.util.spawn("amixer set Master 9%+") end),
awful.key({ }, "XF86AudioLowerVolume", function ()
             awful.util.spawn("amixer set Master 9%-") end),
awful.key({ }, "XF86AudioMute", function ()
             awful.util.spawn("amixer sset Master toggle") end),

这个插件将在状态栏放置一个亮度随音量大小改变的白色小方块，当系统处于静音状态时，图标将变为一个红色的 M 字符。

这个插件基于命令行天气工具 weather-util 。添加了这个插件后，状态栏将出现一个显示当前温度的 textbox。当鼠标移动到它上面时，将会弹出一个消息框，提供更详细的天气信息。

首先，安装 weather-util：

$ sudo apt-get install weather-util

然后，编写 weather.lua 并放入 ~/.config/awesome/ 中：

--Create a weather widget
weatherwidget = widget({ type = "textbox" })
weatherwidget.text = awful.util.pread(
  "weather -i METARID --headers=Temperature --quiet -m | awk '{print $2, $3}'"
) -- replace METARID with the metar ID for your area. This uses metric. If you prefer Fahrenheit remove the "-m" in "--quiet -m".
weathertimer = timer(
  { timeout = 900 } -- Update every 15 minutes. 
) 
weathertimer:add_signal(
  "timeout", function() 
     weatherwidget.text = awful.util.pread(
     "weather -i METARID --headers=Temperature --quiet -m | awk '{print $2, $3}' &"
   ) --replace METARID and remove -m if you want Fahrenheit
 end)

weathertimer:start() -- Start the timer
weatherwidget:add_signal(
"mouse::enter", function() 
  weather = naughty.notify(
    {title="Weather",text=awful.util.pread("weather -i METARID -m")})
  end) -- this creates the hover feature. replace METARID and remove -m if you want Fahrenheit
weatherwidget:add_signal(
  "mouse::leave", function() 
    naughty.destroy(weather) 
  end)
-- I added some spacing because on my computer it is right next to my clock.
awful.widget.layout.margins[weatherwidget] = { right = 5 } 

要注意把上面的几个 METARID 改成你所在城市的 meta ID，你可以在 这里 找到很多城市的 meta ID，例如，广州的 meta ID 是 "ZGGG" 。

完成后，在 rc.lua 的开头添加这个插件：

-- Weather forecast
require("weather")

然后在wibox中添加这个插件，例如放在 text clock 的右边：

mywibox[s].widgets = {
..
weatherwidget,
mytextclock,
..

对于笔记本用户，笔记本电池的电量显示总是不可或缺的东西。及时获取当前的电池状态，可以防止因为电池电量用尽而带来不可挽回的灾难。实现电量插件有很多方法，这里介绍一个简单的基于 acpitool 的电量插件。

首先，安装 acpitool：

$ sudo apt-get install acpitool

然后，编写 power.lua 并放入 ~/.config/awesome/ 中：

mybattmon = widget({ type = "textbox", name = "mybattmon", align = "right" })
function battery_status ()
    local output={} --output buffer
    local fd=io.popen("acpitool -b", "r") --list present batteries
    local line=fd:read()
    while line do --there might be several batteries.
        local battery_num = string.match(line, "Battery \#(%d+)")
        local battery_load = string.match(line, " (%d*\.%d+)%%")
        local time_rem = string.match(line, "(%d+\:%d+)\:%d+")
        local discharging
        if string.match(line, "discharging")=="discharging" then --discharging: always red
                discharging="<span color=\"#CC7777\">"
        elseif tonumber(battery_load)>85 then --almost charged
                discharging="<span color=\"#77CC77\">"
        else --charging
                discharging="<span color=\"#CCCC77\">"
        end
        if battery_num and battery_load and time_rem then
            table.insert(output,discharging.."BAT#"..battery_num.." "..battery_load.."% "..time_rem.."</span>")
        elseif battery_num and battery_load then --remaining time unavailable
            table.insert(output,discharging.."BAT#"..battery_num.." "..battery_load.."%</span>")
        end --even more data unavailable: we might be getting an unexpected output format, so let's just skip this line.
        line=fd:read() --read next line
    end
    return table.concat(output," ") --FIXME: better separation for several batteries. maybe a pipe?
end
mybattmon.text = " " .. battery_status() .. " "
my_battmon_timer=timer({timeout=30})
my_battmon_timer:add_signal("timeout", function()
    --mytextbox.text = " " .. os.date() .. " "
    mybattmon.text = " " .. battery_status() .. " "
end)
my_battmon_timer:start()    

在 rc.lua 的开头添加这个插件：

-- Battery Power Control
require("power")

然后在wibox中添加这个插件，例如放在 text clock 的左边：

mywibox[s].widgets = {
..
mytextclock,
mybattmon,
..

我们在介绍如何 找回Gnome的指示器 的时候已经提到了.xinitrc和.xprofile这两个文件。系统在启动X时 ，默认会执行~/.xinitrc里的命令完成一些初始化工作。如果用kdm/gdm/…等登录管理器，则默认执行~/.xprofile文件的命令，而忽略~/.xinitrc。利用这个特性，我们可以通过修改~/.xinitrc或~/.xprofile文件的内容实现程序的自启动。

但要注意的是，由于.xinitrc和.xprofile主要用来在启动X时做一些初始化的工作，这个时候X可能还没启动，所以运行图形界面的程序可能会有问题。因此，这种方式比较适合用来执行一些后台命令，例如设置环境变量、启动后台服务等，而不太适合用来启动一些图形界面的程序。

最简单的方式是在 rc.lua 里添加类似这样的代码：

awful.util.spawn_with_shell("firefox")
awful.util.spawn_with_shell("thunderbird")
awful.util.spawn_with_shell("amarok")
awful.util.spawn_with_shell("amule")

如果要自启动很多程序，重复写这样的语句显得有点suck，所以可以采用循环的方式：

-- Autorun programs
autorun = true
autorunApps = 
{ 
    "firefox",
    "thunderbird",
    "amarok",
    "amule",
}

if autorun then
    for app = 1, #autorunApps do
        awful.util.spawn_with_shell(autorunApps[app])
    end
end   

其中把autorunApps中的内容替换为你想要运行的程序就可以了。

但这种自启动方式会在每次启动Awesome的时候都运行这些程序，每次需要重启Awesome时，会发现这些程序又再次启动了一次。因此最好是让这些程序只启动一次。将上面的代码改为：

function run_once(cmd)
  findme = cmd
  firstspace = cmd:find(" ")
  if firstspace then
    findme = cmd:sub(0, firstspace-1)
  end
  awful.util.spawn_with_shell("pgrep -u $USER -x " .. findme .. " > /dev/null || (" .. cmd .. ")")
end

run_once("amarok")
run_once("xscreensaver -no-splash")