Skip to main content
Version: 2.2 (dev)

Carousel: set column widths somewm-only

Set column sizes as fractions of the effective viewport, after peek space is removed. For the vertical carousel, the same settings control row height.

Change the Default Width​

New columns default to 1.0. Set a different fraction before creating tags:

awful.layout.suit.carousel.default_column_width = 0.5

Alternatively, set theme.carousel_default_column_width = 0.5 in your theme. The theme value takes priority. Changing the default does not resize existing columns.

To choose an application's initial width, add a client rule inside your existing request::rules handler:

ruled.client.append_rule {
rule = { class = "^firefox$" },
properties = { carousel_column_width = 0.75 },
}

This property takes priority over the default when carousel creates the client's column. It does not continuously resize an existing column.

Cycle Through Presets​

Add this binding to rc.lua:

awful.keyboard.append_global_keybindings({
awful.key({ modkey }, "bracketright", function()
awful.layout.suit.carousel.cycle_column_width()
end, { description = "cycle column width", group = "carousel" }),
})

The default presets are { 1/3, 1/2, 2/3, 1.0 }. Each press advances the focused column to the next value, wrapping at the end. A width outside the list cycles to the first preset.

Customize the Preset List​

awful.layout.suit.carousel.width_presets = { 0.5, 0.75, 1.0 }

Use positive fractions. Values above 1.0 create columns wider than the viewport.

Adjust Width Incrementally​

Call these from your own callbacks:

local carousel = awful.layout.suit.carousel
carousel.adjust_column_width(0.05)
carousel.adjust_column_width(-0.05)

Each call adds to the focused column's fraction and clamps the result to 0.1–2.0.

Set an Exact Width​

awful.layout.suit.carousel.set_column_width(1/3)

This also clamps to 0.1–2.0.

Maximize a Column​

awful.layout.suit.carousel.maximize_column()

This sets the fraction to 1.0. These operations require a focused client on the focused screen's carousel layout.

See Also​