whatisgithub

What is rust-dock?

rhythmcreative/rust-dock — explained in plain English

Analysis updated 2026-05-18

12RustAudience · developerComplexity · 2/5Setup · moderate

In one sentence

A Rust and GTK4 dock for the Hyprland Linux window manager with live app previews and pywal color syncing.

Mindmap

mindmap
  root((rust-dock))
    What it does
      App dock for Hyprland
      Live window previews
      Drag and drop icons
    Tech Stack
      Rust
      GTK4
      Wayland
      Cargo
    Use Cases
      Pywal color syncing
      Multi monitor targeting
      Custom CSS styling
    Audience
      Linux users
      Hyprland users
    Setup
      Clone and run install script
      Do not use sudo
      Configure via CLI flags

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Add an application dock with live window previews to a Hyprland desktop.

USE CASE 2

Match dock colors automatically to your wallpaper using pywal.

USE CASE 3

Reserve screen space so open windows do not slide under the dock.

What is it built with?

RustGTK4HyprlandWaylandCargo

How does it compare?

rhythmcreative/rust-dockbigsaltyfishes/wallpaper-engine-for-macosganten7/navi
Stars121212
LanguageRustRustRust
Setup difficultymoderatehardmoderate
Complexity2/54/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Only works on Linux with the Hyprland compositor already installed.

So what is it?

rust-dock is a taskbar application for Hyprland, a popular tiling window manager that runs on Linux using the Wayland display protocol. It is written in Rust and built with GTK4, a toolkit for creating graphical interfaces. The dock displays application icons in two sections along any edge of the screen: a left (or top) section for apps you have pinned, and a right (or bottom) section for apps that are currently open but not pinned. When multiple windows are open, thumbnail previews update in real time at 30 frames per second so you can see what is running at a glance. Icons can be rearranged by dragging and dropping. The dock automatically picks up the color scheme generated by pywal, a tool that extracts colors from a wallpaper and applies them across the desktop. If you change your wallpaper and regenerate colors, the dock updates to match without any extra steps. Configuration is handled through command-line flags. You can set the dock position (top, bottom, left, or right), icon size, padding, corner radius, opacity, and margin from the screen edge. An exclusive zone option reserves screen space so application windows are pushed aside rather than sliding under the dock. A smart-view option hides the dock until your cursor reaches that edge of the screen. You can also point to a custom CSS file to override the visual style, and target a specific monitor by name if you have multiple displays. Installation clones the repository and runs a provided script. The README notes you should not run the install script with elevated permissions. The project is under active development, and the author warns that bugs may still be present.

Copy-paste prompts

Prompt 1
Help me install rust-dock on my Hyprland setup without using sudo.
Prompt 2
Explain what the exclusive-zone and smart-view flags do in rust-dock.
Prompt 3
Show me how to configure rust-dock's position, icon size, and opacity.
Prompt 4
Help me set up pywal so rust-dock matches my wallpaper colors.

Frequently asked questions

What is rust-dock?

A Rust and GTK4 dock for the Hyprland Linux window manager with live app previews and pywal color syncing.

What language is rust-dock written in?

Mainly Rust. The stack also includes Rust, GTK4, Hyprland.

How hard is rust-dock to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is rust-dock for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.