rougier / nano-sidebar

Emacs package to have configurable sidebars on a per frame basis.
GNU General Public License v3.0
128 stars 6 forks source link
elisp emacs frame nano sidebar

GNU Emacs / N Λ N O sidebar

This package allows to have configurable sidebars on a per frame basis.

Installation

Install with straight.el:

(straight-use-package '(nano-sidebar :type git :host github
                                     :repo "rougier/nano-sidebar"))

... or install with quelpa:

(use-package nano-sidebar
  :ensure nil
  :defer t
  :quelpa (nano-sidebar
           :fetcher github
           :repo "rougier/nano-sidebar"))

Usage

It is possible to use the sidebar without any configuration

(require 'nano-sidebar)

(nano-sidebar-toggle)

In such case, a sidebar with default values is created and the default init function is called.

You can also configure sidebars individually by first naming your frame and then provide a specific configuration:

(defun nano-sidebar-mu4e-init (frame sidebar)
  (select-frame sidebar)
  (do-some-stuff...))

(add-to-list 'nano-sidebar-properties
   `("mu4e"    36 dark ,nano-dark-background nano-sidebar-mu4e-init))

(set-frame-parameter nil 'name "mu4e")
(nano-sidebar-toggle)

Screenshots

This screenshot shows a sidebar displaying a custom ibuffer. See nano-sidebar-ibuffer.el

This screenshot shows a sidebar displaying a mu4e dashboard. See mu4e-dashboard