spacemacs/layers/+tools/eaf/README.org

eaf layer

• Description
  • Features:
• Install
• Usage
  • Configuring keybindings
• Key bindings
  • Global
    • All EAF-applications
    • Browser
  • Local
    • All EAF-applications
    • Browser
    • PDF-viewer
    • pdf-view-mode (pdf-tools)

Description

This layer adds support for the Emacs Application Framework (EAF).

Features:

• Browse using a full-fledged browser within Emacs
• PDF viewer (with continuous scroll)
• Video player
• Image viewer
• See EAF documentation for many more features

Install

To use this configuration layer, add it to your ~/.spacemacs. You will need to add eaf to the existing dotspacemacs-configuration-layers list in this file.

Subsequently install the required dependencies with SPC SPC eaf-install-dependencies. This command only works for Ubuntu and Fedora based distributions. Users of Arch (based) distributions can run the script manually in their terminal. If the script does not work for you then install the required dependencies manually.

Usage

Configuring keybindings

Configuration of EAF keybindings works in a different way than normally in Spacemacs.

Also EAF, and additionally this layer, implement some tricks that are required to make leader keys in EAF buffers behave as expected in Spacemacs. Therefore it is recommended to keep these default (major-mode-)leader keybindings.

For information about configuration of other key bindings for EAF, see here.

If you do want to modify the leader keys, then information about the tricks implemented in this layer can be found here and here.

Key bindings

Global

All EAF-applications

Key Binding	Description
SPC a a f	EAF open file (see EAF doc for suppoted file types)
SPC t k m	Show available key commands in which-key (read here for more details)
, d	toggle dark-mode (in pdf-viewer just press d)

Browser

SPC a a b o	Open url in new buffer
SPC a a b s	Search with your favorite search engine. Defaults to symbol at point or region string
SPC a a b b	Open bookmark in new buffer
SPC a a b h	Search and open buffer from history

Local

All EAF-applications

j/k	Scroll up/down

Browser

J/K	Scroll (half) page up/down
e	Edit url
m	Bookmark page
C-s	Search/search find next (to enter new search prefix with C-g
C-r	Search find previous
, h	Open new buffer from history
, s	Search web with favorite search engine

PDF-viewer

d	toggle dark-mode

pdf-view-mode (pdf-tools)

, e	open in eaf pdf-viewer

There are many more keybindings. Use SPC t k m to show them persistently in which-key, or use SPC h d k to show the `eaf-mode-map` in a separate buffer.