Stubb is a text only gopher browser written in Lua. It is built to be lightweight and quick.
Go to file
sloum 0839e1653f Update '' 2019-02-26 12:51:23 -05:00 Update '' 2019-02-26 12:51:23 -05:00
stubb Added support for non-text gophertypes 2019-02-09 11:21:27 -08:00
stubb-lite Added tabs and created a forked lite version 2019-01-05 22:17:15 -08:00


Stubb is a text based gopher client that supports gophertypes: 0 (text) and 1 (gopher map) fully. It offers downloads for other types and offers partial support for type 7 via a default search engine. The program is named for the character Stubb from Moby Dick, known for his imaginative patter and good humor.

Stubb supports bookmarks, tabs, file save, piping to a $PAGER (defaults to less),and session only history (cleared on quit).

Search has been implemented with a default of Veronica2 as the search service.

The command bar lists the current tab number, out of how many total tabs. It also lists the current place in history (for the tab you are currently on).


Stubb has been tested with Lua versions >= 5.1. I had been told that the socket library is buggy on 5.3, but have not experienced any problems myself. Most testing has been done with 5.1 and 5.2.

Luasocket is required. It can be acquired via luarocks with: luarocks install luasocket. You can also get it via github. Using luarocks is recommended as the easier option.

That should take care of dependencies. You just need to make sure that stubb (found in this repo) is executable and you are good to go.


This repo contains two files: stubb and stubb-lite. The later has a simpler menu structure and lacks support for having multiple tabs open. The filesize and memory usage should be similar, but the navigation may involve fewer keypresses in the lite version. The lite version is not under active development and is provided as a legacy item.


Stub responds to single key commands without requiring the user to press enter. Some commands will request further information, such as a link or bookmark id.

  • Navigation

    • (B)ack
    • (F)orward
    • (G)o to
      • (B)ookmark
      • (L)ink
      • (T)ab
      • (U)rl
    • (R)eload current url
    • (P)ipe to:
      • (R)eader
        • (C)urrent
      • (T)ab
        • (C)urrent
        • (L)ink
      • (D)isk
        • (C)urrent
        • (L)ink
    • (S)earch
  • Bookmarks/Tabs

    • (A)dd
      • (B)ookmark
      • (T)ab
    • (D)elete
      • (B)ookmark
      • (T)ab
    • (L)ist
      • (B)ookmark
      • (T)ab
    • (U)pdate bookmark title
  • System

    • (C)lean the screen
    • (H)elp
    • (Q)uit Stubb

When a gophermap is loaded, links will be enumerated. Pressing (G) and then (L) will prompt you for what link you would like to follow. Links are always based on the most recently loaded url for your current tab.

File save is always based out of the home directory of the user that launched Stubb.


If Stubb's slim and light style is not fitting your needs, or you just want to check out some other gopher client projects, I highly recomend the following:


Currently, the big item under consideration is a user editable config file. The config would allow a user to change their search engine, default save path, toggle color output, change reader application, etc.


Stubb is free, as in freedom, software. Modify it as you see fit, give it to whoever you want. It would be great if you referenced the original or cross linked, but it is not required.