A command-line controller for Haiku Work Spaces.
  • C++ 51.7%
  • Makefile 48.3%
Find a file
2026-06-14 23:15:36 -07:00
.gitignore gitignore 2026-06-13 20:07:07 -07:00
App.cpp update version with license fix; minor formatting 2026-06-14 23:15:36 -07:00
LICENSE Initial commit 2026-06-13 19:58:48 -07:00
Makefile initial 2026-06-13 20:02:56 -07:00
README.md formatting 2026-06-14 17:35:48 -07:00
shortcuts.keyset initial 2026-06-13 20:02:56 -07:00
shortcuts.png initial 2026-06-13 20:02:56 -07:00

workspacesctl

A command-line controller for Haiku Work Spaces

build:

workspacesctl is a Genio project with an automatically-generated Makefile.

To build the command line app in Terminal:

  • clone this repository
  • cd to the repository directory
  • run 'make'

install:

Releases are on the public repository at https://forge.full0fstars.net/Public/workspacesctl/releases.

Download the latest release's .hpkg file and move it into "/boot/system/packages/" or "/boot/home/config/packages/".

usage:

Usage: workspacesctl [options]
a command-line interface to the Workspaces functionality

with no arguments, workspacesctl will ouptut information about the current
Workspaces layout; the supported arguments are:

  -h  --help            display help
  -s  --switch <arg>    switch Workspace; <arg> can be one of:
                                +               go to next by number
                                -               go to previous by number
                                up              go up a row
                                down            go down a row
                                left            go left a column
                                right           go right a column
                                <number>        go to Workspace <number>
  -v  --version         display version

To display the current Workspaces settings:

> ./workspacesctl 
Workspaces layout:
current 2
columns 4
rows    3
total   12

workspacesctl is most useful in combination with Haiku's Shortcuts. The two together can provide full keyboard navigation of a large grid of Workspaces.

See the file "shortcuts.png" for a screenshot showing the Shortcuts preferences using workspacesctl; you can import the file 'shortcuts.keyset' into the Shortcuts preferences to install that shortcut set.