Skip to content
Keep your text centered when there's only one window.
Emacs Lisp Makefile
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Add circleci configuration Nov 27, 2017
.github Add GitHub issue template May 10, 2017
img Update README Apr 2, 2017
.gitignore Experimental frame padding Apr 2, 2017
Cask Experimental frame padding Apr 2, 2017
Makefile Experimental frame padding Apr 2, 2017 Ensure package name is written correctly to be installed with "use-pa… Mar 29, 2018
centered-window-mode-test.el Experimental frame padding Apr 2, 2017

NOTE: Due to a lack of time to solve the issues of this project and the responsabilities derived from my recent paternity, I’m looking for someone to transfer the ownership of the project and who’s willing to keep working in it.

Centered Window Mode

Global minor mode that centers the text of the window. If another window is visible the text goes back to normal if its width is less than cwm-centered-window-width.

You may want to activate visual-line-mode if your lines go out of reach.



Manual installation

First, download centered-window-mode.el in your emacs load path.

Then, to make it available, add this to your configuration file:

(require 'centered-window-mode)

Installation via el-get

If you use el-get, the emacs package manager, simply add centered-window-mode to your packages list.

Installation via use-package

If you use use-package, simply add the following to your init file.

(use-package centered-window :ensure t)



Simply type M-x centered-window-mode in any buffer.


To make this permanent, add this to your emacs configuration file:

(require 'centered-window-mode)
(centered-window-mode t)

Vertical padding

Adding vertical padding to an Emacs window is kind of hard, I have tried a lot of different solutions but most of them add a lot of complexity and source of bugs to the mode. Currently there are the options cwm-use-vertical-padding (default nil, set to t if you want this feature) and cwm-frame-internal-border (default 70) to add some padding to the frame, it’s far from ideal but I have found it at most acceptable for most of the use cases where I need this feature.


Once installed you can easily customize the mode use Emacs’ customization mechanism: M-x customize-group<RET>centered-window-mode


Copyleft (ɔ) Anler Hernández Peral

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

You can’t perform that action at this time.