Bling - Utilities for the AwesomeWM

Installation and configuration

• git clone this repo into your ~/.config/awesome folder
• Put local bling = require("bling") somewhere in your rc.lua (remember to put it under beautiful.init...)

Available layouts and modules

Layouts

Choose layouts from the list below and add them to to your awful.layouts list in your rc.lua.

Everyone of them supports multiple master clients and master width factor making them as easyily useable as the default layouts.

bling.layout.mstab
bling.layout.centered
bling.layout.vertical
bling.layout.horizontal

Window swallowing

To activate and deactivate window swallowing there are the following functions (deactivated on default):

bling.module.window_swallowing.start()   -- activates window swallowing
bling.module.window_swallowing.stop()    -- deactivates window swallowing
bling.module.window_swallowing.toggle()  -- toggles window swallowing

Tiled Wallpaper

The function to set a tiled wallpaper can be called the follwing way (you don't need to set every option in the table of the last argument since there are reasonable defaults):

awful.screen.connect_for_each_screen(function(s)  -- that way the wallpaper is applied to every screen 
    bling.module.tiled_wallpaper("x", s, {        -- call the actual function ("x" is the string that will be tiled)
        fg = "#ff0000",  -- define the foreground color
        bg = "#00ffff",  -- define the background color
        offset_y = 25,   -- set a y offset
        offset_x = 25,   -- set a x offset
        font = "Hack",   -- set the font (without the size)
        font_size = 14,  -- set the font size
        padding = 100,   -- set padding (default is 100)
        zickzack = true  -- rectangular pattern or criss cross
    })
end)

Flash Focus

There are two ways you can use this module. You can just enable it by calling the enable() function:

bling.module.flash_focus.enable()

This connects to the focus signal of a client, which means that the flash focus will activate however you focus the client.

The other way is to call the function itself like this: bling.module.flash_focus.flashfocus(someclient). This allows you to just activate on certain keybinds:

awful.key({modkey}, "Up",
    function() 
        awful.client.focus.bydirection("up")
        bling.module.flash_focus.flashfocus(client.focus)
     end, {description = "focus up", group = "client"})

Theme variables

Put those variables in your theme.lua if you want to edit appearance

For the mstab layout:

mstab_tabbar_orientation  -- set to "bottom" for tabbar at button
mstab_bar_height          -- height of the tabbar
mstab_border_radius       -- corners radius of the tabbar
mstab_font                -- font of the tabbar
mstab_bg_focus            -- background color of the focused client on the tabbar
mstab_fg_focus            -- background color of the focused client on the tabbar
mstab_bg_normal           -- foreground color of unfocused clients on the tabbar
mstab_fg_normal           -- foreground color of unfocused clients on the tabbar

For window swallowing:

dont_swallow_classname_list   -- list of client classnames that shouldn't be swallowed
                              -- default is {"firefox", "Gimp"}
dont_swallow_filter_activated -- whether the filter is activated or not
                              -- default is false.
                              -- Set it to true if you want to filter clients that should be swallowed

For flash focus:

flash_focus_start_opacity -- the starting opacity (default 0.6)
flash_focus_step          -- the step of the animation (default 0.01)

Preview

Mstab (tabbed)

screenshot by javacafe

Centered

screenshot by branwright

Window swallowing

gif by me :)

Tiled Wallpaper

(not yet)

Flash Focus

gif by javacafe