----------------------------------------------- -- awful: AWesome Function very UsefuL -- -- Common useful awesome functions -- -- -- -- © 2008 Julien Danjou -- ----------------------------------------------- -- We usually are required as 'awful' -- But that can be changed. local P = {} -- package if _REQUIREDNAME == nil then awful = P else _G[_REQUIREDNAME] = P end -- Grab environment we need local ipairs = ipairs local pairs = pairs local awesome = awesome local screen = screen local client = client local tag = tag local mouse = mouse local os = os local table = table local hooks = hooks -- Reset env setfenv(1, P) -- Function to the good value in table, cycling function array_boundandcycle(t, i) if i > #t then i = 1 elseif i < 1 then i = #t end return i end -- Function to get a client by its relative index: -- set i to 1 to get next, -1 to get previous. function client_next(i) -- Get all visible clients local cls = client.visible_get(mouse.screen_get()) -- Get currently focused client local sel = client.focus_get() if not sel then return end -- Loop upon each client for idx, c in ipairs(cls) do if c == sel then return cls[array_boundandcycle(cls, idx +i)] end end end -- Focus a client by its relative index. function client_focus(i) local c = client_next(i) if c then c:focus_set() end end -- Swap a client by its relative index. function client_swap(i) local c = client_next(i) local sel = client.focus_get() if c and sel then sel:swap(c) end end -- Move/resize a client relativ to current coordinates. function client_moveresize(x, y, w, h) local sel = client.focus_get() local coords = sel:coords_get() coords['x'] = coords['x'] + x coords['y'] = coords['y'] + y coords['width'] = coords['width'] + w coords['height'] = coords['height'] + h sel:coords_set(coords) end function screen_focus(i) local sel = client.focus_get() local s if sel then s = sel:screen_get() else s = mouse.screen_get() end local count = screen.count() s = s + i if s < 1 then s = count elseif s > count then s = 1 end screen.focus(s) -- Move the mouse on the screen local screen_coords = screen.coords_get(s) mouse.coords_set(screen_coords['x'], screen_coords['y']) end -- Return a table with all visible tags function tag_selectedlist(s) local idx = 1 local screen = s or mouse.screen_get() local tags = tag.get(screen) local vtags = {} for i, t in ipairs(tags) do if t:isselected() then vtags[idx] = t idx = idx + 1 end end return vtags end -- Return only the first element of all visible tags, -- so that's the first visible tags. function tag_selected(s) return tag_selectedlist(s)[1] end -- Set master width factor function tag_setmwfact(i) local t = tag_selected() if t then t:mwfact_set(i) end end -- Increase master width factor function tag_incmwfact(i) local t = tag_selected() if t then t:mwfact_set(t:mwfact_get() + i) end end -- Set number of master windows function tag_setnmaster(i) local t = tag_selected() if t then t:nmaster_set(i) end end -- Increase number of master windows function tag_incnmaster(i) local t = tag_selected() if t then t:nmaster_set(t:nmaster_get() + i) end end -- Set number of column windows function tag_setncol(i) local t = tag_selected() if t then t:ncol_set(i) end end -- Increase number of column windows function tag_incncol(i) local t = tag_selected() if t then t:ncol_set(t:ncol_get() + i) end end -- View no tag function tag_viewnone() local tags = tag.get(mouse.screen_get()) for i, t in ipairs(tags) do t:view(false) end end function tag_viewidx(r) local tags = tag.get(mouse.screen_get()) local sel = tag_selected() tag_viewnone() for i, t in ipairs(tags) do if t == sel then tags[array_boundandcycle(tags, i + r)]:view(true) end end end -- View next tag function tag_viewnext() return tag_viewidx(1) end -- View previous tag function tag_viewprev() return tag_viewidx(-1) end function tag_viewonly(t) tag_viewnone() t:view(true) end function tag_viewmore(tags) tag_viewnone() for i, t in ipairs(tags) do t:view(true) end end function client_movetotag(target, c) local sel = c or client.focus_get(); local tags = tag.get(mouse.screen_get()) for i, t in ipairs(tags) do sel:tag(t, false) end sel:tag(target, true) end function client_toggletag(target, c) local sel = c or client.focus_get(); if sel then sel:tag(target, not sel:istagged(target)) end end function client_togglefloating(c) local sel = c or client.focus_get(); if sel then sel:floating_set(not sel:floating_get()) end end function layout_get(screen) local t = tag_selected(screen) if t then return t:layout_get() end end -- Function to change the layout of the current tag. -- layouts = table of layouts (define in .awesomerc.lua) -- i = relative index function layout_inc(layouts, i) local t = tag_selected() local number_of_layouts = 0 local rev_layouts = {} for i, v in ipairs(layouts) do rev_layouts[v] = i number_of_layouts = number_of_layouts + 1 end if t then local cur_layout = layout_get() local new_layout_index = (rev_layouts[cur_layout] + i) % number_of_layouts if new_layout_index == 0 then new_layout_index = number_of_layouts end t:layout_set(layouts[new_layout_index]) end end -- function to set the layout of the current tag by name. function layout_set(layout) local t = tag_selected() if t then t:layout_set(layout) end end -- Hook functions, wrappers around awesome's hooks. functions so we -- can easily add multiple functions per hook. P.hooks = {} P.myhooks = {} for name, hook in pairs(hooks) do if name ~= 'timer' then P.hooks[name] = function (f) if P.myhooks[name] == nil then P.myhooks[name] = {} hooks[name](function (...) for i,o in pairs(P.myhooks[name]) do P.myhooks[name][i]['callback'](...) end end) end table.insert(P.myhooks[name], {callback = f}) end else P.hooks[name] = function (time, f, runnow) if P.myhooks[name] == nil then P.myhooks[name] = {} hooks[name](1, function (...) for i,o in pairs(P.myhooks[name]) do if P.myhooks[name][i]['counter'] >= P.myhooks[name][i]['timer'] then P.myhooks[name][i]['counter'] = 1 P.myhooks[name][i]['callback'](...) else P.myhooks[name][i]['counter'] = P.myhooks[name][i]['counter']+1 end end end) end if runnow then table.insert(P.myhooks[name], {callback = f, timer = time, counter = time}) else table.insert(P.myhooks[name], {callback = f, timer = time, counter = 0}) end end end end function spawn(cmd) return os.execute(cmd .. "&") end -- Export tags function P.tag = { viewnone = tag_viewnone; viewprev = tag_viewprev; viewnext = tag_viewnext; viewonly = tag_viewonly; viewmore = tag_viewmore; setmwfact = tag_setmwfact; incmwfact = tag_incmwfact; setncol = tag_setncol; incncol = tag_incncol; setnmaster = tag_setnmaster; incnmaster = tag_incnmaster; selected = tag_selected; selectedlist = tag_selectedlist; } P.client = { next = client_next; focus = client_focus; swap = client_swap; movetotag = client_movetotag; toggletag = client_toggletag; togglefloating = client_togglefloating; moveresize = client_moveresize; } P.screen = { focus = screen_focus; } P.layout = { get = layout_get; set = layout_set; inc = layout_inc; } P.spawn = spawn return P