blog post: GNOME Awesome Applet
authorStefano Zacchiroli <zack@upsilon.cc>
Wed, 24 Nov 2010 17:11:37 +0000 (18:11 +0100)
committerStefano Zacchiroli <zack@upsilon.cc>
Wed, 24 Nov 2010 17:14:27 +0000 (18:14 +0100)
blog/posts/2010/11/GNOME_Awesome_Applet.mdwn [new file with mode: 0644]
blog/posts/2010/11/GNOME_Awesome_Applet/rc.lua [new file with mode: 0644]
tags/awesome.mdwn [new file with mode: 0644]
tags/gnomeawesomeapplet.mdwn [new file with mode: 0644]

diff --git a/blog/posts/2010/11/GNOME_Awesome_Applet.mdwn b/blog/posts/2010/11/GNOME_Awesome_Applet.mdwn
new file mode 100644 (file)
index 0000000..c97bd7e
--- /dev/null
@@ -0,0 +1,33 @@
+# using GNOME with Awesome without die trying
+
+I'm an avid [GNOME](http://www.gnome.org) user, but I don't want to give up
+[tiling](http://en.wikipedia.org/wiki/Tiling_window_manager) due to that.
+
+After [[1.5 years with xmonad+GNOME|2009/04/xmonad_+_gnome_on_Debian]], I've
+decided it was about time to give [Awesome](http://awesome.naquadah.org/)
+another try. Last time I tried, integration with GNOME was really sub-optimal;
+in particular I've been it by the showstopping (for me) issue that it was not
+possible, back then, to
+[disable Awesome systray](http://awesome.naquadah.org/bugs/index.php?do=details&task_id=503)
+in favor of GNOME's.
+
+Nowadays, GNOME+Awesome integration is much better. It's very easy to disable
+all you don't want of Awesome (including systray) to rely upon corresponding
+GNOME desktop components (check my [[rc.lua]] for an example).
+
+Still, by renouncing Wibox in favor of GNOME Panel, you (used to) lack some
+features: (1) the ability to **monitor the current layout**, (2) **(GNOME) run
+application prompt**, and (3) **Lua code prompt**. It is to overcome these
+limitations that I've hacked
+[[**GNOME Awesome Applet**|hacking/software/gnome-awesome-applet]].
+
+Version 0.1.0 is now available for download from the
+[[homepage|hacking/software/gnome-awesome-applet]]. It's beta-quality and it's
+the first (hopefully last?) GNOME Applet I've ever written, … you know the
+drill. Feedback, bug reports, features requests, and
+[code](http://git.upsilon.cc/cgi-bin/gitweb.cgi?p=gnome-awesome-applet.git;a=summary)
+patches are more than welcome.
+
+Enjoy!
+
+[[!tag lang/english planet-debian gnome awesome gnomeawesomeapplet]]
diff --git a/blog/posts/2010/11/GNOME_Awesome_Applet/rc.lua b/blog/posts/2010/11/GNOME_Awesome_Applet/rc.lua
new file mode 100644 (file)
index 0000000..be08d03
--- /dev/null
@@ -0,0 +1,281 @@
+-- Standard awesome library
+require("awful")
+require("awful.autofocus")
+require("awful.rules")
+-- Theme handling library
+require("beautiful")
+-- Notification library
+-- require("naughty")
+-- GNOME applet support
+require("awful.remote")
+require("gnome-applet")
+
+-- -- Load Debian menu entries
+-- require("debian.menu")
+
+-- {{{ Variable definitions
+-- Themes define colours, icons, and wallpapers
+-- beautiful.init("/usr/share/awesome/themes/default/theme.lua")
+beautiful.init(awful.util.getdir("config") .. "/theme.lua")
+
+-- This is used later as the default terminal and editor to run.
+terminal = "x-terminal-emulator"
+
+editor = os.getenv("EDITOR") or "editor"
+-- editor_cmd = terminal .. " -e " .. editor
+editor_cmd = "emacsclient -c -a emacs"
+gtd_cmd = "/home/zack/bin/gtd"
+
+-- Default modkey.
+-- Usually, Mod4 is the key with a logo between Control and Alt.
+-- If you do not like this or do not have such a key,
+-- I suggest you to remap Mod4 to another key using xmodmap or other tools.
+-- However, you can use another modifier like Mod1, but it may interact with others.
+modkey = "Mod4"
+
+-- Table of layouts to cover with awful.layout.inc, order matters.
+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
+}
+-- }}}
+
+-- {{{ 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
+-- }}}
+
+-- -- Zack: no menu, as I'm using GNOME menus
+-- -- Zack: see /etc/xdg/awesome/rc.lua for legacy code
+-- -- }}}
+
+-- -- {{{ Wibox
+-- -- Zack: no wibox, as I'm using GNOME panel
+-- -- Zack: see /etc/xdg/awesome/rc.lua for legacy code
+-- -- }}}
+
+-- {{{ Mouse bindings
+root.buttons(awful.util.table.join(
+    awful.button({ }, 3, function () mymainmenu:toggle() end),
+    awful.button({ }, 4, awful.tag.viewnext),
+    awful.button({ }, 5, awful.tag.viewprev)
+))
+-- }}}
+
+-- {{{ Key bindings
+globalkeys = awful.util.table.join(
+    awful.key({ modkey,           }, "Left",   awful.tag.viewprev       ),
+    awful.key({ modkey,           }, "Right",  awful.tag.viewnext       ),
+    awful.key({ modkey,           }, "Escape", awful.tag.history.restore),
+
+    awful.key({ modkey,           }, "j",
+        function ()
+            awful.client.focus.byidx( 1)
+            if client.focus then client.focus:raise() end
+        end),
+    awful.key({ modkey,           }, "k",
+        function ()
+            awful.client.focus.byidx(-1)
+            if client.focus then client.focus:raise() end
+        end),
+    awful.key({ modkey,           }, "w", function () mymainmenu:show({keygrabber=true}) end),
+
+    -- Layout manipulation
+    awful.key({ modkey, "Shift"   }, "j", function () awful.client.swap.byidx(  1)    end),
+    awful.key({ modkey, "Shift"   }, "k", function () awful.client.swap.byidx( -1)    end),
+    awful.key({ modkey, "Control" }, "j", function () awful.screen.focus_relative( 1) end),
+    awful.key({ modkey, "Control" }, "k", function () awful.screen.focus_relative(-1) end),
+    awful.key({ modkey,           }, "u", awful.client.urgent.jumpto),
+    awful.key({ modkey,           }, "Tab",
+        function ()
+            awful.client.focus.history.previous()
+            if client.focus then
+                client.focus:raise()
+            end
+        end),
+
+    -- Standard program
+    awful.key({ modkey,           }, "Return", function () awful.util.spawn(terminal) end),
+    awful.key({ modkey, "Control" }, "r", awesome.restart),
+    awful.key({ modkey, "Shift"   }, "q", awesome.quit),
+
+    awful.key({ modkey,           }, "l",     function () awful.tag.incmwfact( 0.05)    end),
+    awful.key({ modkey,           }, "h",     function () awful.tag.incmwfact(-0.05)    end),
+    awful.key({ modkey, "Shift"   }, "h",     function () awful.tag.incnmaster( 1)      end),
+    awful.key({ modkey, "Shift"   }, "l",     function () awful.tag.incnmaster(-1)      end),
+    awful.key({ modkey, "Control" }, "h",     function () awful.tag.incncol( 1)         end),
+    awful.key({ modkey, "Control" }, "l",     function () awful.tag.incncol(-1)         end),
+    awful.key({ modkey,           }, "space", function () awful.layout.inc(layouts, 1)  end),
+    awful.key({ modkey, "Shift"   }, "space", function () awful.layout.inc(layouts, -1) end),
+
+    -- Zack's keybindings 
+    awful.key({ modkey,           }, "g",     function () awful.util.spawn(gtd_cmd, false) end),
+    awful.key({ modkey,           }, "e",     function () awful.util.spawn(editor_cmd, false) end),
+    -- Prompt
+    -- awful.key({ modkey },            "r",     function () mypromptbox[mouse.screen]:run() end),
+    -- awful.key({ modkey }, "x",
+    --           function ()
+    --               awful.prompt.run({ prompt = "Run Lua code: " },
+    --               mypromptbox[mouse.screen].widget,
+    --               awful.util.eval, nil,
+    --               awful.util.getdir("cache") .. "/history_eval")
+    --           end)
+    awful.key({ modkey,           }, "r",     gnome_run_dialog),
+    awful.key({ modkey,           }, "x",     gnome_lua_prompt)
+
+)
+
+clientkeys = awful.util.table.join(
+    awful.key({ modkey,           }, "f",      function (c) c.fullscreen = not c.fullscreen  end),
+    awful.key({ modkey, "Shift"   }, "c",      function (c) c:kill()                         end),
+    awful.key({ modkey, "Control" }, "space",  awful.client.floating.toggle                     ),
+    awful.key({ modkey, "Control" }, "Return", function (c) c:swap(awful.client.getmaster()) end),
+    awful.key({ modkey,           }, "o",      awful.client.movetoscreen                        ),
+    awful.key({ modkey, "Shift"   }, "r",      function (c) c:redraw()                       end),
+    awful.key({ modkey,           }, "t",      function (c) c.ontop = not c.ontop            end),
+    awful.key({ modkey,           }, "n",      function (c) c.minimized = not c.minimized    end),
+    awful.key({ modkey,           }, "m",
+        function (c)
+            c.maximized_horizontal = not c.maximized_horizontal
+            c.maximized_vertical   = not c.maximized_vertical
+        end)
+)
+
+-- Compute the maximum number of digit we need, limited to 9
+keynumber = 0
+for s = 1, screen.count() do
+   keynumber = math.min(9, math.max(#tags[s], keynumber));
+end
+
+-- Bind all key numbers to tags.
+-- Be careful: we use keycodes to make it works on any keyboard layout.
+-- This should map on the top row of your keyboard, usually 1 to 9.
+for i = 1, keynumber do
+    globalkeys = awful.util.table.join(globalkeys,
+        awful.key({ modkey }, "#" .. i + 9,
+                  function ()
+                        local screen = mouse.screen
+                        if tags[screen][i] then
+                            awful.tag.viewonly(tags[screen][i])
+                        end
+                  end),
+        awful.key({ modkey, "Control" }, "#" .. i + 9,
+                  function ()
+                      local screen = mouse.screen
+                      if tags[screen][i] then
+                          awful.tag.viewtoggle(tags[screen][i])
+                      end
+                  end),
+        awful.key({ modkey, "Shift" }, "#" .. i + 9,
+                  function ()
+                      if client.focus and tags[client.focus.screen][i] then
+                          awful.client.movetotag(tags[client.focus.screen][i])
+                      end
+                  end),
+        awful.key({ modkey, "Control", "Shift" }, "#" .. i + 9,
+                  function ()
+                      if client.focus and tags[client.focus.screen][i] then
+                          awful.client.toggletag(tags[client.focus.screen][i])
+                      end
+                  end))
+end
+
+clientbuttons = awful.util.table.join(
+    awful.button({ }, 1, function (c)
+       if awful.client.focus.filter(c) then
+          client.focus = c
+          c:raise()
+       end
+    end),
+    awful.button({ modkey }, 1, awful.mouse.client.move),
+    awful.button({ modkey }, 3, awful.mouse.client.resize))
+
+-- Set keys
+root.keys(globalkeys)
+-- }}}
+
+-- {{{ 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 = "pinentry" },
+      properties = { floating = true } },
+    { rule = { class = "gimp" },
+      properties = { floating = true } },
+    { rule = { class = "Skype" },
+      properties = { floating = true } },
+    { rule = { class = "Pidgin",
+              name = "Buddy List" },
+      properties = { floating = true } },
+    { rule = { class = "Seahorse-agent",
+              name = "Passphrase" },
+      properties = { floating = true } },
+    { rule = { class = "Dia",
+              name = "Diagram Editor" },
+      properties = { floating = true } },
+    { rule = { class = "Gnome-volume-manager",
+              name = "Photo Import" },
+      properties = { floating = true } },
+    { rule = { class = "Gnome-panel",
+              name = "Bottom Expanded Edge Panel" },
+      properties = { ontop = true } },
+
+    -- Set Firefox to always map on tags number 2 of screen 1.
+    -- { rule = { class = "Firefox" },
+    --   properties = { tag = tags[1][2] } },
+}
+-- }}}
+
+-- {{{ Signals
+-- Signal function to execute when a new client appears.
+client.add_signal("manage", function (c, startup)
+    -- Add a titlebar
+    -- awful.titlebar.add(c, { modkey = modkey })
+
+    -- Enable sloppy focus
+    c:add_signal("mouse::enter", function(c)
+        if awful.layout.get(c.screen) ~= awful.layout.suit.magnifier
+            and awful.client.focus.filter(c) then
+            client.focus = c
+        end
+    end)
+
+    if not startup then
+        -- Set the windows at the slave,
+        -- i.e. put it at the end of others instead of setting it master.
+        -- awful.client.setslave(c)
+
+        -- Put windows in a smart way, only if they does not set an initial position.
+        if not c.size_hints.user_position and not c.size_hints.program_position then
+            awful.placement.no_overlap(c)
+            awful.placement.no_offscreen(c)
+        end
+    end
+end)
+
+client.add_signal("focus", function(c) c.border_color = beautiful.border_focus end)
+client.add_signal("unfocus", function(c) c.border_color = beautiful.border_normal end)
+
+-- }}}
diff --git a/tags/awesome.mdwn b/tags/awesome.mdwn
new file mode 100644 (file)
index 0000000..cea8657
--- /dev/null
@@ -0,0 +1,4 @@
+[[!meta title="pages tagged awesome"]]
+
+[[!inline pages="tagged(awesome)" actions="no" archive="yes"
+feedshow=10]]
diff --git a/tags/gnomeawesomeapplet.mdwn b/tags/gnomeawesomeapplet.mdwn
new file mode 100644 (file)
index 0000000..14e39ac
--- /dev/null
@@ -0,0 +1,4 @@
+[[!meta title="pages tagged gnomeawesomeapplet"]]
+
+[[!inline pages="tagged(gnomeawesomeapplet)" actions="no" archive="yes"
+feedshow=10]]