78 lines
2.5 KiB
ReStructuredText
78 lines
2.5 KiB
ReStructuredText
eyebrowse
|
|
=========
|
|
|
|
.. image:: https://raw.github.com/wasamasa/eyebrowse/master/eyebrows.gif
|
|
|
|
About
|
|
-----
|
|
|
|
``eyebrowse`` is a global minor mode for Emacs that allows you to manage
|
|
your window configurations in a simple manner. It displays their
|
|
current state in the modeline by default. The behaviour is modeled
|
|
after `ranger <http://ranger.nongnu.org/>`_, a file manager written in
|
|
Python.
|
|
|
|
Installation
|
|
------------
|
|
|
|
Install via `quelpa <https://github.com/quelpa/quelpa>`_ with ``M-:
|
|
(quelpa 'eyebrowse)`` or install the package from `MELPA
|
|
<http://melpa.milkbox.net/>`_.
|
|
|
|
Usage
|
|
-----
|
|
|
|
Use ``M-x eyebrowse-mode`` to enable ``eyebrowse`` interactively. If
|
|
you want to enable it automatically on startup, add ``(eyebrowse-mode
|
|
t)`` to your init file (either ``~/.emacs`` or
|
|
``~/.emacs.d/init.el``).
|
|
|
|
The default key bindings are:
|
|
|
|
============== ================================
|
|
Key bind Function
|
|
============== ================================
|
|
``C-c C-' <`` Switch to previous window config
|
|
``C-c C-' >`` Switch to next window config
|
|
``C-c C-' '`` Switch to last window config
|
|
``C-c C-' "`` Close current window config
|
|
``C-c C-' 0`` Switch to window config ``0``
|
|
\... ...
|
|
``C-c C-' 9`` Switch to window config ``9``
|
|
============== ================================
|
|
|
|
Further Customization
|
|
---------------------
|
|
|
|
Use ``M-x customize-group RET eyebrowse`` for a list of customizable
|
|
options. The more interesting ones would be
|
|
``eyebrowse-wrap-around-p`` and ``eyebrowse-switch-back-and-forth-p``
|
|
which affect both wrap around and lazier switching.
|
|
|
|
If you're not happy with the default keybindings, a riskier set can be
|
|
enabled additionally either by executing ``M-:
|
|
(eyebrowse-setup-opinionated-keys)`` interactively or inserting
|
|
``(eyebrowse-setup-opinionated-keys)`` in your init file. If the
|
|
function detects the `evil <https://gitorious.org/evil>`_ package, it
|
|
will enable extra key bindings for it as well.
|
|
|
|
The extra key bindings are:
|
|
|
|
=============== ================================
|
|
Key bind Function
|
|
=============== ================================
|
|
``C-<``, ``gT`` Switch to previous window config
|
|
``C->``, ``gt`` Switch to next window config
|
|
``C-'``, ``zx`` Switch to last window config
|
|
``C-"``, ``gc`` Close current window config
|
|
``M-0`` Switch to window config ``0``
|
|
\... ...
|
|
``M-9`` Switch to window config ``9``
|
|
=============== ================================
|
|
|
|
Name
|
|
----
|
|
|
|
Actually, I wanted to name this mode "eyebrows" for no real reason,
|
|
but then a silly typo happened. The typo stuck. So did the new name.
|