GNU-devel ELPA - topspace


Recenter line 1 with scrollable upper margin/padding
topspace- (.sig), 2024-Mar-31, 60.0 KiB
Trevor Edwin Pogue <>
Atom feed
Browse ELPA's repository
CGit or Gitweb

To install this package from Emacs, use package-install or list-packages.

Full description

TopSpace lets you display a buffer's first line in the center of a window
instead of just at the top.
This is done by automatically drawing an upper margin/padding above line 1
as you recenter and scroll it down.

See for a GIF demo & documentation.


- Easier on the eyes: Recenter or scroll down top text to a more
  comfortable eye level for reading, especially when in full-screen
  or on a large monitor.

- Easy to use: No new keybindings are required, keep using all
  your previous scrolling & recentering commands, except now you
  can also scroll down the first line.  It also integrates
  seamlessly with `centered-cursor-mode' to keep the cursor
  centered all the way to the first line.

Old versions

topspace- KiB
topspace- KiB


History of user-visible changes

v0.3.1 (2022-08-24)

Full Changelog

Fixed bugs:

  • Prevent line 1 indicator sometimes displaying too high in linum-mode #22 (trevorpogue)

v0.3.0 (2022-05-13)

Full Changelog

Implemented enhancements:

  • Add topspace-set-height, enhance topspace-center-position #19 (trevorpogue)
  • Add topspace-height function for use by external packages #15 (trevorpogue)
  • Add support for smooth-scrolling package #14 (trevorpogue)

Fixed bugs:

  • Fix unexpected top space height change when echo area height changes #18 (trevorpogue)

v0.2.1 (2022-04-15)

Full Changelog

Fixed bugs:

  • Prevent "Beginning of buffer" error message when scrolling above top #12 (trevorpogue)
  • Fix inability to use scrolling commands interactively #11 (trevorpogue)

v0.2.0 (2022-04-12)

Full Changelog

Implemented enhancements:

  • Put topspace-empty-line-indicator inside left fringe #9 (trevorpogue)
  • Add topspace-empty-line-indicator defcustom #8 (trevorpogue)
  • Add topspace-active, improve topspace-autocenter-buffers #4 (trevorpogue)

Fixed bugs:

v0.1.2 (2022-03-01)

Full Changelog

Fixed bugs: * #2: Make recenter-top-bottom act correctly when it moves point to bottom and top space is added to get there

Other changes:

  • 2584138: Raise topspace-center-position default to a subjectively better position

v0.1.1 (2022-02-22)

Full Changelog

Fixed bugs:

  • 4a69b2e: Allow recenter and recenter-top-bottom to be called interactively without an error
  • 4eb27ab: Prevent top space from all suddenly disappearing when visual-line-mode is enabled and cursor scrolls bellow window-end when top space is present

v0.1.0 (2022-02-19)

Full Changelog ... ...