Configuration Schema
Config
| Field | Type | Default |
|---|---|---|
bars | Bars | — |
general | General | — |
menus | Menus | — |
notifications | Notifications | — |
theme | Theme | — |
wallpaper | Wallpaper | — |
BarWidget
| Variant |
|---|
AudioInput |
AudioOutput |
Battery |
Bluetooth |
Clipboard |
Clock |
HyprlandDock |
HyprlandWorkspaces |
HyprPicker |
Lock |
Logout |
Network |
Notifications |
PowerProfile |
QuickSettings |
Reboot |
RecordingIndicator |
Screenshot |
Shutdown |
Tray |
VpnIndicator |
Wallpaper |
Bars
| Field | Type | Default |
|---|---|---|
bottom_bar | HorizontalBar | — |
frame | Frame | — |
left_bar | VerticalBar | — |
right_bar | VerticalBar | — |
top_bar | HorizontalBar | — |
ContainerConfig
| Field | Type | Default |
|---|---|---|
minimum_width | integer | — |
orientation | Orientation | — |
spacing | integer | — |
widgets | Vec<MenuWidget> | — |
ContentFit
| Variant |
|---|
Contain |
Cover |
Fill |
ScaleDown |
Font
| Field | Type | Default |
|---|---|---|
primary | string | `` |
secondary | string | `` |
tertiary | string | `` |
Frame
| Field | Type | Default |
|---|---|---|
enable_frame | boolean | true |
monitor_filter | Vec<string> | [] |
General
| Field | Type | Default |
|---|---|---|
clock_format_24_h | boolean | false |
temperature_unit | TemperatureUnitConfig | Metric |
weather_location_query | LocationQueryConfig | — |
HorizontalBar
| Field | Type | Default |
|---|---|---|
center_widgets | Vec<BarWidget> | [] |
left_widgets | Vec<BarWidget> | [] |
minimum_height | integer | 0 |
right_widgets | Vec<BarWidget> | [] |
LocationQueryConfig
| Variant | Data |
|---|---|
Coordinates | lat: number, lon: number |
City | country: string, name: string |
Matugen
| Field | Type | Default |
|---|---|---|
contrast | number | 0.0 |
mode | MatugenMode | Dark |
preference | MatugenPreference | Darkness |
scheme_type | MatugenType | TonalSpot |
MatugenMode
| Variant |
|---|
Light |
Dark |
MatugenPreference
| Variant |
|---|
Darkness |
Lightness |
Saturation |
LessSaturation |
Value |
MatugenType
| Variant |
|---|
Content |
Expressive |
Fidelity |
FruitSalad |
Monochrome |
Neutral |
Rainbow |
TonalSpot |
Vibrant |
Menu
| Field | Type | Default |
|---|---|---|
minimum_width | integer | 410 |
position | Position | Left |
widgets | Vec<MenuWidget> | [] |
MenuWidget
| Variant | Data |
|---|---|
AppLauncher | — |
AudioInput | — |
AudioOutput | — |
Bluetooth | — |
Calendar | — |
Clipboard | — |
Clock | — |
Divider | — |
MediaPlayer | — |
Network | — |
Notifications | — |
PowerProfiles | — |
Screenshots | — |
ScreenRecording | — |
Wallpaper | — |
WallpaperDropdown | — |
Weather | — |
Container | ContainerConfig |
QuickActions | QuickActionsConfig |
Spacer | SpacerConfig |
Menus
| Field | Type | Default |
|---|---|---|
app_launcher_menu | Menu | — |
clipboard_menu | Menu | — |
clock_menu | Menu | — |
left_menu_expansion_type | VerticalMenuExpansion | AlwaysExpanded |
notification_menu | Menu | — |
quick_settings_menu | Menu | — |
right_menu_expansion_type | VerticalMenuExpansion | AlwaysExpanded |
screenshare_menu | ScreenshareMenu | — |
screenshot_menu | Menu | — |
wallpaper_menu | Menu | — |
NotificationPosition
| Variant |
|---|
Left |
Right |
Center |
Notifications
| Field | Type | Default |
|---|---|---|
notification_position | NotificationPosition | Right |
Orientation
| Variant |
|---|
Horizontal |
Vertical |
Position
| Variant |
|---|
Left |
Right |
Top |
TopLeft |
TopRight |
Bottom |
BottomLeft |
BottomRight |
QuickActionWidget
| Variant |
|---|
AirplaneMode |
DoNotDisturb |
HyprPicker |
Lock |
Logout |
Nightlight |
Reboot |
Settings |
Shutdown |
QuickActionsConfig
| Field | Type | Default |
|---|---|---|
widgets | Vec<QuickActionWidget> | — |
ScreenshareMenu
| Field | Type | Default |
|---|---|---|
position | Position | Left |
Sizing
| Field | Type | Default |
|---|---|---|
border_width | integer | 2 |
radius_widget | integer | 8 |
radius_window | integer | 8 |
SpacerConfig
| Field | Type | Default |
|---|---|---|
size | integer | — |
TemperatureUnitConfig
| Variant |
|---|
Metric |
Imperial |
Theme
| Field | Type | Default |
|---|---|---|
app_icon_theme | string | OkMaterial |
attributes | ThemeAttributes | — |
css_file | string | `` |
matugen | Matugen | — |
shell_icon_theme | string | OkMaterial |
theme | Themes | Default |
ThemeAttributes
| Field | Type | Default |
|---|---|---|
font | Font | — |
sizing | Sizing | — |
window_opacity | number | 1.0 |
Themes
| Variant |
|---|
Default |
Wallpaper |
BloodRust |
CatppuccinFrappe |
CatppuccinLatte |
CatppuccinMacchiato |
CatppuccinMocha |
DesertPower |
Dracula |
EverforestDarkHard |
EverforestDarkMedium |
EverforestDarkSoft |
EverforestLightHard |
EverforestLightMedium |
EverforestLightSoft |
GruvboxDarkHard |
GruvboxDarkMedium |
GruvboxDarkSoft |
GruvboxLightHard |
GruvboxLightMedium |
GruvboxLightSoft |
KanagawaDragon |
KanagawaLotus |
KanagawaWave |
NordDark |
NordLight |
OneDark |
Poimandres |
RosePine |
RosePineDawn |
RosePineMoon |
SolarizedDark |
SolarizedLight |
TokyoNight |
TokyoNightStorm |
TokyoNightLight |
Varda |
VerticalBar
| Field | Type | Default |
|---|---|---|
bottom_widgets | Vec<BarWidget> | [] |
center_widgets | Vec<BarWidget> | [] |
minimum_width | integer | 0 |
top_widgets | Vec<BarWidget> | [] |
VerticalMenuExpansion
| Variant |
|---|
AlwaysExpanded |
ExpandBothWays |
ExpandUp |
ExpandDown |
Wallpaper
| Field | Type | Default |
|---|---|---|
apply_theme_filter | boolean | false |
content_fit | ContentFit | Cover |
theme_filter_strength | number | 1.0 |
wallpaper_dir | string | `` |