Package: bebop-browser
Bebop is a [Gemini][gemini] browser for the terminal, focusing on practicality
and laziness. It is a personal project to learn how to use ncurses and try new
ways to explore the Geminispace. It borrows some ideas from [Amfora][amfora],
another great terminal browser, Vim for interactivity and tries to support mouse
usage decently. It also supports some “smol net” protocols such as Finger and
Gopher through plugins.[gemini]:https://gemini.circumlunar.space/[amfora]:https://github.com/makeworld-the-better-one/amforaIf you are interested in Gemini and looking for a desktop/laptop client, I
recommend trying a graphical one like the excellent [Lagrange][lagrange] or
[Kristall][kristall], or Amfora if you’re feeling more at home in the terminal.
Bebop won’t attempt to support every feature other clients might have, but if
you want to try something a bit different, keep reading…[lagrange]:https://git.skyjake.fi/skyjake/lagrange[kristall]:https://kristall.random-projects.net/Screenshots:![welcome screenshot](https://files.dece.space/img/bebop/bebop-welcome.png)
![browsing Medusae screenshot](https://files.dece.space/img/bebop/bebop-medusae.png)
![browsing Spacewalk screenshot](https://files.dece.space/img/bebop/bebop-spacewalk.png)The changelog is in the annotated tags.FeaturesWhy use Bebop instead of something else?Lightweight, no external Python dependencies.Nice keybinds are defined, and Vim users should get quickly familiar withthem.Fun! Link navigation is done by entering the link ID with automaticvalidation so you can just smash your numpad to take your ship to unknown
places (see usage section below for details).History, cache, client certificates, bookmarks (it’s just a text file withbindings), downloads, plugins and more!InstallYou need Python 3.7 or more recent. If you don’t know what Python is or if you
have it installed, check out this Gemini linkgemini://dece.space/dev/faq/using-python-programs.gmi([Web version][py-faq-http]).[py-faq-http]:https://portal.mozz.us/gemini/dece.space/dev/faq/using-python-programs.gmiThe easier installation method is using Pip, either user or system-wide
installation:`bash # User installation: pip3 install--userbebop-browser#System-wideinstallation: sudo pip3 installbebop-browser`To update:`bash # User update: pip3 install--user--upgradebebop-browser#System-wideupdate: sudo pip3 install--upgradebebop-browser`Note that you can also simply clone this repo and usepython3 -m bebopto run
from the source instead of installing it.### Platform specific info#### LinuxLinux is the main platform I can test so you should be good to go, and don’t
hesitate to report issues.#### BSDI don’t know! Let me know your experience with it if you did try it.#### macOSIt should work on macOS like on other UNIX-like systems. I have limited access
to devices running macOS so cross your fingers… The main difference I’ve seen is
that some keys may behave a bit differently and that text attributes such as
italics or dim may not work.#### WindowsBebop relies heavily on ncurses to display its content to the terminal, and it
does not work great on Windows. You need to install the curses support
separately as most Python distributions on Windows do not have it: the packagewindows-curseson PyPI seems to work here.Seems like there is no color support out of the box nor text attributes. It
works OK in cmd.exe, but it feels completely broken on Windows Terminal.### PluginsSince v0.2.0 you can use and develop plugins for Bebop. Installing a plugin
requires you to install the corresponding Python package, usually from PyPI,
then enable the plugin in your config file. Check the internal help page or thebebop/plugins.pymodule for more information.Here is a list of plugins I did, available on PyPI:bebop-browser-finger: support for Finger protocol ([readme][plugin-finger])bebop-browser-gopher: support for Gopher protocol ([readme][plugin-gopher])[plugin-finger]: plugins/finger/README.md
[plugin-gopher]: plugins/gopher/README.mdUsageJust runbebop, optionally following by an URL (bebop -hto see options). I
have it aliased to “bop” but that is up to you.Documentation about the keybinds, config values and commands are embed into the
software itself: press “?” to display the help page.The first thing you will want to get used to is the link navigation. All links
have an ID written before them and you press the corresponding number to access
it. If there are less than 10 links on a page, pressing the link ID will take
you to the page directly. If there are 30 links, pressing “1” will wait for
another digit. If there are 1000 links but you wish to visit link 5, pressing 5
and enter will do.There is an FAQ atgemini://dece.space/dev/bebop.gmi.Happy browsing!AboutLicensed under GPLv3.Name comes from [this song][bop] which is good background music for browsing
Gemini. Oh and Cowboy Bebop.[bop]:https://www.youtube.com/watch?v=tWyUYAmmtNg