README.md

March 5, 2026 · View on GitHub

tmux-smooth-scroll logo

tmux-smooth-scroll

Smooth scrolling for tmux—makes scrolling easy to follow.


Installation

Using TPM

Add to ~/.tmux.conf:

set -g @plugin 'azorng/tmux-smooth-scroll'

Press prefix + I to install.

Manual

Clone to tmux plugins directory:

git clone https://github.com/azorng/tmux-smooth-scroll ~/.tmux/plugins/tmux-smooth-scroll

Add to ~/.tmux.conf:

run-shell ~/.tmux/plugins/tmux-smooth-scroll/smooth-scroll.tmux

Reload: tmux source-file ~/.tmux.conf

Configuration

Optional settings in ~/.tmux.conf:

# Speed: 0-1000 | lower = faster
set -g @smooth-scroll-speed "100"

# Easing mode: linear|sine|quad
set -g @smooth-scroll-easing "sine"

# Scroll line distance
set -g @smooth-scroll-normal "3"
set -g @smooth-scroll-halfpage ""  # Default: pane_height / 2
set -g @smooth-scroll-fullpage ""  # Default: pane_height

# Enable on mouse wheel scroll
set -g @smooth-scroll-mouse "true"

# Auto-exit copy mode when scrolling past the bottom
set -g @smooth-scroll-exit-copy-mode-at-bottom "true"