Spacemacs layers list

+chat/erc/README.org

Layer for ERC IRC chat.

Features:

• Highlight nicks (using erc-hl-nicks)
• Image inline support (using erc-image)
• Logging to ~/.emacs.d/.cache/erc-logs and ViewLogMode for viewing logs (using erc-view-log)
• YouTube videos Thumbnails inline (using erc-yt)
• Social Graph for ERC messages (using erc-social-graph)
• Optional SASL authentication via the variable erc-enable-sasl-auth (using erc-sasl)
• D-BUS notifications via the variable erc-enable-notifications
• Completion of Emojis using company-emoji (still needs a way of showing, either using the emoji layer or having a proper font) :clap:

+chat/jabber/README.org

This layer adds support for the Jabber (XMPP) client for Emacs

Features:

• Use Jabber without having to leave Spacemacs

+chat/rcirc/README.org

This layer provide support for rcirc with optional support for authinfo and ZNC.

Features:

• Store channel logs into ~/.emacs.d/.cache/rcirc-logs/<channel>
• Support for credentials stored in ~/.authinfo.gpg (need to have gnutls)
• Support ZNC support (with optional ~/.authinfo.gpg)
• Colored nicknames
• Real-time change when people use s/foo/bar/ in chat
• Completion of Emojis using company-emoji (still needs a way of showing, either using the emoji layer or having a proper font) :clap:

+chat/slack/README.org

This layer provides an interface to the Slack chat service via the emacs-slack package. Where possible, this layer aims to reuse key bindings from the IRC packages in Spacemacs.

Features:

• Real time messaging with emacs-websocket
• Connect to multiple slack instances
• Notifications with alert.el

+checkers/spell-checking/README.org

This layer provides spell checking capabilities to Spacemacs.

Features:

• Buffer-wide spell checking via external command (ispell, hunspell, aspell) run through Flyspell.
• Spell as you type
• Optional correction popups, controlled by enable-flyspell-auto-completion variable.
• Auto dictionary mode for some languages.

+checkers/syntax-checking/README.org

This layer adds on-the-fly syntax checking to all supported language layers.

Features:

• Automatic syntax checking with Flycheck for various language layers.
• Shows syntax error in pop-up window via flycheck-pos-tip.

+completion/auto-completion/README.org

This layer adds auto-completion to all supported language layers.

Features:

• Support for code completion with company or auto-complete for various language layers
• Frequency-based suggestions via company-statistics for company
• Integration with yasnippet and auto-yasnippet
• Automatic configuration of hippie-expand
• Automatic docstring tooltips are provided by company-quickhelp

+completion/compleseus/README.org

This layer implements completion provided by combining the following packages:

• selectrum or vertico: vertical completion user interface
• consult: useful commands using completing-read
• embark: provides minibuffer actions
• marginalia: annotations to completion candidates
• orderless: filtering enhancements

It only supports emacs 27 or later.

Features:

• Similar features like ivy or helm

+completion/helm/README.org

This layer enables Helm everywhere in Spacemacs. The alternative to this layer is the Ivy layer which brings the same level of integration as Helm.

These completion systems are the central control towers of Spacemacs, they are used to manage buffers, projects, search results, configuration layers, toggles and more…

Mastering your choice of completion system will make you a Spacemacs power user.

Features:

• Project wide grep like text search via helm-dir-smart-do-search
• Project wide text replacements using helm-edit-mode
• Buffer wide dynamic text search via helm-swoop
• Fuzzy matching for most helm-sources
• Detailed configuration parameters for helms appearance
• Intuitive transient state

+completion/ivy/README.org

This layer enables Ivy for completion. It will replace the default completion by Helm.

These completion systems are the central control towers of Spacemacs, they are used to manage buffers, projects, search results, configuration layers, toggles and more…

Mastering your choice of completion system will make you a Spacemacs power user.

Features:

• Project wide grep like text search via search-auto
• Project wide text replacements using counsel-imenu
• Buffer wide dynamic text search via swiper
• Detailed configuration parameters for ivy appearance
• Intuitive transient state
• Advanced buffer information with ivy-rich

+completion/templates/README.org

This layer provides templates to Spacemacs. A template consists of text that is automatically inserted into a new file when it is opened. This is done via yatemplate, which leverages yasnippet.

Features:

• Auto-insert snippets when creating specific new files.

+email/gnus/README.org

This layer integrates a general purpose email/newsgroup client into Spacemacs.

Features:

• Support for reading RSS feeds, newsgroups and mails directly within Emacs via Gnus.
• Support for beautiful HTML mails generated from any org buffer.
• Support for credential management via GnuPG.

+email/mu4e/README.org

This layer adds support for the Mu4e email client.

Features:

• Search, read, reply, move, and delete email.
• Search-based: no folders, only queries.
• UI optimized for speed: quick keystrokes for common actions.
• Very extendable and customizable.
• Integration with Helm.
• Maildir summary.
• Notifications using mu4e-alert.

+email/notmuch/README.org

Notmuch offers a fast, global-search and tag-based email system to use within your text editor or in a terminal.

This layer integrates the Notmuch Emacs package into Spacemacs.

Features:

• Email searching
• Email tagging

+emacs/better-defaults/README.org

This layer enhances the default commands of Emacs and is primarily intended to be used with the emacs editing style as it does not change anything in the Vim key bindings.

However the emacs editing style is not required. You can still use this layer while you are using the vim editing style if you have some kind of mixed style, but some of the layer bindings might be shadowed by the evil key bindings.

The commands defined in this layer are taken from various sources like Prelude.

Features:

• Smart line navigation: Subsequent presses of C-a toggles between the beginning of the line and the first non-whitespace character. Similarly, subsequent presses of C-e will toggle between the end of the code and the end of the comments.
• spacemacs/backward-kill-word-or-region: A combination of kill-region and backward-kill-word, depending on whether there is an active region. If there's an active region kill that. If not kill the preceding word.
• Fill or unfill paragraph: Pressing M-q for the first time fills current paragraph and pressing M-q for the second time unfills it. Note that some modes override this key binding so it's not available everywhere. Due to implementation details unfilling doesn't work when called twice via M-x.

+emacs/helpful/README.org

This layer replaces the existing emacs related help buffers with more detailed ones.

Features:

• Better help buffers with helpful for emacs related buffers
• Source code shown implicitly in help buffer for all lisp objects
• More detailed descriptions in the emacs specific function, variable and key help buffers
• Better formatted elisp docstrings

+emacs/ibuffer/README.org

This layer configures Emacs IBuffer for Spacemacs.

Features:

• Grouping of buffers by major-modes
• Grouping of buffers by projects

+emacs/org/README.org

This layer enables org mode for Spacemacs.

Features:

• Vim inspired key bindings are provided by evil-org-mode
• Nicer bullet via org-superstar-mode
• A pomodoro method integration via org-pomodoro
• Presentation mode via org-present
• Insertion of images via org-download
• Project-specific TODOs via org-projectile
• Easy insert of URLs from clipboard with org format via org-cliplink
• Rich insert of code (into a source block with highlighting, and a link) from other buffers via org-rich-yank
• Pixel-perfect visual alignment for Org and Markdown tables via valign
• Text transclusion via org-transclusion

+emacs/outshine/README.org

This layer adds support for outshine and outorg. They will be enabled in all programming modes.

Features:

• Navigate through code buffers via headings like you do with org buffers
• Edit comments under outline headings in separate org-mode buffers

+tools/quickurl/README.org

Quickurl is a package in vanilla emacs for saving and inserting URLs. These are key bindings for the various methods of insertion, which are not bound by default.

Features:

• Key bindings to dispatch Quickurl (which is in vanilla Emacs).

+emacs/semantic/README.org

CEDET is a *C*ollection of *E*macs *D*evelopment *E*nvironment *T*ools written with the end goal of creating an advanced development environment in Emacs. CEDET includes common features such as intelligent completion, source code navigation, project management, code generation with templates. CEDET also provides a framework for working with programming languages; support for new programming languages can be added and use CEDET to provide IDE-like features. This framework is called Semantic.

Semantic is a package that provides a framework for writing parsers. Parsing is a process of analyzing source code based on programming language syntax. The packages relies on Semantic for analyzing source code and uses its results to perform smart code refactoring that based on code structure of the analyzed language, instead of plain text structure. Semantic is the core of CEDET.

Features:

• Display function or variable definition at the bottom.
• Display current function cursor is in at the top. See this page for demos in some programming languages.
• Support common C/C++ refactoring with semantic-refactor. See this page for demonstration of refactoring features.
• Support Lisp source code formatting with semantic-refactor. See this page for demonstration of Lisp formatting features.

+emacs/smex/README.org

This layer provides a more traditional alternative to helm-M-x based on ido.

Features:

• Provides an alternative way for helm-M-x based on ido and smex

+emacs/tabs/README.org

This layer adds support for tabs. Implementation is done using Centaur Tabs.

Features:

• Sets up tabs using Centaur tabs as backend
• Optionally auto hide tabs after delay

+emacs/typography/README.org

This layer provides support for typographic text editing in Spacemacs.

Features:

• Modes to automatically insert and cycle among typographic characters
• Typo Mode automatically inserts and cycles among typographic Unicode characters on some keys.
• Tildify Mode automatically inserts non-breaking spaces where required (Only available on Emacs 25).

+filetree/neotree/README.org

This layer setups a file tree navigator buffer using Neotree (replacing the Treemacs layer).

Features:

• intuitive evil key bindings integration
• supports multiple themes
• transient state by pressing on ?
• version-control integration

+filetree/treemacs/README.org

This layer sets up a file navigation and project explorer side-window via Treemacs.

Features:

A detailed overview of the features of Treemacs is available in the Treemacs readme. In short, Treemacs offers:

• Simple and powerful navigation and ability to detail exactly how and where a file should be opened.
• Good looking icons.
• Display of multiple file trees organized as projects residing in a workspace.
• Ability to show tags contained in files. Tags are provided by Imenu, so nearly every filetype is supported.
• Mouse interface for single and double left clicks in line with modern GUI standards (clicking on an icon will also display the file's tags).
• Location awareness: commands like find-file or magit-status will use the location of the node at point (with $HOME as fallback).
• Optional fontifying of files based on their git status.
• Optional collapsing of single-dir-child directories into one.
• Doing both asynchronously for an imperceptible performance cost.
• Optional follow-mode to automatically focus the currently selected file or tag.
• Optional filewatch-mode to automatically refresh the view after (and only after) changes to the shown filesystem.

+fonts/unicode-fonts/README.org

This layer adds support for unicode-fonts package. It is recommended to install the fonts listed in the Quickstart section of the unicode-fonts README.

Features:

• Display Unicode glyphs using the best available font.
• Easily override glyphs or sections of glyphs.
• Display color emoji on both the macOS port version of Emacs and emacs-plus (with unicode-fonts-force-multi-color-on-mac set to non nil).
• Enable support for font ligature in Emacs 27 + via ligatures.el.

+fun/emoji/README.org

This layer adds support for Emoji emoticons from emoji-cheat-sheet.

Features:

• Browse Emoji in a dedicated buffer
• Display Emoji images in buffer
• Insert one or several Emoji with a helm front-end
• Completion of Emojis using company-emoji

+fun/games/README.org

This layer allows you to play evilified games in Spacemacs.

Features:

• 2048-game
• Pacmacs (Pacman for Emacs)
• Sudoku
• Tetris
• Typit

+fun/selectric/README.org

This layer makes your Emacs sound like an IBM Selectric typewriter, for those moments when your loud, clicky mechanical keyboard is not at hand, yet, you'd still wish to enjoy the sound.

Features:

• Brings back fond memories about your first programming job where you started with that big mechanical keyboard and the small monochrome display working on the latest IBM Iseries server.

+fun/xkcd/README.org

This layer adds a xkcd navigation mode using emacs-xkcd.

Features:

• Load a random xkcd
• Show the text in the modeline
• Open explanation and current comic in browser
• Cache the comics in .cache/xkcd

+intl/chinese/README.org

This layer adds support for traditional Chinese script to Spacemacs.

Features:

• Support for the Pinyin (拼音) input method via chinese-pyim.
• Support for the Wubi (五笔) input method via chinese-wbim.
• Integration of the native input method framework fcitx via cute-jumper/fcitx.el.
• Integration of the Youdao (有道) Dictionary via youdao-dictionary.
• Support for file searches in dired using Chinese Pinyin characters via find-by-pinyin-dired.
• Support for jumping to Chinese Pinyin characters with ace-jump-mode via ace-pinyin.
• Support for conversion between simplified and traditional Chinese texts via chinese-conv.
• Automatic visual separation of Chinese and Latin characters via coldnew/pangu-spacing.
• Automatic joining of consecutive Chinese lines into a single long line without unwanted space when exporting org-mode to html.

+intl/japanese/README.org

This Layer adds Japanese related packages.

Features:

• evil-tutor-ja: Japanese Vimtutor adapted to Emacs+Evil and wrapped in a major mode
• migemo: Japanese incremental search through dynamic pattern expansion
• helm-migemo-mode: helm with migemo
• avy-migemo: avy with migemo
• ddskk: Simple Kana to Kanji conversion program (SKK)
• japanese-holidays: calendar functions for the Japanese calendar
• pangu-spacing: emacs minor-mode to add space between Japanese and English characters.
• Join consecutive Japanese lines into a single long line without unwanted space when exporting org-mode to html.

+intl/keyboard-layout/README.org

This layer configures some key bindings in Spacemacs, to make it compatible with keyboard layouts that differ from the traditional en-us QWERTY layout.

Features:

• Support alternative keyboard layouts within Spacemacs
• Remap navigation commands to the homerow of your chosen layout
• Remap missing commands automatically to elsewhere in the layout

+misc/copy-as-format/README.org

This layer adds support for copy-as-format.

Features:

• Function to copy buffer locations as GitHub/Slack/JIRA/HipChat/… formatted code

+misc/dtrt-indent/README.org

This is a simple layer wrapping the dtrt-indent Emacs package for automatic detection and switching of indentation style.

It is automatically enabled using the method suggested here.

Features:

• Indentation style detection and automatic configuration to match file in open buffer.

+misc/ietf/README.org

The IETF layer collects various useful packages for participating in the Internet Engineering Task Force (https://www.ietf.org).

Features:

• Fetching and opening IETF documents.
• Viewing IETF documents.
• Writing IETF documents.

+misc/multiple-cursors/README.org

Features:

• support for multiple cursors.

+misc/nav-flash/README.org

This layer adds nav-flash package which temporarily highlights the line containing the point, which is sometimes useful for orientation after a navigation command.

Features:

• Fancy flashing line on navigation.

+misc/parinfer/README.org

This layer provides an implementation of parinfer, a lisp editing paradigm that controls indentation based on parentheses or vice versa.

Features:

• Automatic management of parenthesis in Clojure, Emacs Lisp, Common Lisp and Scheme following the parinfer editing paradigm.
• Powered by a native library in the background

+spacemacs/spacemacs-completion/README.org

This layer does basic setup for completion frameworks like helm, ivy and ido.

Its main role is to ensure sane defaults and consistent UI between helm and ivy because even when you are using only one of them you could still need to use the other (for instance a package that supports only helm).

Advanced configuration of these packages can be found in their respective layers in +completion layer directory.

Features:

• Base preconfiguration of helm and ivy for other layers to use.
• Basic support for ido-navigation configuration and transient state.

+spacemacs/spacemacs-defaults/README.org

This layer configures mostly Emacs built-in packages to given them better defaults.

Features:

• Configures packages:
  • abbrev
  • archive-mode
  • bookmark
  • conf-mode
  • cus-edit
  • dired
  • dired-x
  • display-line-numbers (only in Emacs 26.x and newer)
  • electric-indent-mode
  • easypg
  • ediff
  • eldoc
  • help-fns+ (only in Emacs 27.x and older)
  • hi-lock
  • image-mode
  • imenu
  • occur-mode
  • package-menu
  • page-break-lines
  • process-menu
  • quickrun
  • recentf
  • savehist
  • saveplace
  • subword
  • tar-mode
  • uniquify
  • url
  • visual-line-mode
  • whitespace
  • winner
  • zone

+spacemacs/spacemacs-editing/README.org

This layer adds packages to improve editing with Spacemacs.

Features:

• Support for automatic indentation of code via aggressive-indent.
• Support for jumping to chars using a decision tree via avy.
• Improvements for evaluating sexps via eval-sexp-fu.
• Selecting and editing of multiple text elements via expand-region.
• Support for editing files in hex format via hexl.
• Deletion of consecutive horizontal whitespace with a single key via hungry-delete.
• Support for selecting, copying and opening links using avy via link-hint.
• Adding of sample text via lorem-ipsum.
• Transient state for moving text via move-text.
• Support for folding of code via origami and evil-vimish-fold.
• Support for password generation via password-generator.
• Support for improving parenthesis handling via smartparens.
• Automatic whitespace cleanup on save via spacemacs-whitespace-cleanup.
• Support for converting definitions to certain styles via string-inflection.
• Support for generating UUIDs via uuidgen.
• Support for conversion between Emacs regexps and PCRE regexps.
• Support for persistent scratch via persistent-scratch.
• Support for unkillable scratch via unkillable-scratch.
• Support for sorting (press s) via dired-quick-sort
• Support for evil-easymotion if the editing style is vim or hybrid.
• Support for cycling between multi line block styles via multi-line.
• Support for editing strings inplace via string-edit
• Presents undo history as a tree via undo-tree

+spacemacs/spacemacs-editing-visual/README.org

This layer defines a lot of functions used to visually enhance the currently edited line in Spacemacs.

Features:

• Adaptive wrapping
• Hiding of comments
• Highlighting of columns longer than 80 chars
• Highlighting of different indentations
• Automatic highlighting of numbers
• Automatic highlighting of parentheses
• Adaptive cursor shape in terminal, as it would be in GUI

+spacemacs/spacemacs-evil/README.org

This layer adds various adjustments to packages to create an evilified experience throughout the entirety of Spacemacs.

Features:

• Add evil tutorial with evil-tutor
• Add escaping under fd by default with evil-escape
• Add occurrences count in mode-line when searching a buffer
• Add support for lisp structure manipulation with evil-lisp-state
• Add safe structural editing of lisp dialects with evil-cleverparens
• Add evil-exchange to swap text
• Add easy live editing of multiple occurrences with evil-iedit-state
• Add new vim text objects for indentation with evil-indent-plus
• Add operations to align text with evil-lion
• Easy management of comments with evil-nerd-commenter
• Navigation between pairs with evil-matchit
• Advanced navigation on brackets with evil-unimpaired
• Easy increment and decrement of numbers with evil-number
• Support for additional vim movements via evil-args
• Support for surrounding the marked area with a given character via evil-surround
• Evilification of various modes if the editing style is vim or hybrid
• Improves the comment function to be able to also do the inverse operation
• Persistent highlight of searched text with evil-search-highlight-persist
• Display tildes in non-buffer area with vi-tilde-fringe
• Add evil-collection

+spacemacs/spacemacs-language/README.org

This layer adds support various language related services to Spacemacs.

Features:

• Show definition of word at point via define-word.
• Integration of google-translate into Emacs via google-translate.

+spacemacs/spacemacs-layouts/README.org

This layer adds support for distinct layouts/workspaces to Spacemacs.

Layouts provide an easy way to group buffers for a project or any arbitrary buffer grouping you wish. Layouts also restrict actions to the buffers in the current layout.

Features:

• Support for distinct layouts via eyebrowse
• Integration with helm and ivy to search for buffers within layouts

+spacemacs/spacemacs-misc/README.org

This layer adds some general packages into Spacemacs.

Features:

• Support for jumping to definitions via dumb-jump or evil-goto-definition.
• Support for an easy http request client via request.

+spacemacs/spacemacs-modeline/README.org

This layer adds various mode-lines to Spacemacs.

Features:

• Display of a vim-powerline like mode-line being able to show various information like
  • Current battery status
  • All active minor modes displayed as unicode symbols
  • The active major mode
  • The current branch if the file is in version control
  • The current cursor position
  • The system clock
• Display of a small system monitor in a separate mode-line.

+spacemacs/spacemacs-navigation/README.org

This layer adds general navigation functions to all supported layers.

Features:

• Support for ace-links in
  • spacemacs buffer
  • info-mode
  • help-mode
  • eww-mode
• Support for keeping the cursor centered on the screen
• Evilified version of doc-view-mode
• Tweaks for golden-ratio-mode
• Support for paradox a modern emacs package manager
• Shortcuts for restarting emacs
• Shortcuts for easily switching between windows

+spacemacs/spacemacs-org/README.org

This layer tweaks org-mode to integrate nicely into Spacemacs.

Features:

• Configuration for flyspell to check org-buffers for typos.
• Support for automatically generated Table-Of-Contents via toc-org.
• Support for custom bullet markers via org-superstar.
• Support for a special view mode for org documents via space-doc.

+spacemacs/spacemacs-project/README.org

This layer tweaks projectile to integrate nicely into Spacemacs.

Features:

• Setup of projectile key bindings, including functions for project search, switching, version control and compilation.
• Additional path helper functions, to copy the location of a buffer relative to the project root.

+spacemacs/spacemacs-purpose/README.org

This layer enables window-purpose, which provides an alternative, purpose-based window manager for Emacs. With this layer, your window layout should be robust and shouldn't change too much when opening all sorts of buffers.

Regular popwin is not triggered when window-purpose is enabled. However, the window-purpose layer provides a purpose-popwin extension, which brings popwin's behavior to window-purpose and solves that problem.

Features:

• Window layout is more robust and less likely to change unintentionally
• Dedicate window to a purpose
• User-defined purposes
• Extensible window display behavior
• Empty purpose-mode-map, to avoid conflicts with other key maps
• Replicate popwin behavior for purpose-mode - almost no regression in popup behavior from using window-purpose.
• Reuses popwin's settings: popwin:special-display-config, popwin:popup-window-height and popwin:popup-window-width.
• Difference from popwin: when several windows are open, popup window is sometimes bigger than with regular popwin in the same situation.

+spacemacs/spacemacs-visual/README.org

This layer adds various modes to enhance Spacemacs visual appearance.

Features:

• Automatic colorization of compilation buffers via ansi-colors.
• Support for resuming the last layout when starting Spacemacs via desktop.
• Support for showing a thin vertical line to indicate the fill column via fill-column-indicator.
• Automatic highlighting of TODO-tags in programming and text modes via hl-todo.
• Support for temporary windows which close automatically via popwin.
• Support for text zooming via zoom-frm.

+lang/alda/README.org

Alda is a music composition language allowing music to easily be written and edited in a text file.

This layer adds key bindings for alda-mode's functions, which allow Alda code to be interpreted and played by the running Alda server. It will also start the Alda server if it is not running.

Features:

• Syntax highlighting for Alda files.
• Play portions of a buffer, or the entire buffer, through a running Alda server.

+lang/extempore/README.org

This layer adds support for the Extempore programming environment.

Features:

• run Extempore (inferior extempore buffer)
• connect to & evaluate code
• eldoc support

+music/pianobar/README.org

This layer integrates an online music service into Spacemacs.

Features:

• Support for listening to music from within Emacs via Pianobar.

+music/spotify/README.org

This layer integrates an online music service into Spacemacs.

Features:

• Support for listening to music from within Emacs via Spotify.

+music/tidalcycles/README.org

This layer adds a major mode to control TidalCycles, a programming language for live coding.

Features:

• tidal-mode to interact with TidalCycles
• Spacemacs friendly key bindings

+os/nixos/README.org

This layer adds tools for better integration of Emacs in NixOS.

Features:

• Nix-mode using nix-mode
• Automatic formatting via nixfmt
• Auto-completion of NixOS Options using company-nixos-options
• Helm Lookup for NixOS Options helm-nixos-options
• WIP support for LSP backend using rnix-lsp

+os/osx/README.org

Spacemacs is not just Emacs plus Vim. It can have macOS key bindings too! This layer globally defines common macOS key bindings.

Features:

• ⌘ is set to hyper and ⌥ is set to meta
• In dired use gls instead of ls
• Fix separator colors of Spaceline mode-line

+pair-programming/floobits/README.org

This layer adds support for the peer programming tool floobits to Spacemacs.

Features:

• Loading of floobits configuration files with fixed commands
• Creation of floobits workspaces and populating it with content
• Marking of the current cursor position for all users within the current workspace
• Follow recent changes by other users

+readers/dash/README.org

This layer integrates offline API browsers into Emacs. It provides one for macOS, Linux and Windows.

Features:

• Searching for word at point in offline API browser's UI.
• Integration of offline API browser search results in Helm and Ivy.
• Support for dash offline API browser for macOS.
• Support for zeal offline API browser for Linux.

+readers/deft/README.org

This layer adds a search driven note taking system into Spacemacs.

Features:

• Browsing and creating notes with a powerful search function via Deft.
• Integration of org-mode as note editor.
• Configurable list of extensions to recognize as notes.
• Zettelkasten system with zetteldeft

+readers/djvu/README.org

This layer adds support for reading djvu files with spacemacs.

Because of some difficulties, the layer does not lazy load the djvu.el and djvu3.el packages.

Features:

This layer provides a full featured djvu editor by implementing the djvu.el package along with the djvu3 extension (a newer alternative to djvu2.el).

• flexible annotation editing and rendering, covering most (but not all) of djvused annotation definitions
• fast navigation with imenu
• fast search with djvu-occur
• remember last view with djvu-restore
• dark mode

+readers/elfeed/README.org

This layer integrates a web feed reader into spacemacs.

Features:

• Support for reading RSS and Atom feeds directly within emacs via Elfeed.
• Support for managing feeds via org files supplied by elfeed-org.
• Support for displaying feed database content in the browser via web interface.

+readers/epub/README.org

This layer provides support for reading EPUB-formatted eBooks in Spacemacs using the excellent nov.el package.

Features:

• Basic navigation (jump to TOC, previous/next chapter)
• Remembering and restoring the last read position
• Jump to next chapter when scrolling beyond end
• Renders EPUB2 (.ncx) and EPUB3 (<nav>) TOCs
• Hyperlinks to internal and external targets
• Supports textual and image documents
• View source of document files
• Metadata display
• Image rescaling

+readers/pdf/README.org

This layer enables support for PDF with the pdf-tools package.

According to the official repository:

"PDF Tools is, among other things, a replacement of DocView for PDF files. The key difference is, that pages are not pre-rendered by e.g. ghostscript and stored in the file-system, but rather created on-demand and stored in memory."

Features:

• Searching and slicing with occur.
• Show document headings in outline buffer.
• Manipulate annotations.
• Fit PDF to screen.

+readers/speed-reading/README.org

A speed reading mode for Emacs.

Features:

• Support for speed-reading of arbitrary texts

+tools/languagetool/README.org

This layer adds grammar checking using LanguageTool. LanguageTool will use the language set using SPC S d if the spell-checking layer is enabled.

Features:

• Spelling and grammar checking

+source-control/git/README.org

This layers adds extensive support for git to Spacemacs.

Features:

• git repository management the indispensable magit package
• forge add-on for magit.
• git-flow add-on for magit.
• quick in buffer history browsing with git-timemachine.
• quick in buffer last commit message per line with git-messenger
• colorize buffer line by age of commit with smeargle
• git grep with helm-git-grep
• org integration with magit via orgit

New to Magit? Checkout the official intro and Practicalli Spacemacs guide to configuring and using the Git and version control layers.

+source-control/perforce/README.org

This layer integrates Perforce SCM system into Spacemacs.

Features:

• Support for running Perforce (p4) SCM commands directly from Emacs.

+source-control/version-control/README.org

This layers adds general configuration for Emacs VC. It should work with all VC backends such as Git, Mercurial, Bazaar, SVN, etc…

Features:

• highlights uncommitted changes in the fringe or margin with diff-hl, git-gutter, or git-gutter+
• adds vcs transient-state SPC g. to allow quick navigation and modification of buffer hunks.

+tags/cscope/README.org

This layer provides bindings for using Cscope and PyCscope in Spacemacs.

See here for a comparison between Cscope and other similar tools (such as gtags).

Features:

• Tag indexing and searching for C-C++ via Cscope
• Tag indexing and searching for python via PyCscope

+tags/gtags/README.org

counsel-gtags, helm-gtags and ggtags are clients for GNU Global. GNU Global is a source code tagging system that allows querying symbol locations in source code, such as definitions or references. Adding the gtags layer enables both of these modes.

Features:

• Select any tag in a project retrieved by gtags
• Resume previous helm-gtags session
• Jump to a location based on context
• Find definitions
• Find references
• Present tags in current function only
• Create a tag database
• Jump to definitions in file
• Show stack of visited locations
• Manually update tag database
• Jump to next location in context stack
• Jump to previous location in context stack
• Jump to a file in tag database
• Enables eldoc in modes that otherwise might not support it.
• Enables company complete in modes that otherwise might not support it.

+themes/colors/README.org

This layer colors your life by enhancing the existing coloration of identifiers as well as providing you with a more colorful process indicator.

Features:

• Colorize all identifiers (Christmas tree mode :-)) with mostly unique colors, and the ability to choose saturation and lightness with rainbow-identifiers.
• Colorize only identifiers recognized as variables with color-identifiers.
• Colorize strings representing colors with the color they represent as background with rainbow-mode.
• Display a Nyan cat progress bar in the mode-line with nyan-mode.

+themes/colors/local/nyan-mode/README.org

Nyan Mode - Turn your Emacs into Nyanmacs! :) The mode is an analog indicator of your position in the buffer. The Cat should go from left to right in your mode-line, as you move your point from 0% to 100%.

Features:

• Mind dumbing content included,
• Experimental animation (M-x nyan-start-animation, M-x nyan-stop-animation),
• Wavy rainbow (M-x set-variable <ret> nyan-wavy-trail <ret> t),
• Music, mplayer is needed (M-x nyan-start-music, M-x nyan-stop-music),
• Customizable properties.

+themes/themes-megapack/README.org

This layer installs around 100 themes for Emacs.

Features:

• Have access to all included themes in this theme gallery from Rob Merrell.
• Easily try a theme by invoking helm-themes with: SPC T s.

+themes/theming/README.org

This layer allows for a simple way of modifying themes.

Features:

• Modify themes from your .spacemacs.
• Tweak face attributes and other aspects of themes.
• Includes three additional layer variables for tweaking headings.

+tools/ansible/README.org

This layer adds support for editing Ansible configuration files in Spacemacs.

Features:

• Syntax highlighting for Ansible-flavored YAML and Jinja2 templates.
• Auto-completion via company-ansible.
• Integration of ansible-vault into emacs for automatic encryption/decryption of files.

+tools/apache/README.org

This layer adds support for configuring the Apache web server.

Features:

• Syntax highlighting of apache configuration files via apache-mode.
• Syntax-aware indentation

+tools/bm/README.org

bm provides visible, buffer local, bookmarks and the ability to jump forward and backward to the next bookmark.

Features:

• Auto remove bookmark after jump to it by bm-next or bm-previous
• Cycle through bookmarks in all open buffers in LIFO order
• Toggle bookmarks. Jump to next/previous bookmark.
• Setting bookmarks based on a regexp. (Useful when searching logfiles.)
• Mouse navigation.
• Annotate bookmarks.
• Different wrapping modes.
• Different bookmarks styles, line-only, fringe-only or both.
• Persistent bookmarks (buffer local), also in non-file buffers (info) and indirect buffers.
• List bookmarks (in all buffers) in a separate buffer.
• Cycle through bookmarks in all open buffers.

+tools/cfengine/README.org

This layer adds support for CFEngine policies to Spacemacs.

Features:

• Syntax highlighting (CFEngine DSL, Mustache)
• On the fly syntax checking via flycheck integration.
• Auto completion via company integration.
• Execution of cfengine3 SRC blocks in org-mode via ob-cfengine3 package.

+tools/chrome/README.org

This layer provides some integration with the Google Chrome browser.

Features:

• Edit text boxes with Emacs using edit-server
• Write markdown in Emacs and realtime show in chrome using flymd
• gmail message mode uses standard markdown key bindings

+tools/cmake/README.org

This layer adds support CMake scripts.

Features:

• Syntax highlighting
• Auto-completion
• Support for CMake configure/build (with limited support for other build systems) and automatic generation of compile_commands.json (compile flags).
• Run selected test using Helm interface via helm-ctest.
• Extraction of compile parameters from compile_commands.json with cmake-ide

+tools/command-log/README.org

This layer adds handy commands for demonstrating Spacemacs.

Features:

• Support for logging all entered keys and triggered commands in a designated buffer via command-log-mode.
• Experimental support for logging the last command directly in the mode line via keycast.
• Provides the best way to demonstrate the connection between keystrokes and commands in Emacs.
• Provides an easy way to create command logs for training classes.

+tools/dap/README.org

Experimental integrated visual debugger using Debug Adapter Protocol.

Debug Adapter Protocol is a wire protocol for communication between client and Debug Server. It similar to the LSP but providers integration with debug server.

Features:

Fully featured IDE-like debugger providing:

• Launch/Attach
• Breakpoints
• Exceptions
• Pause & Continue
• Step In/Out/Over
• Callstacks
• Threads
• Multiple simultaneous debug sessions
• Evaluating statements
• Debug/Run configurations
• Debug REPL

+tools/debug/README.org

This layer adds interactive debuggers for multiple languages using realgud.

Features:

• Modern rewrite of the Emacs GUD debugger family
• Visual interface including breakpoint and line indicators
• Advanced features like stack frame navigation and mouse support
• Extensible framework for adding your own external debuggers

+tools/docker/README.org

This layer integrates basic container management into Spacemacs.

Features:

• Syntax highlighting for Docker files
• Docker build integration
• TRAMP access to running Docker containers
• Docker container and image management via docker.el
• docker-compose integration via docker.el
• Syntax checking via hadolint
• Code-Completion via lsp

+tools/eglot/README.org

This layer adds support for basic language server protocol packages speaking language server protocol using eglot.

Features:

• Provide LSP support using eglot.

+web/eww/README.org

Ewww.. So ergonomic!

Features:

• Adds evil key bindings support to eww-mode (including eww-buffers/bookmarks/history-mode)
• Adds spacemacs functionality to eww-mode
• Adds ability to easily navigate eww buffers

+window-management/exwm/README.org

Thanks to @ch11ng and his EXWM project we can now use Emacs as our window manager, that means that you can spawn a Browser Window, or your music player, or anything.

Features:

• Support for using Emacs as window manager

+tools/fasd/README.org

This layer integrates the fasd command line tool into Spacemacs.

Features:

• Adds easy shortcuts to reference recent files and directories.
• Provides fasd with recent open file lists from Emacs.
• Allows to filter fasd results with helm or ivy.

+tools/finance/README.org

This layer integrates a full fledged accounting system into Spacemacs.

Features:

• Support for maintaining a double-entry accounting system run by text files via ledger-mode.
• Display of finance reports directly within Emacs.
• Integration of Emacs calculator mode for editing post amounts.
• Support for easy account reconciliation via Ledger-Reconcile.
• Extended support for evil style editing with evil-ledger.

+tools/geolocation/README.org

This layer offers location sensitive adjustments to Emacs.

Features:

• Supports the following adjustments:
  • Automatic switching between light (day) and dark (night) themes via theme-changer
  • Local weather forecast via sunshine
  • Integration with macOS's CoreLocation service via osx-location
  • Manual location setting via variables in your dotfile

+tools/imenu-list/README.org

This layer uses imenu-list to show the current buffer's index in a side bar.

This is similar to `SPC j i` but displayed in a persistent sidebar instead of a completion buffer.

Features:

• IDE like outline view of current buffer showing all significant symbols in one view

+tools/import-js/README.org

This layer adds support for import-js

Features:

• Import Javascript/Typescript modules to buffer
• Import missing modules and remove unused one
• Go to module location

+tools/kubernetes/README.org

This layer provides the kubernetes-el package, a magit-style interface to the Kubernetes command-line client.

Features:

• Live-updating lists of kubernetes resources
• Viewing and deleting pods, configmaps and secrets
• Switching contexts and namespaces.
• Showing logs and exec'ing into containers
• Describing pods
• Tramp support for pods
• Evil bindings

+tools/lsp/README.org

This layer adds support for basic language server protocol packages speaking language server protocol.

Different language servers may support the language server protocol to varying degrees and they may also provide extensions; check the language server's website for details. M-x lsp-describe-session in a LSP buffer to list capabilities of the server.

Warning: This layers main purpose is to turn Spacemacs into an IDE it will therefore also load the syntax-checking and auto-completion layers, this may activate additional packages like flycheck and company in your buffer.

So if you want to use this layer but only part of the IDE features expect to do some manual configuring in your dotfile.

Features:

• Cross references (definitions, references, document symbol, workspace symbol search and others)
• Workspace-wide symbol rename
• Symbol highlighting
• Flycheck
• Completion with LSP
• Signature help with eldoc
• Symbol documentation in a child frame (lsp-ui-doc)
• Navigation using imenu
• Consistent core key bindings in LSP modes
• Code folding (lsp-origami)

+tools/meson/README.org

This layer adds support Meson scripts.

Features:

• Support for meson build scripts through meson-mode.
• Syntax highlighting.

+tools/nginx/README.org

This layer adds support for configuring nginx a powerful alternative for the Apache web server.

Features:

• Syntax highlighting of nginx configuration files via nginx-mode.
• Syntax-aware indentation

+tools/node/README.org

This layer introduces packages that target Node.js. Currently this layer should not be used directly, as it will be used by other layers.

Features:

• Integration of packages necessary to execute node.js modules from other layers.

+tools/pandoc/README.org

This layer adds support for Pandoc.

Pandoc is a universal document converter. It makes it easy to e.g. convert a Markdown file to org mode or vice versa. It can also export your text to PDF or DOCX.

Features:

• Mode independent document conversions via global pandoc menu
• Org-export integration via ox-pandoc

+tools/pass/README.org

This layer adds integration with pass, the unix password manager. You must have pass installed and available in your path for this layer to function properly.

Features:

• Use Spacemacs as your password manager
• Support for OTP via (password-store-otp)
• Use password-store as an Emacs auth source (auth-source-pass) See its info page for more details on using it.

+tools/prettier/README.org

This layer adds support for prettier

Features:

• Format buffer in a consistent style

+tools/prodigy/README.org

This layer adds support for the prodigy package to manage external services from within Emacs, check the package's documentation for more details.

It is recommended to put your prodigy services in the dotspacemacs/user-config part of your ~/.spacemacs file.

Features:

• Managing of pre-declared services from within Emacs
• Showing of process output in special buffers
• Filtering of processes for tags or names

+tools/puppet/README.org

This layer provides support for the Puppet DSL to Spacemacs.

Features:

• Syntax highlighting via puppet-mode
• Syntax-checking via puppet-lint
• Navigation commands to jump between blocks
• Applying the content of the current manifest directly from Emacs

+tools/ranger/README.org

This layer brings Ranger features to spacemacs from the ranger package.

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

To use ranger/deer by default set ranger-override-dired to ranger/deer like shown in the example below (setting this via customize as explained by the original ranger installation instructions will not work). To default with preview enabled when entering ranger set ranger-show-preview to t. The following example code shows how you can set both variables at once via the dotspacemacs-configuration-layers of your dotfiles as follows:

(setq-default dotspacemacs-configuration-layers
              '(ranger :variables
                       ranger-override-dired 'ranger
                       ranger-show-preview t))

Features:

• use ranger to display dired with ranger like preview and stacked parent windows.

+tools/rebox/README.org

This layer adds support for rebox2 package which is a minor-mode allowing to easily add ASCII text boxes to a buffer.

A nice video demonstration by the package author can be found here.

Features:

• Auto-wrap correctly in comments,
• Auto-fill correctly in comments,
• Boxes auto-adapt as text is inserted or deleted,
• S-RET to continue a comment on the next line,
• Kill/yank within the box,
• Apparently works well with ancient filladpt-mode (see authors video).

+tools/restclient/README.org

This layer provides a REPL-like interface for http requests.

Features:

• REPL for http requests via restclient
• Alternative org integration via ob-http

+tools/salt/README.org

This layer provides syntax highlighting for Saltstack files.

Features:

• Syntax highlighting
• Display of salt documentation

+tools/shell/README.org

This layer configures the various shells available in Emacs.

Features:

• Shell integration
• Running external terminal emulator in current/project directory

+tools/sphinx/README.org

The layer adds support for the documentation generation system Sphinx to the restructuredtext layer.

Features:

• Support for Sphinx project compilation
• Support for opening Sphinx project target
• Support for opening Sphinx config file

+tools/systemd/README.org

This layer adds support for editing systemd configuration files in Spacemacs.

Features:

• Syntax highlighting
• Auto completion
• Syntax checking via systemd-analyze
• Viewing systemd system and user unit via journalctl-mode

+tools/tern/README.org

This layer adds support for tern stand-alone code-analysis engine for JavaScript.

Features:

• TODO: list the feature of tern supported by tern package

+tools/terraform/README.org

This layer provides basic support for Terraform .tf files.

Features:

• Basic syntax highlighting via terraform-mode
• Auto formatting on save via terraform fmt
• LSP support for terraform-lsp via terraform-backend

+tools/tide/README.org

This layer installs tide package which allows communication with standalone typescript server tsserver for JavaScript/TypeScript development.

Features:

• First class support from tsserver just like vscode: speed and accuracy
• Linter
• Refactor
• Go to definition
• Find references

+tools/tmux/README.org

This layer adds basic tmux key bindings to Spacemacs.

Features:

• Calling of tmux navigation commands directly from Emacs via evil-tmux-navigator.

+tools/translate/README.org

This layer is designed for Paragraph-oriented minor mode for side-by-side document translation workflow.

Features:

• Paragraph-oriented side-by-side document translation workflow
• Integrate word/paragraph online translation

+tools/transmission/README.org

This layer integrates a BitTorrent client into Spacemacs.

Features:

• Integration of Transmission into Emacs.

+tools/tree-sitter/README.org

This layer integrates Emacs Tree-sitter and a few packages built around it. An Emacs build supporting dynamic modules is required.

Language (i.e. major-mode) support is somewhat limited and varies by feature. Refer to the README/documentation of the package providing the feature for specifics.

Features:

• Syntax highlighting
• Indentation (experimental)
• Folding (experimental)

+tools/vagrant/README.org

This layer adds support for working with Vagrant using vagrant.el and vagrant-tramp.

Features:

• Manage boxes (under the SPC a t v prefix)
• Remote editing on Vagrant boxes via Tramp

+tools/web-beautify/README.org

This layer adds support for web-beautify.

Features:

• Format buffer to be beautiful

+tools/xclipboard/README.org

xclipboard integration layer.

Features:

• adds copy support to the X-clipboard from the terminal.
• adds paste support to the X-clipboard from the terminal.
• cliphist package: integration with clipboard managers on Linux and macOS.

+vim/evil-better-jumper/README.org

This layer adds support for better-jumper. A configurable jump list implementation for Emacs that can be used to easily jump back to previous locations.

Features:

• jump back and forth

+vim/evil-commentary/README.org

This layer replaces evil-nerd-commenter with evil-commentary for those who prefer the behaviour of vim-commentary.

Features:

• Provides the original vim behaviour for commenting out lines via evil-commentary.

+vim/evil-snipe/README.org

This layer adds various replacements for vim's default search functions.

Features:

• Alternative implementation of vim's default search operations.
• Replacement of evil-surround with a two-character search.
• Support for alternative scopes for default search operations.
• Support for alternative motions based on configurable regexps.

+vim/vim-empty-lines/README.org

This layer is a drop-in replacement for the vi-tilde-fringe mode, for those who desire behaviour closer to vim's.

It has better compatibility with retina displays, as it uses a text overlay using your font, rather than a pixel-art tilde. The empty line indicators are overlaid in within the buffer as in vim, and not in the fringe. The indicator behaviour with trailing empty lines matches vim's behaviour.

For details, see the vim-empty-lines-mode repository.

Features:

• Emulation of original vim behaviour.
• Brings you as close to vim as one can be without using vim itself.

+vim/vinegar/README.org

This layer is a port of vim-vinegar for Emacs.

It is based on tpope's vinegar.vim, simplifying dired with a limited number of details and exposing the - command in all buffers to enter dired.

Features:

• navigation up folders with - key
• simplify dired buffer to show only file names
• better evil/vim bindings for navigation within dired buffer
• keep only one active dired buffer
• Use dired-k extension to show time / vcs related information in single bar
• right mouse click moves up directory if in blank space or shows context menu

+web-services/confluence/README.org

This layer adds support for Atlassian Confluence.

Features:

• Creating/editing of Confluence pages
• Exporting of org buffers to Confluence wiki format

+tools/eaf/README.org

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

+web-services/evernote/README.org

This layer adds support for the famous Evernote note taking service to Spacemacs. It does so by grouping together various packages to work with Evernote.

Features:

• Create notes in markdown and sync with Evernote via geeknote.
• Search for notes using keywords
• Move notes between notebooks

+web-services/github-copilot/README.org

This layer enables usage of GitHub Copilot in Spacemacs using copilot.el.

Features:

• Provide access to ai powered code completions powered by GitHub Copilot

+web-services/hackernews/README.org

This layer adds support for reading Hacker News.

Features:

• Read Hacker News

+web-services/llm-client/README.org

This layer enables usage of GPT Clients in Spacemacs using GPTel.

Features:

You will have access to the following tools:

• ChatGPT
• Azure
• Ollama
• GPT4All
• Gemini
• Llama.cpp
• Llamafile
• Kagi FastGPT
• Kagi Summarizer
• together.ai
• Anyscale
• Perplexity
• Anthropic (Claude)
• Groq

+web-services/reddit/README.org

This layer adds Reddit support to Spacemacs via the package reddigg. This package allows you to browse reddit in org-mode.

Features:

• Activities on Reddit
  • Viewing main
  • Viewing sub
  • Viewing comments

+web-services/lobsters/README.org

This layer adds support for reading lobsters.

Features:

• Read Lobsters news

+web-services/openai/README.org

This layer provides applications to make requests to openai via its API.

Features:

• Provides access to openai via the emacs-openai suite of packages
• Send visual selection or buffer and receive response in current buffer
• Improve, edit, and document code
• Chat sessions with chatgpt
• Obtain AI generated images

+web-services/pocket/README.org

This layer adds Pocket support to Spacemacs via the package pocket-reader.

Features:

• Manage reading list: add, remove, delete, tag, view, favorite, etc.
• Open links in Emacs or external browser
• Sort views by date, title, domain, tags, favorite, etc.
• Search items by keywords, tags, favorite status, unread/archived status, etc.

+web-services/search-engine/README.org

This layer adds support for the Search Engine package.

Features:

• Browser search integration

+web-services/streamlink/README.org

This layer adds support for opening URLs in streamlink.

Features:

• Open URL with streamlink

+web-services/twitch/README.org

This layer adds support for twitch. You can search for streamers and open the stream in the browser. You are also able to connect to twitch irc and join the streamer channel.

Features:

• Connect to Twitch irc via erc
• Join streamer channel
• Start watching stream via streamlink

+web-services/twitter/README.org

This layer adds Twitter support to Spacemacs via the package twittering-mode.

Features:

• Activities on Twitter
  • Viewing various timelines
    • Home timeline
    • Replies
    • User's timeline
    • Public timeline
    • Favorites timeline
    • Retweets timeline
    • Merged timeline
    • Timeline without tweets satisfying a condition
  • Posting tweets
    • Direct message
    • ReTweet
    • Hash tag
    • Signature
  • Following and removing users
  • Marking tweets as favorites
• HTTP Proxy support
• Secure connection via HTTPS (cURL, GNU Wget, OpenSSL or GnuTLS is required)

+web-services/wakatime/README.org

This layer adds support for Wakatime.

WakaTime was built to solve time tracking for programmers. Since we work inside a text editor, why should we have to start and stop a timer? WakaTime uses open-source text editor plugins to automatically track the time you spend programming so you never have to manually track it again!

P.S. wakati means time in Swahili

Features:

• Integration with Wakatime cloud based time tracking service