NonGNU ELPA - workroom

workroom

Description
Named rooms for work without irrelevant distracting buffers
Latest
workroom-2.3.1.tar (.sig), 2024-Mar-31, 310 KiB
Maintainer
Akib Azmain Turja <akib@disroot.org>
Atom feed
workroom.xml
Website
https://codeberg.org/akib/emacs-workroom
Browse ELPA's repository
CGit or Gitweb
Badge
Manual
workroom

To install this package from Emacs, use package-install or list-packages.

Full description

Workroom provides named "workrooms" (or workspaces), somewhat similar to multiple desktops in GNOME.

Each workroom has own set of buffers, allowing you to work on multiple projects without getting lost in all buffers.

Each workroom also has its own set of views. Views are just named window configurations. They allow you to switch to another window configuration without losing your well-planned window setup.

Workroom integrates with:

  • Buffer Menu
  • IBuffer
  • Winner
  • Bookmark
  • Desktop

1. Install

1.1. MELPA

M-x package-refresh-contents and M-x package-install RET workroom.

1.2. Quelpa

Do M-x quelpa RET workroom, Quelpa should get the recipe from MELPA and install it.

1.3. Straight.el

Put this in (straight-use-package 'workroom) your init file, Straight.el should get the recipe from MELPA and install it.

2. Usage

There is always a workroom named "master", which contains all live buffers. Removing any buffer from this workroom kills that buffer. You can't kill this workroom, but you can customize the variable workroom-default-room-name to change its name.

All the useful commands can be called with following key sequences:

Key Command
C-x c s workroom-switch
C-x c S workroom-switch-view
C-x c d workroom-kill
C-x c D workroom-kill-view
C-x c C-d workroom-kill-with-buffers
C-x c r workroom-rename
C-x c R workroom-rename-view
C-x c c workroom-clone
C-x c C workroom-clone-view
C-x c m workroom-bookmark
C-x c M workroom-bookmark-multiple
C-x c b workroom-switch-to-buffer
C-x c a workroom-add-buffer
C-x c k workroom-kill-buffer
C-x c K workroom-remove-buffer

Here the prefix key sequence is C-x c, but you can customize workroom-command-map-prefix to change it.

You might want to remap switch-to-buffer, kill-buffer and other commands with Workroom-aware commands by adding something like the following to your init file:

(global-set-key [remap switch-to-buffer] #'workroom-switch-to-buffer)
(global-set-key [remap kill-buffer] #'workroom-kill-buffer)

You can save all your workroom in your desktop by enabling workroom-desktop-save-mode mode.

You can create a workroom containing only your project buffer with workroom-switch-to-project-workroom. You can also enable workroom-auto-project-workroom-mode, it'll switch to (creating if needed) the project's workroom when you open a file.

If you want to completely automate managing workroom buffer list, check out the docstrings of workroom-buffer-manager-function, workroom-set-buffer-manager-function and workroom-buffer-manager-data.

There's a Info manual available with more information, which can be accessed with C-h i m Workroom, also available here on the internet.

Old versions

workroom-2.3.tar.lz2023-Jan-2246.2 KiB
workroom-2.2.5.tar.lz2022-Nov-2845.9 KiB
workroom-2.2.4.tar.lz2022-Nov-27 134 KiB