svn-viewer 0.1.3

A terminal UI browser for SVN repositories, with syntax highlighting and image preview

svn-viewer

A terminal UI browser for SVN repositories, with syntax highlighting and image preview (Kitty graphics protocol).

GitHub: https://github.com/hanxi/svn-viewer

Features

• 📂 Browse SVN repository directories interactively in the terminal
• 📄 Preview text files with syntax highlighting (powered by Pygments)
• 🖼️ Preview image files using the Kitty graphics protocol (requires a compatible terminal such as Kitty or Ghostty)
• ⌨️ Vim-style keyboard navigation (j/k, h/l, esc, enter)
• 🔍 Debounced preview loading to keep navigation snappy

Requirements

• Python >= 3.14
• A terminal that supports the Kitty graphics protocol (e.g., Kitty, Ghostty)
• svn command-line client installed and available in PATH

Installation

Install from PyPI:

pip install svn-viewer

Or clone and install locally for development:

git clone https://github.com/hanxi/svn-viewer.git
cd svn-viewer
pip install -e .

Usage

Run directly without installing (via uv):

uvx svn-viewer <svn_url>

Or if installed via pip:

svn-viewer <svn_url>

Example:

uvx svn-viewer https://svn.apache.org/repos/asf/

Keyboard Shortcuts

Key	Action
j / ↓	Move cursor down
k / ↑	Move cursor up
enter / → / l	Enter directory
esc / ← / h	Go back to parent directory
d / Page Down	Scroll preview down
u / Page Up	Scroll preview up
q	Quit

License

This project is licensed under the MIT License.