workroom
- Description
- Named rooms for work without irrelevant distracting buffers
- Latest
- workroom-2.3.1.0.20230926.163128.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.0.20230123.163037.tar.lz | 2023-Jan-23 | 46.2 KiB |
workroom-2.3.0.20230123.91535.tar.lz | 2023-Jan-23 | 46.2 KiB |
workroom-2.3.0.20230122.164535.tar.lz | 2023-Jan-22 | 46.2 KiB |
workroom-2.2.5.0.20221212.103727.tar.lz | 2022-Dec-12 | 46.0 KiB |
workroom-2.2.5.0.20221128.200156.tar.lz | 2022-Nov-28 | 46.0 KiB |
workroom-2.2.4.0.20221126.155052.tar.lz | 2022-Nov-27 | 45.9 KiB |