Custom-X Layout

custom-x is the most flexible layout in xfetch: every border line is a literal template you write in the custom_x config object. You decide the characters, the size, the internal separators, and even add extra lines — nothing is hardcoded.

Enabling

{
    "layout": "custom-x",
    "custom_x": {
        // ... your templates ...
    }
}

Templates and Placeholders

All border lines are strings (templates) that support two placeholders:

{fill} — repeats the fill character until the line reaches the box width. Templates without {fill} are extended with the fill character at the end; templates longer than the content define the box width.
{title} — replaced with the current group title (in group_title and top templates).

Options

Option	Default	Description
`top`	`╭─ {title}{fill}╮`	Top border template. Empty string disables it.
`bottom`	`╰{fill}╯`	Bottom border template. Empty string disables it.
`left`	`│`	Prefix for every content row (can be multiple characters).
`right`	`│`	Suffix for every content row.
`fill`	`─`	Character used by `{fill}` and to extend short templates.
`padding`	`1`	Spaces between the side borders and the content.
`width`	`"auto"`	`"auto"` sizes the box to the content; `"full"` stretches it to the end of the terminal line (accounting for the logo column, minus `full_margin`); a number sets a fixed width in columns.
`full_margin`	`2`	Cells left free at the right edge when `width: "full"` (avoids the terminal wrap column).
`group_title`	`── {title} ──`	Template rendered when a module group starts. Empty string hides group titles.
`divider`	(off)	Template rendered as an internal separator. Empty string disables it.
`divider_between`	`"groups"`	Where dividers appear: `"groups"` (between groups), `"modules"` (also between every module inside groups), or `"none"`.
`module_top`	(off)	Template rendered above every module row — wraps each module in its own box.
`module_bottom`	(off)	Template rendered below every module row.
`header_lines`	`[]`	Extra literal lines rendered after the top border (templates with placeholders allowed).
`footer_lines`	`[]`	Extra literal lines rendered before the bottom border.

Example

Everything inside one big frame, each group title boxed, and every module wrapped in its own box:

{
    "layout": "custom-x",
    "custom_x": {
        "top": "╔═══════ XFETCH ═══════{fill}╗",
        "bottom": "╚══════════════════════{fill}╝",
        "left": "║",
        "right": "║",
        "fill": "═",
        "padding": 1,
        "width": "full",
        "full_margin": 2,
        "group_title": "╭─── {title} ───{fill}╮",
        "module_top": "╠{fill}╣",
        "module_bottom": "╠{fill}╣",
        "divider_between": "none"
    },
    "modules": [
        { "type": "group", "title": "Hardware", "modules": ["cpu", "gpu"] },
        { "type": "group", "title": "Software", "modules": ["os", "kernel"] }
    ]
}

Result:

╔═══════ XFETCH ═════════════════════════╗
╭─── Hardware ───════════════════════════╮
╠════════════════════════════════════════╣
║   Apple M4 (10) @ 4.46 GHz           ║
╠════════════════════════════════════════╣
║  󰍹 Apple M4                           ║
╠════════════════════════════════════════╣
╭─── Software ───════════════════════════╮
╠════════════════════════════════════════╣
║   Darwin 26.5.2 aarch64              ║
╚════════════════════════════════════════╝

Section-Style Example (no boxes)

Group headers like hardware────── with ──── separators between groups, no outer frame:

{
    "layout": "custom-x",
    "custom_x": {
        "top": "",
        "bottom": "",
        "left": "",
        "right": "",
        "fill": "─",
        "padding": 0,
        "group_title": "{title}{fill}",
        "divider": "{fill}",
        "divider_between": "groups"
    }
}

Notes

Empty templates ("") are skipped entirely — no blank lines are produced.
With width: "full", the small-terminal content fallback is applied consistently with the classic layouts.
Nested groups render recursively (title lines and module rows inside the parent).
The box width is always at least the widest template/content line; shorter rows are padded inside the right border.

xfetch Layouts — built-in layouts