# Workspace Grid

- Link: https://blog.curbsoftware.com/project/workspace-grid/
- Published: 2026-11-01T12:27:34+00:00
- Author: curbsoftware

# Workspace Grid Desklet

Workspace Grid provides a named, clickable workspace grid on the desktop.
 Choose
simple name tiles or desktop previews showing visible windows and app icons. Both
modes retain workspace names and active workspace highlighting.

## Screenshots

On the desktop:

The settings window:

## Features

 * One clickable tile per workspace
 * Name tiles or graphical desktop previews with every connected monitor
 * Live unobscured window, focus, monitor, workspace, and name updates
 * Auto or fixed-column layout
 * Fixed layouts expand rows so no workspace is hidden
 * Optional add tile and per-workspace rename or remove menu
 * Filtered, throttled row or cell scroll switching
 * Keyboard focus, tooltips, and accessible names

## Settings

Right-click the desklet and choose Configure.

 * Grid layout mode, fixed rows, and fixed columns
 * Names or desktop previews
 * Optional numeric name prefix
 * Workspace editing controls
 * Scroll wheel behavior
 * Tile spacing and desklet size

## Manual install

No root needed. Everything installs into your home directory.

From a release package:

    ```bash
    curl -fLO https://github.com/CurbSoftware/cinnamon-workspace-grid-desklet/releases/latest/download/cinnamon-workspace-grid-desklet.zip
    unzip -o cinnamon-workspace-grid-desklet.zip
    mkdir -p ~/.local/share/cinnamon/desklets
    rm -rf ~/.local/share/cinnamon/desklets/cinnamon-workspace-grid-desklet@curbsoftware
    cp -r cinnamon-workspace-grid-desklet@curbsoftware/files/cinnamon-workspace-grid-desklet@curbsoftware \
       ~/.local/share/cinnamon/desklets/cinnamon-workspace-grid-desklet@curbsoftware
    ```

Or straight from git:

    ```bash
    git clone https://github.com/CurbSoftware/cinnamon-workspace-grid-desklet.git || git -C cinnamon-workspace-grid-desklet pull
    cd cinnamon-workspace-grid-desklet
    mkdir -p ~/.local/share/cinnamon/desklets
    rm -rf ~/.local/share/cinnamon/desklets/cinnamon-workspace-grid-desklet@curbsoftware
    cp -r files/cinnamon-workspace-grid-desklet@curbsoftware \
       ~/.local/share/cinnamon/desklets/cinnamon-workspace-grid-desklet@curbsoftware
    ```

The `rm -rf` before the copy is the upgrade path: old files are removed so
 nothing
deleted upstream lingers, then the copy brings the new tree in. Your settings are
stored separately in `~/.config/cinnamon/spices/cinnamon-workspace-grid-desklet@
curbsoftware/` and survive reinstalls.

Restart Cinnamon (**Alt-F2**, type `r`, Enter) and add the desklet from
 Cinnamon
Settings.

## Testing

    ```language-sh
    gjs dev-tools/test-workspace-actions.js
    python3 dev-tools/live-test-desklet.py
    ```

UUID: `cinnamon-workspace-grid-desklet@curbsoftware`

Licensed under GNU GPL v2.0 or later. See [LICENSE](https://blog.curbsoftware.com/project/workspace-grid/LICENSE).
