Customization
Bar Layout
Configure the positioning, modules, and behavior of your caffyne shell panel.
caffyne shell features a highly flexible, drag-and-drop panel system that allows you to arrange components dynamically or lock them via configuration profiles.
Panel Configuration
The layout configuration defines how widgets are aligned across the left, center, and right sections of your primary bar.
Layout Options
alignment
string
Defines the screen edge for the bar. Options include
top and bottom.left
array
A list of applets and widgets aligned to the left side of the panel.
center
array
A list of applets and widgets centered on the panel (ideal for clock/calendar).
right
array
A list of applets and widgets aligned to the right side (ideal for quick settings and system tray).
Example Configuration
You can manage your panel layout directly within your configuration tree:
config.json
"bars": [
{
"alignment": "bottom",
"floating_bar": true,
"floating_applets": true,
"rounded_edges": true,
"min_width": false,
"auto_hide": false,
"left": [
"Dash",
{
"widget": "Launcher",
"variant": "icon"
},
{
"widget": "Processes",
"variant": "scale"
},
"Weather",
"Media"
],
"center": [
"Dock"
],
"right": [
"Tray",
"Calendar",
{
"widget": "Clock",
"variant": "icon+label"
},
{
"widget": "Settings",
"variant": "single"
},
"Notifications"
]
}
]