Skip to content

isene/scroll

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Scroll - Terminal Web Browser

Rust License Platform Binary Stay Amazing

A keyboard-driven terminal web browser with inline image display, tabs, form handling, bookmarks, and AI page summaries. Vim-style keybindings. Feature clone of brrowser.

Built on crust (TUI) and glow (images). Single binary, ~4.8MB.


Quick Start

# Download from releases (Linux/macOS, x86_64/aarch64)
# Or build from source:
git clone https://github.com/isene/scroll
cd scroll
cargo build --release

# Browse a website
scroll isene.org

# Search
scroll g rust terminal browser

# Open local file
scroll file:///path/to/page.html

Press ? for built-in help. Press q to quit.


Screenshots

Browsing with inline images Reading an article
Blog with images Article view

Key Features

  • HTML rendering: Headings, paragraphs, lists, links, tables, code blocks, blockquotes, forms
  • Inline images: Kitty graphics protocol, sixel, or ASCII art via chafa (auto-detected by glow)
  • Tabs: Create, close, undo close, cycle with J/K
  • Back/forward navigation: Per-tab history with H/L keys
  • Forms: Fill fields, auto-fill from stored passwords, submit via GET/POST
  • Bookmarks and quickmarks: Save/recall with b/B and m/'/keys
  • Page search: / to search, n/N for next/prev match
  • Link following: TAB to cycle links (shown in reverse), ENTER to follow, or type link number
  • Site colors: Extracts background/foreground from HTML/CSS, applies to content pane
  • Cookies: Persistent cookie storage
  • AI summaries: OpenAI GPT page summarization (I key)
  • Preferences: Interactive popup (P key) with 20 configurable settings including colors
  • Search engines: Google (g), DuckDuckGo (ddg), Wikipedia (w)
  • Downloads: :download URL command
  • Clipboard: Copy URL (y) or focused link (Y) via OSC 52

Keyboard Reference

Scrolling

Key Action
j/k, Down/Up Scroll line
Space, PgDn/PgUp Page down/up
gg Go to top
G, End Go to bottom
Ctrl-D/Ctrl-U Half page down/up
</> Scroll left/right

Navigation

Key Action
o Open URL
O Edit current URL
t Open in new tab
H, Backspace Go back
L, Delete Go forward
r Reload

Tabs

Key Action
J, Right Next tab
K, Left Previous tab
d Close tab
u Undo close

Links & Forms

Key Action
TAB / S-TAB Cycle to next/prev link
ENTER Follow focused link or enter link number
f Fill and submit form
y Copy page URL
Y Copy focused link URL

Search & Bookmarks

Key Action
/ Search page
n / N Next/prev match
b Bookmark page
B Show bookmarks
m + key Set quickmark
' + key Go to quickmark

Other

Key Action
i Toggle images
I AI page summary
P Preferences popup
Ctrl-L Force redraw
: Command mode
? Help
q Quit

Commands

Command Action
:open URL / :o URL Navigate
:tabopen URL / :to URL Open in new tab
:back / :forward History navigation
:close / :q Close tab
:quit / :qa Quit
:reload Reload page
:bookmark / :bm Bookmark current page
:bookmarks / :bms List bookmarks
:download URL / :dl URL Download file
:help Show help

Configuration

Settings stored in ~/.scroll/:

  • config.json - All preferences (colors, homepage, search engine, image mode)
  • bookmarks.json - Saved bookmarks
  • quickmarks.json - Quick access marks (key to URL)
  • passwords.json - Stored credentials (chmod 600)
  • cookies.json - HTTP cookies

Image Modes

Mode Method Quality
auto Best available (kitty > sixel > w3m > chafa) Full color
ascii chafa ASCII art Text-based
off No images Fastest

Change via Preferences (P key) or edit config.json.

Dependencies

Runtime (optional, for full features):

  • chafa - ASCII art image fallback
  • ImageMagick (convert) - Image scaling for kitty/sixel
  • curl - AI summary feature

Part of the Fe2O3 Rust Terminal Suite

Tool Clones Type
rush rsh Shell
crust rcurses TUI library
glow termpix Image display
plot termchart Charts
pointer RTFM File manager
scroll brrowser Web browser
crush - Rush config UI

License

Unlicense - public domain.

Credits

Created by Geir Isene (https://isene.org) with extensive pair-programming with Claude Code.

About

Rust terminal web browser. Feature clone of brrowser with vim keys, images, tabs, and forms.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages