Configuration Schema
Here you will find the definitions of all available configurations
Config values
| Name | Type | Default | Description |
|---|---|---|---|
| icon | icon | | Icon (glyph) representing this config file. |
| iconOffset | number | 0 | Icon offset (‑10 … 10). |
| configUpdateScript | string | Absolute path to the script run when the config changes where you can update the theme and configuration for the rest of your system. Theme name and config file name are sent as arguments to the script. | |
| wallpaperUpdateScript | string | Absolute path to the script run when the wallpaper changes. You are responsible for changing you wallpaper. Wallpaper path is sent as an argument to the script. | |
| barUpdateScript | string | Absolute path to the script run when the bar changes. Bar type is sent as an argument to the script. | |
| wallpaperDir | string | Directory containing theme wallpapers (may be empty). | |
| mainMonitor | number | 0 | Index of the primary monitor (0‑based as reported by Hyprland). |
| sounds | object | Global sound configs. | |
| notifications | object | Notification pop‑up behaviour. | |
| systemCommands | object | Shell commands executed by power options. | |
| theme | object | Global theme definitions. | |
| systemMenu | object | System menu configurations. | |
| horizontalBar | object | Configuration for a horizontal (top/bottom) bar layout. | |
| verticalBar | object | Configuration for a vertical (left/right) bar layout. |
sounds
| Name | Type | Default | Description |
|---|---|---|---|
| playVolumeChangingSound | boolean | true | Whether or not to play a sound when changing volume |
| volumeChangingSoundPath | string | Full path to a sound file that will be used for volume changes | |
| playScreenshotSound | boolean | true | Whether or not to play a sound when taking a screenshot |
| screenshotSoundPath | string | Full path to a sound file that will be used for screenshots | |
| playLowBatteryWarningSound | boolean | true | Whether or not to play a sound when the battery is low |
| lowBatteryWarningSoundPath | string | Full path to a sound file that will be used for low battery warnings | |
| playChargingSound | boolean | true | Whether or not to play a sound when charging the battery |
| chargingPlugInSoundPath | string | Full path to a sound file that will be used for starting battery charging | |
| chargingUnplugSoundPath | string | Full path to a sound file that will be used for stopping battery charging |
notifications
| Name | Type | Default | Description |
|---|---|---|---|
| position | enum (left, right, center) | right | Screen edge where notification bubbles appear. |
| respectExclusive | boolean | true | Whether to avoid overlaying exclusive zones declared by widgets. |
systemCommands
| Name | Type | Default | Description |
|---|---|---|---|
| logout | string | uwsm stop | Command to log the current user out. |
| logoutConfirmationEnabled | boolean | true | Enable a confirmation dialog when logging out. |
| lock | string | uwsm app -- hyprlock | Command to lock the screen. |
| lockConfirmationEnabled | boolean | false | Enable a confirmation dialog when locking the screen. |
| restart | string | systemctl reboot | Command to reboot the machine. |
| restartConfirmationEnabled | boolean | true | Enable a confirmation dialog when restarting the computer. |
| shutdown | string | systemctl poweroff | Command to shut down the machine safely. |
| shutdownConfirmationEnabled | boolean | true | Enable a confirmation dialog when shutting the computer down. |
theme
| Name | Type | Default | Description |
|---|---|---|---|
| name | string | myTheme | Theme name. Passed as the first argument to the configUpdateScript when changing configs. |
| buttonBorderRadius | number | 8 | Border radius (px) used by regular buttons. |
| largeButtonBorderRadius | number | 16 | Border radius (px) used by large buttons. |
| font | string | JetBrainsMono NF | Default font family used across the panel widgets. |
| nightLightTemperature | number | 5000 | The temperature of the night light. |
| colors | object | Palette used by widgets & windows. | |
| bars | object | Theming configurations for the bars. | |
| windows | object | Global window styling defaults. | |
| systemMenu | object | System menu theme configurations. |
theme.colors
| Name | Type | Default | Description |
|---|---|---|---|
| background | color | #1F2932 | Background color |
| foreground | color | #AFB3BD | Foreground color |
| primary | color | #7C545F | Primary / accent color |
| buttonPrimary | color | #7C545F | Button color |
| warning | color | #7C7C54 | Warning color |
| alertBorder | color | #7C545F | Color of alert borders (OSD) |
| scrimColor | color | #00000001 | Color used for translucent overlays (RGBA hex). |
theme.bars
| Name | Type | Default | Description |
|---|---|---|---|
| borderRadius | number | 8 | Corner radius (px) for bars. |
| borderWidth | number | 2 | Bar border width (px). |
| borderColor | color | Inherits from: theme.colors.primary | Color of the bar border |
| backgroundColor | color | Inherits from: theme.colors.background | Color of the bar background |
| widgetForeground | color | Inherits from: theme.colors.foreground | Foreground color of the bar widgets. |
| widgetBackground | color | Inherits from: theme.colors.background | Background color of the bar widgets. |
| widgetBorderRadius | number | 8 | Corner radius (px) for bar widgets. |
| widgetBorderWidth | number | 0 | Widget border width (px). |
| widgetBorderColor | color | Inherits from: theme.colors.primary | Color of the widget borders |
| menu | object | Theme configuration for the menu bar widget. | |
| workspaces | object | Configuration for the workspaces bar widget. | |
| clock | object | Configuration for the clock bar widget. | |
| audio_out | object | Configuration for the audio_out bar widget. | |
| audio_in | object | Configuration for the audio_in bar widget. | |
| bluetooth | object | Configuration for the bluetooth bar widget. | |
| network | object | Configuration for the network bar widget. | |
| recording_indicator | object | Configuration for the recording_indicator bar widget. | |
| vpn_indicator | object | Configuration for the vpn_indicator bar widget. | |
| battery | object | Configuration for the battery bar widget. | |
| tray | object | Configuration for the tray bar widget. | |
| app_launcher | object | Configuration for the app_launcher bar widget. | |
| screenshot | object | Configuration for the screenshot bar widget. | |
| clipboard_manager | object | Configuration for the clipboard_manager bar widget. | |
| power_profile | object | Configuration for the power_profile bar widget. | |
| cava_waveform | object | Configuration for the cava_waveform bar widget. | |
| mpris_controls | object | Configuration for the mpris_controls bar widget. | |
| mpris_track_info | object | Configuration for the mpris_track_info bar widget. | |
| mpris_primary_player_switcher | object | Configuration for the mpris_primary_player_switcher bar widget. | |
| notification_history | object | Configuration for the notification_history bar widget. | |
| color_picker | object | Configuration for the color_picker bar widget. | |
| logout | object | Configuration for the logout bar widget. | |
| lock | object | Configuration for the lock bar widget. | |
| restart | object | Configuration for the restart bar widget. | |
| shutdown | object | Configuration for the shutdown bar widget. |
theme.bars.menu
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
| icon | icon | | Icon shown on the menu button (ex: Nerd Font glyph). |
| iconOffset | number | 1 | Offset of the menu button icon. Use this if the icon is not centered properly |
theme.bars.workspaces
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
| largeActive | boolean | false | Make the active workspace icon larger |
| activeIcon | icon | | Icon of the active workspace |
| activeOffset | number | 1 | Offset of the active workspace icon. Use this if the icon is not centered properly |
| inactiveIcon | icon | | Icon of the inactive workspace |
| inactiveOffset | number | 1 | Offset of the active workspace icon. Use this if the icon is not centered properly |
| inactiveForeground | color | Inherits from: theme.bars.workspaces.foreground | Foreground color of inactive workspaces. |
theme.bars.clock
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.audio_out
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.audio_in
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.bluetooth
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.network
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.recording_indicator
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.colors.warning | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.vpn_indicator
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.battery
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.tray
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.app_launcher
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.screenshot
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.clipboard_manager
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.power_profile
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.cava_waveform
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.mpris_controls
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.mpris_track_info
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.mpris_primary_player_switcher
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.notification_history
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.color_picker
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.logout
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.lock
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.restart
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.bars.shutdown
| Name | Type | Default | Description |
|---|---|---|---|
| foreground | color | Inherits from: theme.bars.widgetForeground | Foreground color of the widget. |
| background | color | Inherits from: theme.bars.widgetBackground | Background color of the widget. |
| borderRadius | number | Inherits from: theme.bars.widgetBorderRadius | Corner radius (px) for the widget. |
| borderWidth | number | Inherits from: theme.bars.widgetBorderWidth | Widget border width (px). |
| borderColor | color | Inherits from: theme.bars.widgetBorderColor | Color of the widget border |
theme.windows
| Name | Type | Default | Description |
|---|---|---|---|
| gaps | number | 5 | Gap (px) between windows. |
| borderRadius | number | 8 | Corner radius (px) for client‑side decorations. |
| borderWidth | number | 2 | Window border width (px). |
| backgroundColor | color | Inherits from: theme.colors.background | Color of window backgrounds |
| borderColor | color | Inherits from: theme.colors.foreground | Color of window borders |
theme.systemMenu
| Name | Type | Default | Description |
|---|---|---|---|
| clock | object | Theme configurations for the system menu clock. |
theme.systemMenu.clock
| Name | Type | Default | Description |
|---|---|---|---|
| dayAllCaps | boolean | false | If the week day name text should be in all caps |
| dayFont | string | Inherits from: theme.font | Font used for the week day name |
systemMenu
| Name | Type | Default | Description |
|---|---|---|---|
| widgets | enum[(network, bluetooth, audio_out, audio_in, power_profile, look_and_feel, mpris_players, power_options, notification_history, toolbox, clock, clipboard_manager, screen_recording_controls, weather)] | [clock, network, bluetooth, audio_out, audio_in, toolbox, look_and_feel, screen_recording_controls, mpris_players, power_options, notification_history] | Widgets inside the system menu |
| weather | object | Configuration for the menu bar widget. |
systemMenu.weather
| Name | Type | Default | Description |
|---|---|---|---|
| latitude | string | 0.0 | Latitude coordinate for weather location |
| longitude | string | 0.0 | Longitude coordinate for weather location |
| temperatureUnit | enum (fahrenheit, celsius) | fahrenheit | Temperature unit |
| speedUnit | enum (mph, kph) | mph | Speed unit |
horizontalBar
| Name | Type | Default | Description |
|---|---|---|---|
| leftWidgets | enum[(menu, workspaces, clock, audio_out, audio_in, bluetooth, network, recording_indicator, vpn_indicator, battery, tray, app_launcher, screenshot, clipboard_manager, power_profile, cava_waveform, mpris_controls, mpris_track_info, mpris_primary_player_switcher, notification_history, color_picker, logout, lock, restart, shutdown)] | [menu, workspaces] | Widgets anchored left. |
| centerWidgets | enum[(menu, workspaces, clock, audio_out, audio_in, bluetooth, network, recording_indicator, vpn_indicator, battery, tray, app_launcher, screenshot, clipboard_manager, power_profile, cava_waveform, mpris_controls, mpris_track_info, mpris_primary_player_switcher, notification_history, color_picker, logout, lock, restart, shutdown)] | [cava_waveform, mpris_primary_player_switcher, mpris_controls, mpris_track_info] | Widgets centered horizontally. |
| rightWidgets | enum[(menu, workspaces, clock, audio_out, audio_in, bluetooth, network, recording_indicator, vpn_indicator, battery, tray, app_launcher, screenshot, clipboard_manager, power_profile, cava_waveform, mpris_controls, mpris_track_info, mpris_primary_player_switcher, notification_history, color_picker, logout, lock, restart, shutdown)] | [recording_indicator, tray, clipboard_manager, audio_out, audio_in, bluetooth, vpn_indicator, network, battery, clock] | Widgets anchored right. |
| minimumWidth | number | 800 | Minimum bar width if not expanded. |
| compact | boolean | false | Enabled compact bar mode. |
| expanded | boolean | true | If true, the bar stretches to the full monitor width. |
| splitSections | boolean | false | If true, left/center/right widgets are rendered separately with padding. |
| sectionPadding | number | 0 | Padding (px) around each section when splitSections = true. |
| widgetSpacing | number | 0 | Spacing (px) between widgets inside the bar. |
| marginInner | number | 5 | Margin (px) between the bar and other windows. |
| marginOuter | number | 5 | Margin (px) between the bar and the edge of the screen. |
| marginStart | number | 5 | Margin (px) at the start of the bar. (For the vertical bar, this is the top) |
| marginEnd | number | 5 | Margin (px) at the end of the bar. (For the vertical bar, this is the bottom) |
| fullBarCavaWaveform | object | Full bar cava waveform configurations. | |
| menu | object | Configuration for the menu bar widget. | |
| workspaces | object | Configuration for the workspaces bar widget. | |
| clock | object | Configuration for the clock bar widget. | |
| audio_out | object | Configuration for the audio_out bar widget. | |
| audio_in | object | Configuration for the audio_in bar widget. | |
| bluetooth | object | Configuration for the bluetooth bar widget. | |
| network | object | Configuration for the network bar widget. | |
| recording_indicator | object | Configuration for the recording_indicator bar widget. | |
| vpn_indicator | object | Configuration for the vpn_indicator bar widget. | |
| battery | object | Configuration for the battery bar widget. | |
| tray | object | Configuration for the tray bar widget. | |
| app_launcher | object | Configuration for the app_launcher bar widget. | |
| screenshot | object | Configuration for the screenshot bar widget. | |
| clipboard_manager | object | Configuration for the clipboard_manager bar widget. | |
| power_profile | object | Configuration for the power_profile bar widget. | |
| cava_waveform | object | Configuration for the cava_waveform bar widget. | |
| mpris_controls | object | Configuration for the mpris_controls bar widget. | |
| mpris_track_info | object | Configuration for the mpris_track_info bar widget. | |
| mpris_primary_player_switcher | object | Configuration for the mpris_primary_player_switcher bar widget. | |
| notification_history | object | Configuration for the notification_history bar widget. | |
| color_picker | object | Configuration for the color_picker bar widget. | |
| logout | object | Configuration for the logout bar widget. | |
| lock | object | Configuration for the lock bar widget. | |
| restart | object | Configuration for the restart bar widget. | |
| shutdown | object | Configuration for the shutdown bar widget. |
horizontalBar.fullBarCavaWaveform
| Name | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | false | Shows a cava waveform stretching across the entire bar, underneath other widgets. Does not show when split sections are enabled. |
| intensityMultiplier | number | 1 | Makes the waves bigger or smaller. |
horizontalBar.menu
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.workspaces
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.clock
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.audio_out
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.audio_in
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.bluetooth
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.network
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.recording_indicator
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.vpn_indicator
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.battery
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.tray
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
| collapsable | boolean | true | If true, a tray icon will show and need to be clicked to reveal the tray apps. |
horizontalBar.app_launcher
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.screenshot
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.clipboard_manager
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.power_profile
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.cava_waveform
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
| length | number | 200 | Length of the cava waveform. This has no effect on the full bar waveform. |
| expanded | boolean | false | Expands the waveform to fill the empty space. This can expand beyond the set length. This has no effect on the full bar waveform. |
| position | enum (inner, outer, start, end) | end | The base position of the waveform |
| intensityMultiplier | number | 1 | Makes the waves bigger or smaller. |
horizontalBar.mpris_controls
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.mpris_track_info
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 10 | Margin at the start of the widget. |
| marginEnd | number | 10 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
| textLength | number | 30 | The max number of characters to display. |
| textAlignment | enum (start, center, end) | start | How to align the text. |
| minimumLength | number | 300 | The minimum length of the widget. |
horizontalBar.mpris_primary_player_switcher
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.notification_history
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.color_picker
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.logout
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.lock
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.restart
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
horizontalBar.shutdown
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar
| Name | Type | Default | Description |
|---|---|---|---|
| topWidgets | enum[(menu, workspaces, clock, audio_out, audio_in, bluetooth, network, recording_indicator, vpn_indicator, battery, tray, app_launcher, screenshot, clipboard_manager, power_profile, cava_waveform, mpris_controls, mpris_track_info, mpris_primary_player_switcher, notification_history, color_picker, logout, lock, restart, shutdown)] | [menu, workspaces] | Widgets anchored at the top. |
| centerWidgets | enum[(menu, workspaces, clock, audio_out, audio_in, bluetooth, network, recording_indicator, vpn_indicator, battery, tray, app_launcher, screenshot, clipboard_manager, power_profile, cava_waveform, mpris_controls, mpris_track_info, mpris_primary_player_switcher, notification_history, color_picker, logout, lock, restart, shutdown)] | [mpris_track_info, mpris_controls, mpris_primary_player_switcher, cava_waveform] | Widgets centered vertically. |
| bottomWidgets | enum[(menu, workspaces, clock, audio_out, audio_in, bluetooth, network, recording_indicator, vpn_indicator, battery, tray, app_launcher, screenshot, clipboard_manager, power_profile, cava_waveform, mpris_controls, mpris_track_info, mpris_primary_player_switcher, notification_history, color_picker, logout, lock, restart, shutdown)] | [recording_indicator, tray, clipboard_manager, audio_out, audio_in, bluetooth, vpn_indicator, network, battery, clock] | Widgets anchored at the bottom. |
| integratedMenu | boolean | false | If true, the menu will be integrated into the bar. |
| minimumHeight | number | 600 | Minimum bar height if not expanded. |
| compact | boolean | false | Enabled compact bar mode. |
| expanded | boolean | true | If true, the bar stretches to the full monitor width. |
| splitSections | boolean | false | If true, left/center/right widgets are rendered separately with padding. |
| sectionPadding | number | 0 | Padding (px) around each section when splitSections = true. |
| widgetSpacing | number | 0 | Spacing (px) between widgets inside the bar. |
| marginInner | number | 5 | Margin (px) between the bar and other windows. |
| marginOuter | number | 5 | Margin (px) between the bar and the edge of the screen. |
| marginStart | number | 5 | Margin (px) at the start of the bar. (For the vertical bar, this is the top) |
| marginEnd | number | 5 | Margin (px) at the end of the bar. (For the vertical bar, this is the bottom) |
| fullBarCavaWaveform | object | Full bar cava waveform configurations. | |
| menu | object | Configuration for the menu bar widget. | |
| workspaces | object | Configuration for the workspaces bar widget. | |
| clock | object | Configuration for the clock bar widget. | |
| audio_out | object | Configuration for the audio_out bar widget. | |
| audio_in | object | Configuration for the audio_in bar widget. | |
| bluetooth | object | Configuration for the bluetooth bar widget. | |
| network | object | Configuration for the network bar widget. | |
| recording_indicator | object | Configuration for the recording_indicator bar widget. | |
| vpn_indicator | object | Configuration for the vpn_indicator bar widget. | |
| battery | object | Configuration for the battery bar widget. | |
| tray | object | Configuration for the tray bar widget. | |
| app_launcher | object | Configuration for the app_launcher bar widget. | |
| screenshot | object | Configuration for the screenshot bar widget. | |
| clipboard_manager | object | Configuration for the clipboard_manager bar widget. | |
| power_profile | object | Configuration for the power_profile bar widget. | |
| cava_waveform | object | Configuration for the cava_waveform bar widget. | |
| mpris_controls | object | Configuration for the mpris_controls bar widget. | |
| mpris_track_info | object | Configuration for the mpris_track_info bar widget. | |
| mpris_primary_player_switcher | object | Configuration for the mpris_primary_player_switcher bar widget. | |
| notification_history | object | Configuration for the notification_history bar widget. | |
| color_picker | object | Configuration for the color_picker bar widget. | |
| logout | object | Configuration for the logout bar widget. | |
| lock | object | Configuration for the lock bar widget. | |
| restart | object | Configuration for the restart bar widget. | |
| shutdown | object | Configuration for the shutdown bar widget. |
verticalBar.fullBarCavaWaveform
| Name | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | false | Shows a cava waveform stretching across the entire bar, underneath other widgets. Does not show when split sections are enabled. |
| intensityMultiplier | number | 1 | Makes the waves bigger or smaller. |
verticalBar.menu
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.workspaces
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.clock
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.audio_out
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.audio_in
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.bluetooth
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.network
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.recording_indicator
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.vpn_indicator
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.battery
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.tray
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
| collapsable | boolean | true | If true, a tray icon will show and need to be clicked to reveal the tray apps. |
verticalBar.app_launcher
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.screenshot
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.clipboard_manager
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.power_profile
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.cava_waveform
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
| length | number | 200 | Length of the cava waveform. This has no effect on the full bar waveform. |
| expanded | boolean | false | Expands the waveform to fill the empty space. This can expand beyond the set length. This has no effect on the full bar waveform. |
| position | enum (inner, outer, start, end) | outer | The base position of the waveform |
| intensityMultiplier | number | 1 | Makes the waves bigger or smaller. |
verticalBar.mpris_controls
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.mpris_track_info
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 10 | Margin at the top of the widget. |
| marginBottom | number | 10 | Margin at the bottom of the widget. |
| textLength | number | 30 | The max number of characters to display. |
| textAlignment | enum (start, center, end) | end | How to align the text. |
| minimumLength | number | 300 | The minimum length of the widget. |
verticalBar.mpris_primary_player_switcher
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.notification_history
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.color_picker
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.logout
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.lock
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.restart
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |
verticalBar.shutdown
| Name | Type | Default | Description |
|---|---|---|---|
| marginStart | number | 0 | Margin at the start of the widget. |
| marginEnd | number | 0 | Margin at the end of the widget. |
| marginTop | number | 0 | Margin at the top of the widget. |
| marginBottom | number | 0 | Margin at the bottom of the widget. |