Something went wrong. Try again.
A Quickshell workspace overview for Hyprland.
Something went wrong. Try again.
Configuration Examples #
Examples for the two runtime JSON files generated/used by Overzicht.
settings.json #
Path: ~/.config/overzicht/settings.json
{
"appearance": {
"font": {
"family": {
// Primary UI font family used by generic text widgets.
"main": "sans-serif",
// Reserved title font family override; currently exposed through Appearance but not used by shipped widgets.
"title": "sans-serif",
// Expressive font family used for large workspace numbers in the overview.
"expressive": "sans-serif"
},
"pixelSize": {
// Smallest text size, used by compact overview window labels and tooltips.
"smaller": 12,
// Default text size used by StyledText across the UI.
"small": 15,
// Reserved normal text size; available through Appearance but not directly used by current overview widgets.
"normal": 16,
// Reserved larger text size; available through Appearance but not directly used by current overview widgets.
"larger": 19,
// Reserved huge text size; available through Appearance but not directly used by current overview widgets.
"huge": 22
}
},
"animation": {
"duration": {
// Duration for the main spatial movement animation profile.
"elementMove": 500,
// Duration for overview window enter/move/resize transitions.
"elementMoveEnter": 400,
// Duration for faster UI motions such as tooltip and focus-indicator movement.
"elementMoveFast": 200
}
},
"rounding": {
// Radius for overview panel, workspace tiles, wallpaper masks, and active workspace indicator.
// Set to 0 for a fully square UI.
"screenRounding": 23,
// Radius for individual window preview masks and overlays.
// Set to 0 for square window previews.
"windowRounding": 18
},
"sizes": {
// Extra outer margin used to make room for the overview shadow/elevation effect.
"elevationMargin": 10
}
},
"overview": {
// Number of workspace rows shown in each overview page and used for keyboard navigation.
"rows": 2,
// Number of workspace columns shown in each overview page and used for keyboard navigation.
"columns": 4,
// Scale factor applied to each monitor when drawing workspace thumbnails.
"scale": 0.12,
// Master switch for loading the overview widget when the overlay opens.
"enable": true,
// Hides rows that have no windows and are not the active workspace row.
"hideEmptyRows": false,
// Closes the overview when clicking outside it or when the focus grab is cleared.
"closeOnFocusLoss": true,
// Enables per-monitor workspace offsets from workspaceMap when grouping workspaces.
"useWorkspaceMap": false,
// Monitor-id keyed workspace start offsets used when useWorkspaceMap is enabled.
"workspaceMap": [],
// Reverses workspace columns so visual ordering runs right-to-left.
"orderRightLeft": false,
// Reverses workspace rows so visual ordering runs bottom-to-top.
"orderBottomUp": false,
// Enables screencopy window previews inside workspace thumbnails.
"previewsEnabled": true,
// Preview capture mode: "live" keeps previews streaming, "event"/"snapshot" only refreshes on selected window events.
"previewMode": "live",
// Allows previews for windows on other monitors instead of dimming them without capture.
"includeInactiveMonitorPreviews": true,
// Delay before re-enabling capture after an event-driven preview refresh.
"previewRecaptureDelayMs": 60,
// Wallpaper shown inside empty workspaces; accepts absolute paths and URL-style sources.
"emptyWorkspaceWallpaper": "",
"effects": {
// Shows a fullscreen black backdrop behind the overview overlay.
"enableBackdrop": false,
// Opacity of the fullscreen backdrop when enableBackdrop is on.
"backdropOpacity": 0.28,
// Opacity of the main overview panel background and border.
"panelOpacity": 0.92,
// Opacity of each workspace tile fill/overlay.
"workspaceOpacity": 0.86,
// Opacity of the color overlay drawn on top of empty workspace wallpaper images.
"emptyWorkspaceWallpaperOverlayOpacity": 0.18,
// Opacity of the overlay tint drawn on top of each window preview.
"windowOverlayOpacity": 0.22
},
// Gap between workspace cells in the overview grid.
"workspaceSpacing": 5,
// Inner padding between the overview panel border and the workspace grid.
"backgroundPadding": 10,
// Base font size for workspace numbers before monitor scale and overview scale are applied.
"workspaceNumberBaseSize": 250,
// Renders workspace index labels as roman numerals instead of arabic numerals.
"romanNumerals": false
},
"windowPreview": {
// Show application icons centered over window previews.
"showIcons": true,
// Icon size ratio for normal window previews.
"iconToWindowRatio": 0.25,
// Larger icon size ratio used when a preview is too small for the normal layout.
"iconToWindowRatioCompact": 0.45,
// Reserved XWayland indicator ratio; exposed in config but not currently rendered.
"xwaylandIndicatorToIconRatio": 0.35,
// Opacity applied to preview windows that belong to a different monitor than the current overview panel.
"inactiveMonitorOpacity": 0.4,
// Crop full-screen previews to fill the workspace tile. When false, the full preview remains visible with possible padding bars.
"cropToFill": false,
// Keep one tooltip visible and animate it between hovered windows. Set false to use the original per-window popup behavior.
"smoothTooltipMovement": true,
"tooltipAnimations": {
"expandCollapse": {
// Animate tooltip expansion when shown and collapse when hidden.
"enable": true
},
"fade": {
// Fade tooltips in and out.
"enable": true,
// Duration of the fade animation in milliseconds.
"duration": 200
}
}
},
"hacks": {
// Small delay used before focus grabs and some window-position recalculations to avoid timing issues.
"arbitraryRaceConditionDelay": 150,
// Debounce window/workspace/monitor refreshes triggered by Hyprland events.
"hyprlandEventDebounceMs": 40
}
}
colors.json #
Path: ~/.config/overzicht/colors.json
{
// Active workspace accent.
"accent": "#b8bb26",
// Subtle border source mixed with the panel color.
"border": "#665c54",
// Window preview border source.
"outline": "#fbf1c7",
// Overview panel background and default text.
"panel": "#3c3836",
"panelText": "#ebdbb2",
// Drop-shadow source color.
"shadow": "#282828",
// Tooltip background and text. The border derives from tooltipText.
"tooltip": "#504945",
"tooltipText": "#fbf1c7",
// Window overlay background and interaction-state foreground.
"window": "#b8bb26",
"windowText": "#282828",
// Workspace tile background and number color.
"workspace": "#282828",
"workspaceText": "#fbf1c7"
}