Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -182,7 +182,7 @@ Config is stored at `~/.config/docking/dock.json` (auto-created on first run). N
| `zoom_range` | 3 | Icon widths over which zoom tapers off |
| `position` | bottom | Dock edge: bottom, top, left, right |
| `monitor_index` | -1 | Target monitor index (`-1` = primary monitor, `0..N` = specific monitor) |
| `hide_mode` | none | Dock hide behavior: `none`, `autohide`, `intelligent`, `dodge-active`, `window-dodge`, `dodge-maximized` |
| `hide_mode` | none | Dock hide behavior: `none`, `always-on-top`, `autohide`, `intelligent`, `dodge-active`, `window-dodge`, `dodge-maximized` |
| `hide_delay_ms` | 0 | Delay before hiding starts (0 = instant) |
| `unhide_delay_ms` | 0 | Delay before showing the dock again |
| `hide_time_ms` | 250 | Duration of hide/show slide animation |
Expand All @@ -206,6 +206,7 @@ Config is stored at `~/.config/docking/dock.json` (auto-created on first run). N
`hide_mode` meanings:

- `none`: Dock stays visible and reserves screen space.
- `always-on-top`: Dock stays visible above all windows without reserving screen space.
- `autohide`: Dock hides when the cursor leaves.
- `intelligent`: Dock hides when a window from the focused app overlaps the dock.
- `dodge-active`: Dock hides when the focused window overlaps the dock.
Expand Down
6 changes: 5 additions & 1 deletion docking/core/config.py
Original file line number Diff line number Diff line change
Expand Up @@ -271,7 +271,10 @@ class HideMode(str, Enum):

Mode Behavior
────────────── ──────────────────────────────────────────────────────
NONE Never hides, reserves struts for window managers.
NONE Never hides, reserves struts so maximized windows
avoid the dock area.
ALWAYS_ON_TOP Never hides, but does not reserve struts — maximized
windows fill the full screen and the dock floats above.
AUTOHIDE Hides when the mouse leaves the dock area.
INTELLIGENT Hides when any window from the active app overlaps
the dock (matched by WM_CLASS).
Expand All @@ -291,6 +294,7 @@ class HideMode(str, Enum):
"""

NONE = "none"
ALWAYS_ON_TOP = "always-on-top"
AUTOHIDE = "autohide"
INTELLIGENT = "intelligent"
DODGE_ACTIVE = "dodge-active"
Expand Down
Loading
Loading