brrowser
The terminal web browser with vim-style keys.
A terminal web browser combining w3m-style rendering with qutebrowser-style keyboard navigation. Renders HTML with styled headings, links, tables, forms, and inline images. No modes, no mouse, just keys.
Features
Browsing: Full HTML rendering, inline images (termpix/chafa), YouTube embeds, tabs, back/forward history, search engines, ad blocking, cookie persistence.
Navigation: vim-style keys (j/k/gg/G), TAB through links and form fields, search with /, bookmarks and quickmarks.
Forms: Fill and submit with auto-fill from stored passwords. Firefox-style save prompt for new logins.
Images: Kitty/sixel/w3m via termpix, ASCII art via chafa. Toggle with i.
AI: Press I for an AI summary of the current page.
Extras: Edit source in $EDITOR, download files, xdg-open for binaries, configurable colors, site color matching.
Installation
gem install brrowserDependencies
Optional: chafa for ASCII art, ImageMagick for image scaling, xclip/xsel/wl-copy for clipboard.
Usage
brrowser # Open this page
brrowser https://example.com # Open URL directly
brrowser isene.org # Auto-adds https://Keybindings
| Key | Action |
|---|---|
| j / k / arrows | Scroll up/down |
| < / > | Scroll left/right |
| Left / Right | Previous/next tab |
| gg / G | Top / bottom of page |
| Ctrl-d / Ctrl-u | Half page down/up |
| Space / PgDn / PgUp | Page down/up |
| TAB / S-TAB | Next/previous link or field |
| Enter | Follow link or edit field |
| o / O | Open URL / edit current URL |
| t | Open URL in new tab |
| H / Backspace | Go back |
| L | Go forward |
| r | Reload page |
| d | Close tab |
| u | Undo close tab |
| / | Search page |
| n / N | Next/previous search match |
| b / B | Bookmark / show bookmarks |
| m + key | Set quickmark (0-9, a-z) |
| ' + key | Go to quickmark (0-9, a-z) |
| f | Fill and submit form |
| y / Y | Copy URL / copy focused element |
| e | Edit page source in $EDITOR |
| Ctrl-g | Edit field in $EDITOR |
| i | Toggle images |
| I | AI page summary |
| p | Show stored password |
| P | Preferences |
| Ctrl-l | Redraw screen |
| ? | Help (detailed) |
| q | Quit |
Commands
Type : to enter command mode.
| Command | Action |
|---|---|
| :open URL / :o | Navigate |
| :tabopen URL / :to | Open in new tab |
| :close / :q | Close tab |
| :quit / :qa | Quit |
| :back / :forward | History navigation |
| :bookmark / :bm | Add bookmark or open by name |
| :bookmarks / :bms | List bookmarks |
| :download / :dl | Download file |
| :adblock | Update ad blocklist |
| :password / :pw | Save password for site |
| :about | Open project GitHub page |
Configuration
Press P for preferences: image mode, homepage, search engine, download folder, all colors.
Data stored in ~/.brrowser/: config.yml, bookmarks.yml, quickmarks.yml, passwords.yml, cookies.yml, adblock.txt
Links
Created by Geir Isene with extensive pair-programming with Claude Code.