///   |)   _         |)   _,   _|  o |\ |\  _     \\\
  |||    |/\_/ \_/|/|/| |/\_/ |  / |  | |/ |/ / \_    |||
  |||     \/ \_/  | | |_/\/ \/|_/\/|_/|/|_/|_/\_/     |||
   \\\                                               ///

Home

User Guide

Releases

Source Code

Web Mirror of this gopherhole

                            *


Bombadillo is a non-web browser, designed for a growing list of
protocols operating outside of the web.

Bombadillo is operated from your terminal, allowing you to browse
content, follow links, and engage in the non-web with ease. The main
features of Bombadillo are: 

  - Seamless browsing between multiple protocols, including Gopher,
    Gemini, Finger, and your local file system

  - Additional support for telnet and the web through third-party
    applications - http/https connection support is opt-in, and is
    configurable in a few different ways

  - Privacy focused - does not store usage or browsing data, will
    only store items you instruct it to (bookmarks, gemini
    certificates, settings and downloaded files)

  - Does not send/transmit anything to anyone that you do not
    instruct it to
  
  - Uses Vi/Vim-inspired keybindings and an easy command system

  - Navigable history within a session (no storage of session data)

  - Supports bookmarks

  - Gemini Protocol support includes secure communication over TLS,
    and uses a TOFU-style certificate system

Do you know of another great protocol you'd like to see support for
in Bombadillo? Have you encountered a bug? Add it as an issue in our
source code repository.


                            *


GETTING BOMBADILLO

Bombadillo will run on any, to our knowledge, Unix-like system. To
run the program the only dependencies are a terminal that supports
VT-100 style escape codes (if you don't know if this is you: it
probably is) and the programs tput and stty (which are present on
the vast majority of such systems). Bombadillo can also be
configured to integrate with external web browsers installed on your
system, such as Firefox and Lynx, to allow the use of HTTP/HTTPS.

Bombadillo can be built from source code. To do so you will need
Git, and a Go compiler installed on your system. Then do the
following:

```
git clone https://tildegit.org/sloum/bombadillo
cd bombadillo
sudo make install
bombadillo
```

If you do not have GNU make or compatible software installed on your
system, but do have a Go compiler, you can also:

```
go install
```

Precompiled executables are also available from our page here:

Binaries

For more information on installing Bombadillo, view README.md in the
downloaded repository, or view it online in our source code
repository. 


                            *


Bombadillo was written largely by sloum, with much appreciated help
from asdf and jboverf.

Bombadillo is GPLv3 licensed.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

This gopherhole and all textual and visual works contained within
are licensed under a Creative Commons
Attribution-NonCommercial-ShareAlike 4.0 International License.