Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/joaotavora/darkroom

Simple distraction-free editing
https://github.com/joaotavora/darkroom

Last synced: 3 months ago
JSON representation

Simple distraction-free editing

Awesome Lists containing this project

README

        

Darkroom
--------

Remove visual distractions and focus on writing.

![screenshot](screenshot.png)

This extension is available on Emacs' own GNU ELPA. Alternatively, put
`darkroom.el` somewhere in your load-path and `require` it.

The main entrypoints are two minor modes:

* `M-x darkroom-mode`

`darkroom-mode` makes visual distractions disappear: the mode-line is
temporarily elided, text is enlarged and margins are adjusted so that
text centered on the window.

* `M-x darkroom-tentative-mode`

`darkroom-tentative-mode` is similar, but it only turns on these
features if the current buffer occupies the sole window of the
Emacs frame (i.e. all other windows are deleted). Whenever the
frame is split to display more windows and more buffers, the buffer
exits `darkroom-mode`. Whenever they are deleted, the buffer
re-enters `darkroom-mode`.

Personally, I always use `darkroom-tentative-mode`.

See also the customization options `darkroom-margins` and
`darkroom-fringes-outside-margins`, which affect both modes.