https://github.com/mina86/auto-dim-other-buffers.el

Visually makes non-selected windows less prominent
https://github.com/mina86/auto-dim-other-buffers.el

Last synced: 2 months ago
JSON representation

Visually makes non-selected windows less prominent

• Host: GitHub
• URL: https://github.com/mina86/auto-dim-other-buffers.el
• Owner: mina86
• License: gpl-3.0
• Created: 2013-04-29T16:33:06.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2024-05-15T13:13:30.000Z (8 months ago)
• Last Synced: 2024-08-02T01:26:04.795Z (6 months ago)
• Language: Emacs Lisp
• Homepage:
• Size: 651 KB
• Stars: 91
• Watchers: 5
• Forks: 13
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# auto-dim-other-buffers.el

[![NonGNU ELPA](https://elpa.nongnu.org/nongnu/auto-dim-other-buffers.svg)](https://elpa.nongnu.org/nongnu/auto-dim-other-buffers.html)

[![MELPA](https://melpa.org/packages/auto-dim-other-buffers-badge.svg)](https://melpa.org/#/auto-dim-other-buffers)

The `auto-dim-other-buffers-mode` is a global minor mode which makes

windows without focus less prominent.  With many windows in a frame,

the idea is that this mode helps recognise which is the selected

window by providing a non-intrusive but still noticeable visual

indicator.

[![Demo](screenshot.gif)](https://www.youtube.com/watch?v=2djOHSWhyD4)

The preferred way to install the mode is by grabbing

`auto-dim-other-buffers` package form NonGNU ELPA:

    M-x package-install RET auto-dim-other-buffers RET

Once installed, enable the mode with:

    M-x auto-dim-other-buffers-mode RET

To make it enabled every time Emacs starts, add the following to Emacs

initialisation file (typically `~/.emacs` or `~/.emacs.d/init.el`):

    (add-hook 'after-init-hook (lambda ()

      (when (fboundp 'auto-dim-other-buffers-mode)

        (auto-dim-other-buffers-mode t))))

To configure how dimmed buffers look, customise

`auto-dim-other-buffers-face`.  This can be accomplished by:

    M-x customize-face RET auto-dim-other-buffers-face RET

More options can be found in `auto-dim-other-buffers` customisation

group which can be accessed with:

    M-x customize-group RET auto-dim-other-buffers RET

Note that despite it’s name, since Emacs 27 the mode operates on

*windows* rather than buffers.  I.e. selected window is highlighted

and all other windows are dimmed even if they display the same buffer.