beenull/browsh
1
0
Fork 0
Code Issues Pull requests Packages Projects Releases Wiki Activity
A fully-modern text-based browser, rendering to TTY and browsers
61 commits 10 branches 55 tags 8.4 MiB
JavaScript 46.3%
Go 45.4%
Shell 4.6%
HTML 1.2%
CSS 1%
Other 1.5%
Go to file
Thomas Buckley-Houston 74538fed0e Fix for zero-width chars in page titles 
Also removes the Mozilla Cliqz disclaimer tab on first startup.
Interestingly it has a carriage return in its HTML page title, which is
of course zero-width. But also the fact that this tab can sometimes load
before the requested tab at startup is a showstopper for automated
tests.
2018-01-31 15:40:43 +08:00
contrib Fix for zero-width chars in page titles 2018-01-31 15:40:43 +08:00
interfacer Fix for zero-width chars in page titles 2018-01-31 15:40:43 +08:00
webext Fix for zero-width chars in page titles 2018-01-31 15:40:43 +08:00
.dockerignore Automate releases 2018-01-28 16:08:19 +08:00
.eslintrc Refactored webext background script 2018-01-10 22:54:51 +08:00
.gitignore Automate releases 2018-01-28 16:08:19 +08:00
.nvmrc First draft of integration tests 2018-01-23 20:04:23 +08:00
.travis.yml Release v0.2.3 2018-01-30 17:50:55 +08:00
Dockerfile Release v0.2.3 2018-01-30 17:50:55 +08:00
LICENSE Added license and updated README 2016-05-21 18:38:46 +09:00
README.md Don't use --new-instance, -P when launching FF 2018-01-24 10:59:57 +08:00

README.md

Browsh Build Status

A fully interactive, realtime and modern browser rendered to TTY

or Firefox in your terminal 😲

// Gifs go here

Why?

I'm travelling around the world and sometimes I don't have very good Internet. If all I have is a 3kbps connection tethered from my phone then it's good to SSH into my server and browse the web through elinks. That way my server downloads the web pages and uses the limited bandwidth of my SSH connection to display the result. But it lacks JS support and all that other modern HTML5 goodness. So Browsh is simply a way to have the power of a remote server running a modern browser, but interfaced through the simplicity of a terminal and very low bandwidth.

Why not VNC? Well VNC is certainly one solution but it doesn't quite have the same ability to deal with extremely bad Internet. Also, Browsh can use MoSH to further reduce the bandwidth and stability requirements of the connection. Mosh offers features like automatic reconnection of dropped connections and diff-only screen updates. Furthermore, other than SSH or MoSH, Browsh doesn't require a client like VNC.

Another reason could be to offload the battery-drain of a modern browser from your laptop. If you're a CLI-native, then you could potentially get a few more hours life if your CPU-hungry browser is running somehwere else on mains electricity.

But of course the biggest reason for Browsh is probably just that it's cool geekery. You may just appreciate the sheer simplicty of browsing a text-based web in your terminal.

Installation

Download a https://github.com/tombh/browsh/releases (~2MB). You will need to have Firefox 57+ aleady installed.

Or download and run the Docker image (~800MB) with: docker run -it tombh/browsh

Usage

Most keys and mouse gestures should work as you'd expect on a desktop browser.

CTRL+l Focus URL bar

License

GNU General Public License v3.0