{"id":27070300,"url":"https://github.com/lotos-linux/hypr-dock","last_synced_at":"2026-03-08T13:01:11.270Z","repository":{"id":240935846,"uuid":"803836942","full_name":"lotos-linux/hypr-dock","owner":"lotos-linux","description":"Interactive dock-panel for Hyprland","archived":false,"fork":false,"pushed_at":"2025-04-04T16:59:28.000Z","size":13230,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-04-04T17:32:38.549Z","etag":null,"topics":["compositor","desktop-environment","dock","dock-menu","dock-panel","golang","gtk-layer-shell","gtk3","gui","hackable","hyprctl","hyprland","launcher","linux","panel","productivity","ricing","tiling-wm","wayland"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lotos-linux.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-21T13:20:52.000Z","updated_at":"2025-04-04T16:59:32.000Z","dependencies_parsed_at":"2024-05-31T10:39:49.689Z","dependency_job_id":"063dd8fa-8ccc-4f85-8a94-65aff6d53dce","html_url":"https://github.com/lotos-linux/hypr-dock","commit_stats":null,"previous_names":["lotos-linux/inclayer-go","lotos-linux/hypr-dock"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lotos-linux%2Fhypr-dock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lotos-linux%2Fhypr-dock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lotos-linux%2Fhypr-dock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lotos-linux%2Fhypr-dock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lotos-linux","download_url":"https://codeload.github.com/lotos-linux/hypr-dock/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247407351,"owners_count":20934018,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["compositor","desktop-environment","dock","dock-menu","dock-panel","golang","gtk-layer-shell","gtk3","gui","hackable","hyprctl","hyprland","launcher","linux","panel","productivity","ricing","tiling-wm","wayland"],"created_at":"2025-04-05T22:20:46.541Z","updated_at":"2026-03-08T13:01:11.260Z","avatar_url":"https://github.com/lotos-linux.png","language":"Go","funding_links":[],"categories":["Tools"],"sub_categories":["Status Bar/Shell"],"readme":"# hypr-dock\n### Interactive dock panel for Hyprland\n\nTranslations: [`Русский`](README_RU.md)\n\n\u003cimg width=\"1360\" height=\"768\" alt=\"250725_16h02m52s_screenshot\" src=\"https://github.com/user-attachments/assets/041d2cf6-13ba-4c89-a960-1903073ff2d4\" /\u003e\n\u003cimg width=\"1360\" height=\"768\" alt=\"250725_16h03m09s_screenshot\" src=\"https://github.com/user-attachments/assets/0c1ad8ca-37c1-4fd6-a48d-46f74c2d2609\" /\u003e\n\n[![YouTube](https://img.shields.io/badge/YouTube-Video-FF0000?logo=youtube)](https://youtu.be/HHUZWHfNAl0?si=ZrRv2ggnPBEBS5oY)\n[![AUR](https://img.shields.io/badge/AUR-Package-1793D1?logo=arch-linux)](https://aur.archlinux.org/packages/hypr-dock)\n\n## Installation\n\n### Dependencies\n\n- `go` (make)\n- `gtk3`\n- `gtk-layer-shell`\n\n### Installation\n! The first build may take a very long time due to gtk3 bindings !\n```bash\ngit clone https://github.com/lotos-linux/hypr-dock.git\ncd hypr-dock\nmake get\nmake build\nmake install\n```\n\n### Uninstallation\n```bash\nmake uninstall\n```\n\n### Local run (dev mode)\n```bash\nmake exec\n```\n\n## Running\n\n### Launch parameters:\n\n```text\n  -config string\n    \tconfig file (default \"~/.config/hypr-dock\")\n  -dev\n    \tenable developer mode\n  -log-level string\n    \tlog level (default \"info\")\n  -theme string\n    \ttheme dir\n```\n#### All parameters are optional.\n\nDefault configuration and themes are installed in `/etc/hypr-dock`\nOn first run, they are copied to `~/.config/hypr-dock`\n### Add to `hyprland.conf`:\n\n```text\nexec-once = hypr-dock\nbind = Super, D, exec, hypr-dock\n```\n\n### And configure blur if needed\n```text\nlayerrule = blur true,match:namespace hypr-dock\nlayerrule = ignore_alpha 0,match:namespace hypr-dock\nlayerrule = blur true,match:namespace dock-popup\nlayerrule = ignore_alpha 0,match:namespace dock-popup\n```\n\n#### The dock only supports one running instance, so running it again will close the previous one.\n\n## Configuration\n\n#### !Important!\nIf you already had `hypr-dock` installed or you are updating, please note that starting from version 1.2.0, an `ini`-like configuration format is now used. If you have old configs remaining in your user folder, be sure to delete or move them. Then simply adapt your settings to the new format.\n\n### Available parameters in `hypr-dock.conf`\n\n```ini\n[General]\nCurrentTheme = lotos\n\n# Icon size (px) (default 23)\nIconSize = 23\n\n# Window overlay layer height (background, bottom, top, overlay) (default top)\nLayer = top\n\n# Exclusive Zone (true, false) (default true)\nExclusive = true\n\n# SmartView (true, false) (default false)\nSmartView = false\n\n# Window position on screen (top, bottom, left, right) (default bottom)\nPosition = bottom\n\n# Delay before hiding the dock (ms) (default 400)\nAutoHideDelay = 400   # Only for SmartView\n\n# Use system gap (true, false) (default true)\nSystemGapUsed = true\n\n# Indent from the edge of the screen (px) (default 8)\nMargin = 8\n\n# Distance of the context menu from the window (px) (default 5)\nContextPos = 5\n\n[General.preview]\n# Window thumbnail mode selection (none, live, static) (default none)\nMode = none\n# \"none\"   - disabled (text menus)\n# \"static\" - last window frame\n# \"live\"   - window streaming\n      \n# !WARNING! \n# BY SETTING \"Mode\" TO \"live\" OR \"static\", YOU AGREE TO THE CAPTURE \n# OF WINDOW CONTENTS.\n# THE \"HYPR-DOCK\" PROGRAM DOES NOT COLLECT, STORE, OR TRANSMIT ANY DATA.\n# WINDOW CAPTURE OCCURS ONLY FOR THE DURATION OF THE THUMBNAIL DISPLAY!\n#   \n# Source code: https://github.com/lotos-linux/hypr-dock\n\n# Live preview fps (0 - ∞) (default 30)\nFPS = 30\n\n# Live preview bufferSize (1 - 20) (default 5)\nBufferSize = 5\n\n# Popup show/hide/move delays (ms)\nShowDelay = 500  # (default 500)\nHideDelay = 350  # (default 350)\nMoveDelay = 100  # (default 100)\n```\n#### If a parameter is not specified, the default value will be used\n\n## Understanding non-obvious parameters\n\n### SmartView\nSimilar to auto-hide: if `true`, the dock stays beneath all windows, but moves the cursor to the screen edge - the dock rises above them\n\n### Exclusive\nActivates special layer behavior where tiling windows do not overlap the dock\n\n### SystemGapUsed\n- When `SystemGapUsed = true`, the dock sets its margin from the screen edge using values from the `hyprland` configuration, specifically `general:gaps_out` values, and dynamically updates when the `hyprland` configuration changes\n- When `SystemGapUsed = false`, the margin from the screen edge is set by the `Margin` parameter\n\n### General.preview\n- `ShowDelay`, `HideDelay`, `MoveDelay` - preview popup action delays in milliseconds\n- `FPS`, `BufferSize` - only used when `Mode = live`\n\n#### Preview appearance settings are configured through theme files\n\n### Pinned applications are stored in `~/.local/share/hypr-dock/pinned`\nTo pin/unpin, open the application's context menu in the dock and click `pin`/`unpin`\n#### Example\n```text\nfirefox\ncode-oss\nkitty\norg.telegram.desktop\nnemo\norg.kde.ark\nsublime_text\nqt6ct\none.ablaze.floorp\n```\nYou can edit it manually. But why? ¯\\_(ツ)_/¯\n\n## Themes\n\n#### Themes are located in `~/.config/hypr-dock/themes/`\n\n### A theme consists of\n- `theme.conf`\n- `style.css`\n- A folder with `svg` files for indicating the number of running applications (see [themes_EN.md](https://github.com/lotos-linux/hypr-dock/blob/main/docs/customize/themes_EN.md))\n\n### Theme config\n```ini\n[Theme]\n# Distance between elements (px) (default 9)\nSpacing = 5\n\n\n[Theme.preview]\n# Size (px) (default 120)\nSize = 120\n\n# Image/Stream border-radius (px) (default 0)\nBorderRadius = 0\n\n# Popup padding (px) (default 10)\nPadding = 10\n```\n#### Customize `style.css` as you wish. Detailed styling documentation will be provided later.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flotos-linux%2Fhypr-dock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flotos-linux%2Fhypr-dock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flotos-linux%2Fhypr-dock/lists"}