Skip to content

Optimize your Emacs experience with emacs-leuven -- a pre-configured package with improved defaults for enhanced productivity. #emacs #texteditor #coding #productivity #configuration #orgmode

License

Notifications You must be signed in to change notification settings

fniessen/emacs-leuven

Repository files navigation

Boost your productivity with a preconfigured Emacs setup!

:license-gpl-blue.svg btn_donate_LG.gif

Tip

Transform your Emacs experience in Paris from 24 to 28 November 2025!

Unlock unparalleled productivity with my exclusive “EmacsBoost” course!*

Are you ready to supercharge your productivity and become an unstoppable Emacs ninja? This is the opportunity you’ve been waiting for!

What you’ll learn:

  • Expertly master Emacs from the ground up to advanced techniques that set you apart.
  • Maximize your editing efficiency and elevate your workflow to new heights.
  • Personalize Emacs to perfectly fit your unique style and needs.
  • And much more tips and tricks!

Who should join:

This course is designed for everyone passionate about Emacs – from curious beginners to seasoned users looking to refine their skills.

Why choose my course?

  • Learn from an expert instructor with over 26 years of Emacs mastery.
  • Engage in dynamic hands-on exercises that reinforce and enhance your learning journey.
  • Enjoy exclusive networking opportunities with fellow Emacs enthusiasts who share your passion.
  • Experience personalized guidance tailored just for you.

Seize this exceptional opportunity to elevate your Emacs skills to new levels!

Visit https://emacsboost.com/en/ for more details, course dates and locations, and to secure your place today.

Emacs Leuven: Boost your productivity

Looking for an Emacs configuration file with numerous pre-enabled packages and a more user-friendly default setup? Look no further! This resource will spare you countless hours of manual configuration.

Introducing the ”Emacs Leuven” configuration file, packaged as an Emacs Lisp library and ready for your use. It’s finely tuned for a swift Emacs startup time – typically around 2 seconds!

Installation

Adding the Emacs Leuven library to your Emacs environment is straightforward:

  • Download or clone the Emacs-Leuven repository from GitHub.
  • Integrate Emacs-Leuven into your Emacs configuration file:
    ;; Ensure that `emacs-leuven' libraries are included in your Emacs
    ;; `load-path'.
    (add-to-list 'load-path "/PATH/TO/emacs-leuven/lisp")
    
    ;; Load Emacs-Leuven and its associated modules.
    (require 'emacs-leuven)
    (require 'emacs-leuven-org)
    (require 'emacs-leuven-bbdb)
    (require 'emacs-leuven-ess)
    (require 'emacs-leuven-ledger)
    
    ;; Customize your settings here, which can override the defaults provided by
    ;; Emacs-Leuven.
        
  • Restart Emacs to apply the changes.

Packages

To effortlessly install all the additional packages referenced below without prompts, insert the following line before requiring Emacs-Leuven:

;; Install all extra Emacs packages without asking for confirmation.
(setq leuven-install-all-missing-elpa-packages t)
SubjectPackageDescription
Basic editing commandsundo-tree
Helpinfo+
The mark and the regiongoto-chg
expand-region
multiple-cursors
ace-jump-mode
ace-link
Controlling the displaypager
fancy-narrow
highlight-symbol
color-identifiers-mode
diff-hl
ws-butler
powerline
interaction-log
Searching and replacementfuzzy
anzu
Commands for fixing typosdictionary
Files Handlinghelm
helm-swoop
Major and minor modescsv-mode
helm-descbinds
Indentationindent-guide
Commands for human languageskey-chord
boxquote
SGML and HTML modestidy
Editing Programsimenu-anywhere
hideshowvis
flycheck
Maintaining programslitable
git-timemachine
git-messenger
Abbrevsyasnippet
auto-complete
company
company-quickhelp
Gnusbbdb
Document viewingpdf-tools
Running shell commands from Emacsmulti-term
cygwin-mount
google-translate
Customizationguide-key
ace-window
auctex
bookmark+
circe
diminish
dired+
dired-single
ess
fill-column-indicator
flycheck
flycheck-ledger
git-commit-mode
graphviz-dot-mode
htmlize
idle-require
ledger-mode
leuven-theme
rainbow-mode
unbound

To prevent specific packages from being installed or suggested by Emacs Leuven, incorporate a configuration snippet like the following into your Emacs configuration file:

(setq leuven-excluded-packages '(some-useless-package
                                 ...
                                 other-annoying-package))

Supercharge your efficiency with keyboard shortcuts!

Unlock time-saving techniques and enhance your productivity using the Emacs Leuven keyboard shortcuts. Experience a streamlined workflow that puts you in control.

See Emacs key binding conventions.

General

Global key bindings.

ShortcutWhat it runs
<f2>save-buffer
<S-f2>org-save-buffer-and-do-related
<C-f2>(for interaction-log mode)
<f3>find-file (or helm-for-files)
<f4>helm-semantic-or-imenu
<M-f4>save-buffers-kill-terminal
<f7>leuven-babel-translate
<f8>call-last-kbd-macro
<S-f8>leuven-toggle-kbd-macro-recording-on/off
<C-f8>name-last-kbd-macro
<C-f9>leuven-vc-jump
<C-f11>bbdb
<f12>bury-buffer
<S-f12>leuven-kill-this-buffer-without-query
<C-f12>leuven-revert-buffer-without-query

Help

ShortcutWhat it runs
<f1>info
<S-f1>man-follow
<C-f1>info-lookup-symbol

Edit

ShortcutWhat it runs
<f11>undo
C-S-zredo
<S-f11>redo

Windows

ShortcutWhat it runs
<f5>delete-other-windows
<f6>other-window
<C-f6>balance-windows
C-=compare-windows
C-c ~leuven-swap-windows
C-c |leuven-toggle-window-split

Text

ShortcutWhat it runs
<next>pager-page-down
<prior>pager-page-up
M-ùbackward-paragraph
M-*forward-paragraph

Lines

ShortcutWhat it runs
<return>newline-and-indent
C-c ^sort-lines
M-Gwhat-line
<C-S-down>leuven-move-line-down
<C-S-up>leuven-move-line-up

Code folding

ShortcutWhat it runs

Search / Find / Replace

ShortcutWhat it runs
C-c ohelm-occur
C-oleuven–isearch-occur
C-ooccur

Spelling

ShortcutWhat it runs
C-$flyspell-buffer
C-M-$leuven-flyspell-toggle-dictionary

Build

ShortcutWhat it runs
<f9>recompile
<S-f9>make-clean
<f10>next-error
<S-f10>previous-error
<C-f10>first-error

Bookmarks

ShortcutWhat it runs
<C-f2>bmkp-toggle-autonamed-bookmark-set/delete
<S-f2>bmkp-next-bookmark-this-file/buffer-repeat
<C-S-f2>bmkp-delete-all-autonamed-for-this-buffer)
C-x r bhelm-bookmark-ext
C-x r lhelm-bookmarks

Org mode

ShortcutWhat it runs
<S-f2>org-save-buffer-and-do-related
<C-f3>leuven-org-todo-list-current-dir
<f4>helm-org-headlines
<M-f6>visible-mode
C-M-]org-cycle-global ;; <S-tab>
M-]org-cycle-local
C-c lorg-store-link
C-c corg-capture
C-c borg-switchb
C-c aorg-agenda
C-c Lorg-insert-link-global
C-c oorg-open-at-point-global
C-c C-borg-switch-to-agenda
\C-\M-noutline-next-visible-heading
\C-\M-poutline-previous-visible-heading
\C-\M-uoutline-up-heading
C-c C-x forg-footnote-action
C-c C-x C-iorg-clock-in
C-c C-x C-jorg-clock-goto
C-c C-x C-oorg-clock-out
C-c C-x C-qleuven-org-clock-in-interrupted-task
(leuven-org-agenda-toggle-tasks-details
C-c C-eorg-export-dispatch
M-Phtmlize-buffer
C-c C-e h ohtmlize-view-buffer
M-;leuven-org-comment-dwim
C-M-\leuven-org-indent-region
C-c C-v C-dorg-babel-demarcate-block
C-c morg-mime-subtree
C-c mleuven-mail-subtree
Nleuven-org-agenda-new
Zleuven-org-agenda-mark-done-and-add-followup

Dired

ShortcutWhat it runs
<return>dired-single-buffer
<mouse-1>dired-single-buffer-mouse
^(anonymous function)
ebrowse-url-of-dired-file
Ew32-dired-open-files-externally
C-c f 1find-name-dired
C-c f 2find-grep-dired
C-c f 3rgrep

Other shortcuts

I still have to sort them out, by mode (when applicable).

ShortcutWhat it runs
C-c SPCace-jump
C-)match-paren
xleuven-vc-dir-hide-up-to-date-and-unregistered
Evc-ediff
=lvn-vc-diff-buffer-file
M-?etags-select-find-tag-at-point
C-c eecb-minor-mode
M-/hippie-expand
<tab>ac-expand
<scroll-calendar-right
>scroll-calendar-left
<C-down>comint-next-matching-input-from-input
<C-up>comint-previous-matching-input-from-input
<down>comint-next-input
<up>comint-previous-input
<C-backspace>backward-kill-word
<left>speedbar-contract-line
<right>speedbar-expand-line
<S-return>leuven-ess-eval
M–ess-smart-underscore
C-*leuven-hlt-highlight-current-word
C-c !shell
C-c .leuven-insert-current-date
C-c C-ctidy-buffer
C-c C-x nilXXX
C-c bboxquote-region
C-c d ldictionary-lookup-definition
C-c d mdictionary-match-words
C-c d sdictionary-search
C-c g gleuven-google-search
C-c g rleuven-google-search-region
C-c g sgoogle
C-c g wleuven-google-search-word-at-point
C-c n
C-c syas-insert-snippet
C-c ttoggle-truncate-lines
C-c Tmulti-term
C-c ztoggle-full-screen
C-h Aapropos-variable
C-h Eelisp-index-search
C-S-nhlt-next-highlight
C-S-phlt-previous-highlight
C-x bhelm-buffers-list
C-x C-belectric-buffer-list
C-x C-bhelm-mini
C-x pproced
M-o
M-pps-print-buffer-with-faces
M-xhelm-M-x

Contribute to the project!

Report issues and enhancements

Found a bug or have an idea for a new feature? Share your thoughts on the GitHub issue tracker.

Submit patches

Contributions of any kind are welcome! Feel free to submit patches to help improve the project.

Support development with a donation!

If the emacs-leuven project has enhanced your Emacs experience and simplified your workflow, consider showing your appreciation! Help fuel future development by making a donation through PayPal. Your support is invaluable – thank you!

Remember, regardless of donations, emacs-leuven will always remain freely accessible, both as in Belgian beer and as in speech.

License

Copyright (C) 1999-2025 Free Software Foundation, Inc.

Author: Fabrice Niessen
Keywords: emacs configuration file

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

About

Optimize your Emacs experience with emacs-leuven -- a pre-configured package with improved defaults for enhanced productivity. #emacs #texteditor #coding #productivity #configuration #orgmode

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •