Skip to content
Dim the font color of text in surrounding paragraphs
Branch: master
Clone or download
zsxh Fix buffer-local variables definition
Define focus-current-thing, focus-buffer, focus-pre-overlay,
focus-post-overlay, focus-read-only-blink-timer as buffer-local variable
Latest commit ab42b87 Mar 18, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
README.md
demo-dark.gif
demo-light.gif
focus.el

README.md

MELPA

Focus

Focus provides focus-mode that dims the text of surrounding sections, similar to iA Writer's Focus Mode.

Installation

You can install Focus using elpa. It's available on melpa:

M-x package-install focus

The package has only been tried on Emacs 24.4 and 24.5, but should work on Emacs 24 or higher.

Usage

Enable the focus-mode with M-x focus-mode .

Also, focus-read-only-mode is provided, which is a mode optimized for continuous reading. It inhibits change in the buffer, hides the cursor and provides bindings for moving between things (defined in Thing At Point). One can toggle focus-read-only-mode with M-x focus-read-only-mode or C-c C-q if focus-mode is enabled.

Some bindings for simple navigation and exiting focus-read-only-mode are provided.

Keybinding Description
n Jump to next thing
SPC Jump to next thing
p Jump to previous thing
S-SPC Jump to previous thing
i Exit focus-read-only-mode
q Exit focus-read-only-mode

Configuring

The amount of dimness can be customized by setting the focus-dimness variable, where a positive integer indicates a more dim color (i.e. more blended with the background color of your theme), and a negative integer indicates a less dim color.

Focus uses the Thing At Point library to choose what section should be in focus. By default, modes derived from prog-mode uses defun, and modes derived from text-mode uses sentence. This a customizable by setting the focus-mode-to-thing variable, which is a list containing pairs on the form (mode . thing).

Example

This is what it looks like:

Light Theme (leuven) Dark Theme (monokai)
You can’t perform that action at this time.