231ccc36d3 | ||
---|---|---|
cmdparse | ||
config | ||
cui | ||
finger | ||
gemini | ||
gopher | ||
http | ||
local | ||
telnet | ||
.gitignore | ||
LICENSE | ||
README.md | ||
bombadillo-info | ||
bombadillo.1 | ||
bookmarks.go | ||
client.go | ||
defaults.go | ||
footbar.go | ||
go.mod | ||
go.sum | ||
headbar.go | ||
main.go | ||
notes.md | ||
page.go | ||
pages.go | ||
url.go |
README.md
Bombadillo
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. Bombadillo uses the module system, so if using 1.11 you will need to have that feature enabled. If using a version > 1.11, you already have modules enabled.
Bombadillo does not use any outside dependencies beyond the Go standard library.
Installing
Assuming you have go
installed, run the following:
git clone https://tildegit.org/sloum/bombadillo.git
cd bombadillo
go install
Once you have done that you should, assuming go install
is set up to install to a place on your path, you should be able to run the following from anywhere on your system to use Bombadillo:
bombadillo
Troubleshooting
If you run bombadillo
and get bombadillo: command not found
, try running go build
from within the cloned repo. Then try: ./bombadillo
. If that works it means that Go does not install to your path. go build
added an executable file to the repo directory. Move that file to somewhere on your path. I suggest /usr/local/bin
on most systems, but that may be a matter of personal preference.
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
.