Skip to content
forked from ajgrf/edwina

Dynamic window manager for Emacs

License

Notifications You must be signed in to change notification settings

glencjones/edwina

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

60 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Edwina

Edwina is a dynamic window manager for Emacs. It automatically arranges your Emacs panes (called “windows” in Emacs parlance) into predefined layouts, dwm-style.

Status

Edwina is new and experimental. While it works very well on the subset of Emacs that I use, you will definitely encounter bugs if you venture outside of that. Patches welcome!

Installation

MELPA

After enabling installation of MELPA packages, install edwina with M-x package-install.

Manual

Copy or clone Edwina somewhere on your system:

git clone https://github.com/ajgrf/edwina ~/.emacs.d/edwina

Then add its location to load-path:

(add-to-list 'load-path
             (expand-file-name "~/.emacs.d/edwina"))

use-package

Typical use-package

Here’s a complete example configuration with use-package for reference:

(use-package edwina
  :ensure t
  :config
  (setq display-buffer-base-action '(display-buffer-below-selected))
  (edwina-setup-dwm-keys)
  (edwina-mode 1))

Configuration for doom.

(package! edwina :recipe (:host github :repo "glencjones/edwina") )

Usage

Edwina divides the frame into 2 areas, the master area and the stack. The master area contains the largest window(s), and other windows are placed in the stack. Edwina tries to place the master area to the side, but if the frame is too narrow for 2 columns it will put it on top instead.

+-----------+---------+     +-----------+
|           |    1    |     |           |
|           +---------+     |  master   |
|  master   |    2    |     |           |
|           +---------+     +-----------+
|           |    3    |     |     1     |
+-----------+---------+     +-----------+

Edwina arranges windows according to just a few parameters: the size of the master area, the number of windows in master, the order of windows, and the current layout. By operating on these parameters instead of manually manipulating individual windows, you can greatly reduce the effort required to resize and reposition windows.

Buffer filtering

You can get Edwina to ignore specific buffers by implementing a filter function.

(defun doom-popup-filter (in-buffer)
  (if (string-match-p "popup" (buffer-name in-buffer) ) t nil)
  )
(setq! edwina-buffer-filter #'doom-popup-filter)

Key Bindings

By default these keys are prefixed with C-c C-w. Customize edwina-keymap-prefix to change the prefix.

BindingAction
r, C-rArrange windows
n, C-n, SPCMove to next window
p, C-pMove to previous window
N, C-S-nSwap places with the next window
P, C-S-pSwap places with the previous window
%, {, [Decrease the size of the master area
^, }, ]Increase the size of the master area
d, C-dDecrease number of windows in master
iIncrease number of windows in master
k, C-kDelete window
RETCycle window to/from master area
c, C-cClone current window

See also (edwina-setup-dwm-keys) to set up alternative dwm-like key bindings.

Scope

Edwina does not provide workspaces or window rules, instead delegating such functionality to other plugins and Emacs facilities (like eyebrowse).

I recommend setting display-buffer to open a new window by default, then defining any exceptions in display-buffer-alist.

(setq display-buffer-base-action '(display-buffer-below-selected))

About

Dynamic window manager for Emacs

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Emacs Lisp 100.0%