Wide
Main window on top, remaining windows arranged horizontally below. Ideal for ultrawide monitors where vertical space is limited.
Layout
Section titled “Layout”1 window
Section titled “1 window”┌───────────────────────────────────────────────────────────┐│ ││ ││ ││ ││ ││ ││ ││ ││ 1 ││ ││ ││ ││ ││ ││ ││ ││ │└───────────────────────────────────────────────────────────┘2 windows
Section titled “2 windows”┌───────────────────────────────────────────────────────────┐│ ││ ││ ││ 1 ││ ││ ││ ││ │├───────────────────────────────────────────────────────────┤│ ││ ││ ││ 2 ││ ││ ││ ││ │└───────────────────────────────────────────────────────────┘3 windows
Section titled “3 windows”┌───────────────────────────────────────────────────────────┐│ ││ ││ ││ 1 ││ ││ ││ ││ │├─────────────────────────────┬─────────────────────────────┤│ │ ││ │ ││ │ ││ 2 │ 3 ││ │ ││ │ ││ │ ││ │ │└─────────────────────────────┴─────────────────────────────┘4+ windows
Section titled “4+ windows”┌───────────────────────────────────────────────────────────┐│ ││ ││ ││ 1 ││ ││ ││ ││ │├───────────────────┬───────────────────┬───────────────────┤│ │ │ ││ │ │ ││ │ │ ││ 2 │ 3 │ 4 ││ │ │ ││ │ │ ││ │ │ ││ │ │ │└───────────────────┴───────────────────┴───────────────────┘Stack windows share equal width. More windows means narrower columns.
Capabilities
Section titled “Capabilities”- Adjustable ratio: Yes - resize the main area
- Adjustable main count: Yes - put multiple windows in main
- Stateful: No
Configuration
Section titled “Configuration”spoon.Shoji:configure({ default_layout = "wide", main_ratio = 0.5, -- Main area gets 50% of screen height main_count = 1, -- One window in main area})Main ratio
Section titled “Main ratio”The main ratio controls how much vertical space the main area occupies. Bind hotkeys to adjust it dynamically:
spoon.Shoji:bindHotkeys({ increase_main_ratio = { { "ctrl", "alt" }, "=" }, -- Taller main decrease_main_ratio = { { "ctrl", "alt" }, "-" }, -- Shorter main})30% main ratio
Section titled “30% main ratio”┌───────────────────────────────────────────────────────────┐│ ││ ││ 1 ││ ││ │├─────────────────────────────┬─────────────────────────────┤│ │ ││ │ ││ │ ││ │ ││ │ ││ 2 │ 3 ││ │ ││ │ ││ │ ││ │ ││ │ │└─────────────────────────────┴─────────────────────────────┘70% main ratio
Section titled “70% main ratio”┌───────────────────────────────────────────────────────────┐│ ││ ││ ││ ││ ││ 1 ││ ││ ││ ││ ││ │├─────────────────────────────┬─────────────────────────────┤│ │ ││ │ ││ 2 │ 3 ││ │ ││ │ │└─────────────────────────────┴─────────────────────────────┘Multiple main windows
Section titled “Multiple main windows”Increase main_count to share the main area. With main_count = 2, main
windows sit side-by-side on top:
main_count = 2 (with 3 windows)
Section titled “main_count = 2 (with 3 windows)”┌─────────────────────────────┬─────────────────────────────┐│ │ ││ │ ││ │ ││ 1 │ 2 ││ │ ││ │ ││ │ ││ │ │├─────────────────────────────┴─────────────────────────────┤│ ││ ││ ││ 3 ││ ││ ││ ││ │└───────────────────────────────────────────────────────────┘When to use
Section titled “When to use”Wide layout shines on:
- Ultrawide monitors (21:9 or wider) with abundant horizontal pixels
- Laptop screens with limited vertical space
- Video editing and timeline-based workflows
- Horizontal content like spreadsheets or logs
Wide vs Tall
Section titled “Wide vs Tall”| Aspect | Wide | Tall |
|---|---|---|
| Main position | Top | Left |
| Stack direction | Horizontal | Vertical |
| Best for | Ultrawide, short screens | Standard, tall screens |
Mirrored wide
Section titled “Mirrored wide”Prefer the main window on the bottom? Use the Mirror modifier:
local Modifiers = require("layouts.modifiers")local Mirror = require("layouts.modifiers.mirror")local Wide = require("layouts.wide")
local wideBottom = Modifiers.wrap(Wide, Mirror.vertical(), { name = "wide-bottom", displayName = "Wide (Bottom)",})Mirrored result (3 windows)
Section titled “Mirrored result (3 windows)”┌─────────────────────────────┬─────────────────────────────┐│ │ ││ │ ││ │ ││ 2 │ 3 ││ │ ││ │ ││ │ ││ │ │├─────────────────────────────┴─────────────────────────────┤│ ││ ││ ││ 1 ││ ││ ││ ││ │└───────────────────────────────────────────────────────────┘