Pinnacle Wiki

Appearance

Outputs ​

An output is the Wayland term for a monitor. They display what the compositor renders.

Outputs are mapped to a coordinate in a global space.

Output setup ​

You can set up outputs using the for_each_output function. This function runs a closure on all currently connected outputs as well as all newly connected ones.

lua
require("pinnacle.output").for_each_output(function(output)
    -- Do stuff with output
end)

Setting up tags ​

You will want to add tags to all outputs you have, or else they won't be able to display windows.

IMPORTANT

Currently, adding tags to an output doesn't set any of them to active. You will want to make at least one tag active. This will most likely change in the future.

lua
require("pinnacle.output").for_each_output(function(output)
    local tags = require("pinnacle.tag").add(output, { "1", "2", "3" })
    tags[1]:set_active(true)
end)

Setting output locations ​

For those with multiple monitors, you may want to change the locations of outputs.

The output API provides a lower-level way to move outputs through set_loc. This directly moves the output to the given coordinates in the global space.

lua
local output = require("pinnacle.output").get_focused()
output:set_loc(1920, 0)

NOTE

If you move outputs such that there is a gap between them, the pointer will not be able to move from one output to the other.

Of course, setting the location like this is error-prone. A helper function is provided to move outputs relative to other outputs: set_loc_adj_to.

set_loc_adj_to moves an output adjacent to another output. You can specify which side to move it adjacent to and how to align the outputs.

lua
local hdmi1 = require("pinnacle.output").get_by_name("HDMI-1")
local dp1 = require("pinnacle.output").get_by_name("DP-1")
hdmi1:set_loc_adj_to(dp1, "left_align_bottom")

TIP

You may opt to use external tools like kanshi to simplify the process of laying out outputs, especially when your monitor setup changes frequently.