Bombabillo is a non-web client for the terminal, supporting Gopher, Gemini and much more. https://bombadillo.colorfield.space
Go to file
sloumdrone 9c2caf4a6f Updates man page 2019-10-27 11:09:45 -07:00
cmdparse Corrected lexer commands 2019-10-12 11:48:16 -07:00
config Adds basic tofu certificate pinning 2019-09-26 22:08:57 -07:00
cui Missed the for loop...plus some documentation 2019-10-24 13:42:38 +11:00
finger Adds basic finger protocol support to Bombadillo 2019-10-06 19:59:46 -07:00
gemini More descriptive error msg 2019-10-13 22:23:04 -07:00
gopher Updates gophermap rendering to support gemini urls as h URL:... style links 2019-09-18 22:03:19 -07:00
http Reworks the protocol handling and makes html downloads work 2019-10-25 20:06:13 -07:00
local Adds support for listing directories as well as getting file contents 2019-10-05 13:10:09 -07:00
telnet Adds telnet and http modules, updates visit method on client 2019-09-10 20:13:30 -07:00
.gitignore Added ability to view a link's url with the check command 2019-09-17 21:57:21 -07:00
LICENSE Returns license to gpl3 2019-09-23 08:49:33 -07:00
Makefile Ammended variables to include prefix and destdir 2019-10-21 13:23:58 +11:00
README.md Updates man page 2019-10-27 11:09:45 -07:00
VERSION First go at a makefile, woo-hoo! 2019-10-14 16:29:40 -07:00
bombadillo.1 Updates man page 2019-10-27 11:09:45 -07:00
bookmarks.go Fixes bug where screan flashes clear when bookmarks are toggled closed 2019-10-08 19:52:06 -07:00
client.go Updates man page 2019-10-27 11:09:45 -07:00
defaults.go Resolves conflict in defaults.go with upstream branch 2019-10-23 19:00:12 -07:00
footbar.go Vast improvements, still squashing bugs like crazy. 2019-09-13 22:56:38 -07:00
go.mod Updating go module declaration to require go 1.12+ 2019-10-02 19:37:39 -07:00
go.sum Switches the way client certs are provided 2019-10-02 09:24:01 -07:00
headbar.go Fixes order of opperations issue when drawing messages 2019-09-15 21:24:45 -07:00
main.go Updates man page 2019-10-27 11:09:45 -07:00
page.go Adds a terminal mode change to disallow line wrapping by the terminal, also fixes a resize scroll issue and disallows escape characters in text files 2019-09-19 20:29:17 -07:00
pages.go Vast improvements, still squashing bugs like crazy. 2019-09-13 22:56:38 -07:00
url.go HOT FIX: Returned url regex to rightful state and fixed numerical issue with check command 2019-10-10 22:07:32 -07:00

README.md

Bombadillo - a non-web client

Bombadillo is a modern Gopher client for the terminal, and functions as a pager/terminal UI. Bombadillo features vim-like keybindings, configurable settings, and a robust command selection. Bombadillo is under active development.

Getting Started

These instructions will get a copy of the project up and running on your local machine.

Prerequisites

If building from source, you will need to have Go version >= 1.11.

Optional

Lynx, the text based web browser, can be used as a parsing engine for http/https. This is a totally optional item and Lynx is in no way required in order to compile or run Bombadillo. Having it available on the system can help create a richer experience by allowing users to navigate directly to web content in Bombadillo. Many users may wish to avoid this entirely,a nd the default configuration does not have this behavior turned on. To turn it on from within Bombadillo enter the command set lynxmode true.

Installing

Assuming you have all prerequisites installed, Bombadillo can be installed on your system using the following commands:

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

Once this is done, you should be able to start Bombadillo using the following command:

bombadillo

Other installation options

If you only want to install Bombadillo for your own user account, you could try the following in the cloned repository:

make PREFIX=~ install

You can then add ~/bin to your PATH environment variable, and ~/share/man to your manpath.

The PREFIX option can be used to install Bombadillo to any location different to /usr/local.

Troubleshooting

If you run bombadillo and get bombadillo: command not found, try running make from within the cloned repository. Next, try: ./bombadillo. If this works, it means that the installation was not completed to an area in your PATH.

Please feel free to open an issue if you experience any other issues with the installation.

Uninstalling

To uninstall Bombadillo, simply run the following command from the cloned repository:

sudo make uninstall

Please note that directories created during the installation will not be removed.

Downloading

If you would prefer to download a binary for your system, rather than build from source, please visit the Bombadillo downloads page. Don't see your OS/architecture? Bombadillo can be built for use with any POSIX compliant system that is supported as a target for the Go compiler (Linux, BSD, OS X, Plan 9). No testing has been done for Windows. The program will build, but will likely not work properly outside of the Linux subsystem. If you are a Windows user and would like to do some testing or get involved in development please reach out or open an issue.

Documentation

Bombadillo has documentation available in four places currently. The first is the Bombadillo homepage, which has lots of information about the program, links to places around Gopher, and documentation of the commands and configuration options.

Secondly, and possibly more importantly, documentation is available via Gopher from within Bombadillo. When a user launches Bombadillo for the first time, their homeurl is set to the help file. As such they will have access to all of the key bindings, commands, and configuration from the first run. A user can also type :? or :help at any time to return to the documentation. Remember that Bombadillo uses vim-like key bindings, so scroll with j and k to view the docs file.

Thirdly, this repo contains a file bombadillo-info. This is a duplicate of the help file that is hosted over gopher mentioned above. Per user request it has been added to the repo so that pull requests can be created with updates to the documentation.

Lastly, but perhaps most importantly, a manpage is now included in the repo as bombadillo.1. Current efforts are underway to automate the install of both bombadillo and this manpgage.

Contributing

Bombadillo development is largely handled by Sloum, with help from jboverf, asdf, and some community input. If you would like to get involved, please reach out or submit an issue. At present the developers use the tildegit issues system to discuss new features, track bugs, and communicate with users about hopes and/or issues for/with the software. If you have forked and would like to make a pull request, please make the pull request into develop where it will be reviewed by one of the maintainers. That said, a heads up or comment/issue somewhere is advised.

License

This project is licensed under the GNU GPL version 3- see the LICENSE file for details.

Releases

Starting with v2.0.0 releases into master will be version-tagged. Work done toward the next release will be created on work branches named for what they are doing and then merged into develop to be combined with other ongoing efforts before a release is merged into master. At present there is no specific release schedule. It will depend on the urgency of the work that makes its way into develop and will but up to the project maintainers' judgement when to release from develop.