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`
`HyprlandLayoutSwitcher`
`HyprlandWorkspaces`
`HyprPicker`
`Lock`
`Logout`
`Network`
`Notifications`
`PowerProfile`
`QuickSettings`
`Reboot`
`RecordingIndicator`
`Screenshot`
`Shutdown`
`Tray`
`VpnIndicator`
`Wallpaper`

BarWidgets

Field	Type	Default
`quick_settings`	`QuickSettingsBarWidget`	—

Bars

Field	Type	Default
`bottom_bar`	`HorizontalBar`	—
`frame`	`Frame`	—
`left_bar`	`VerticalBar`	—
`right_bar`	`VerticalBar`	—
`top_bar`	`HorizontalBar`	—
`widgets`	`BarWidgets`	—

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`
`reveal_by_default`	`boolean`	`true`
`right_widgets`	`Vec<BarWidget>`	`[]`

Icons

Field	Type	Default
`app_icon_theme`	`string`	`OkMaterial`
`apply_theme_filter`	`boolean`	`false`
`contrast_strength`	`number`	`1.0`
`filter_strength`	`number`	`1.0`
`monochrome_strength`	`number`	`0.0`
`shell_icon_theme`	`string`	`OkMaterial`

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`

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`	—
`ThemePicker`	—
`Wallpaper`	—
`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`
`popup_window_margins`	`integer`	`0`

Orientation

Variant
`Horizontal`
`Vertical`

Position

Variant
`Left`
`Right`
`Top`
`TopLeft`
`TopRight`
`Bottom`
`BottomLeft`
`BottomRight`

QuickActionWidget

Variant
`AirplaneMode`
`DoNotDisturb`
`HyprPicker`
`IdleInhibitor`
`Lock`
`Logout`
`Nightlight`
`Reboot`
`Settings`
`Shutdown`

QuickActionsConfig

Field	Type	Default
`widgets`	`Vec<QuickActionWidget>`	—

QuickSettingsBarWidget

Field	Type	Default
`icon`	`QuickSettingsIcon`	`Arch`

QuickSettingsIcon

Variant
`Arch`
`Nix`
`Fedora`
`Hyprland`

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
`attributes`	`ThemeAttributes`	—
`css_file`	`string`	``
`icons`	`Icons`	—
`matugen`	`Matugen`	—
`theme`	`Themes`	`Default`

ThemeAttributes

Field	Type	Default
`font`	`Font`	—
`sizing`	`Sizing`	—
`window_opacity`	`number`	`1.0`

Themes

Variant
`Default`
`Wallpaper`
`Bauhaus`
`BlackTurq`
`BloodRust`
`Boo`
`CatppuccinFrappe`
`CatppuccinLatte`
`CatppuccinMacchiato`
`CatppuccinMocha`
`CrimsonMoonlight`
`Cyberpunk`
`DesertPower`
`Dracula`
`Eldritch`
`Ethereal`
`EverforestDarkHard`
`EverforestDarkMedium`
`EverforestDarkSoft`
`EverforestLightHard`
`EverforestLightMedium`
`EverforestLightSoft`
`ForestStream`
`GruvboxDarkHard`
`GruvboxDarkMedium`
`GruvboxDarkSoft`
`GruvboxLightHard`
`GruvboxLightMedium`
`GruvboxLightSoft`
`Hackerman`
`InkyPinky`
`KanagawaDragon`
`KanagawaLotus`
`KanagawaWave`
`Miasma`
`MonokaiClassic`
`Nightfox`
`NordDark`
`NordLight`
`OceanicNext`
`OneDark`
`OsakaJade`
`Poimandres`
`Radioactive`
`Retro82`
`RosePine`
`RosePineDawn`
`RosePineMoon`
`Saga`
`Seoul`
`SolarizedDark`
`SolarizedLight`
`Solitude`
`SunsetCloud`
`Synthwave84`
`TokyoNight`
`TokyoNightStorm`
`TokyoNightLight`
`Varda`

VerticalBar

Field	Type	Default
`bottom_widgets`	`Vec<BarWidget>`	`[]`
`center_widgets`	`Vec<BarWidget>`	`[]`
`minimum_width`	`integer`	`0`
`reveal_by_default`	`boolean`	`true`
`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`	``

Configuration Schema ​

Config ​

BarWidget ​

BarWidgets ​

Bars ​

ContainerConfig ​

ContentFit ​

Font ​

Frame ​

General ​

HorizontalBar ​

Icons ​

LocationQueryConfig ​

Matugen ​

MatugenMode ​

MatugenPreference ​

MatugenType ​

Menu ​

MenuWidget ​

Menus ​

NotificationPosition ​

Notifications ​

Orientation ​

Position ​

QuickActionWidget ​

QuickActionsConfig ​

QuickSettingsBarWidget ​

QuickSettingsIcon ​

ScreenshareMenu ​

Sizing ​

SpacerConfig ​

TemperatureUnitConfig ​

Theme ​

ThemeAttributes ​

Themes ​

VerticalBar ​

VerticalMenuExpansion ​

Wallpaper ​

Configuration Schema

Config

BarWidget

BarWidgets

Bars

ContainerConfig

ContentFit

Font

Frame

General

HorizontalBar

Icons

LocationQueryConfig

Matugen

MatugenMode

MatugenPreference

MatugenType

Menu

MenuWidget

Menus

NotificationPosition

Notifications

Orientation

Position

QuickActionWidget

QuickActionsConfig

QuickSettingsBarWidget

QuickSettingsIcon

ScreenshareMenu

Sizing

SpacerConfig

TemperatureUnitConfig

Theme

ThemeAttributes

Themes

VerticalBar

VerticalMenuExpansion

Wallpaper