# browsh

> Text-based web browser backed by headless Firefox, rendering JS-enabled pages to a terminal (TTY) or another browser. Works over SSH or MoSH.

Stars: 19.1k · Language: JavaScript · License: LGPL-2.1 · Categories: Network

- Repository: https://github.com/browsh-org/browsh
- Website: https://www.brow.sh
- Page: https://www.trmn.sh/tools/browsh

## Install

- Docker: `docker run --rm -it browsh/browsh`

## Overview

Browsh is a text-based web browser that uses headless Firefox as its backend. Because a real browser engine loads the page, JavaScript and HTML5 content work, unlike traditional text browsers such as elinks. The rendered result is converted to text and displayed in a terminal (TTY) or in another browser. The README notes that the browser client does not yet have feature parity with the terminal client.

The main use case is browsing over very poor connections. You SSH into a server, run Browsh there, and the server downloads the pages, so only the rendered text output crosses the limited link. Terminal Browsh can also run over MoSH, which adds automatic reconnection of dropped or roaming connections and diff-only screen updates. Apart from SSH or MoSH, no client software is needed, which the README contrasts with VNC.

A second use is moving the resource cost of a full browser off a laptop or low-powered device such as a Raspberry Pi, by running Browsh on another machine. Most keys and mouse gestures behave as in a desktop browser. Browsh is written in Go, with a Firefox web extension (Node.js and webpack) that runs the JavaScript needed to prepare pages for rendering. It requires Firefox to be installed when you use the release binary, or you can run the Docker image.

### Installation

```bash
# via Docker
docker run --rm -it browsh/browsh
```

## Alternatives

- [localtunnel](https://www.trmn.sh/tools/localtunnel.md): Node.js CLI and API that exposes a local port at a public URL through a tunnel server, for testing webhooks and sharing local work without DNS or deployment. (JavaScript, 22.5k stars)
- [Carbonyl](https://www.trmn.sh/tools/carbonyl.md): Chromium-based web browser that renders pages inside a terminal, including JavaScript, WebGL, and media playback, and runs over SSH. (Rust, 19.6k stars)
- [katana](https://www.trmn.sh/tools/katana.md): Go-based web crawler from ProjectDiscovery with standard and headless Chrome modes, JavaScript endpoint parsing, scope control, and JSON output for pipelines. (Go, 17.9k stars)
- [gallery-dl](https://www.trmn.sh/tools/gallery-dl.md): Cross-platform command-line program that downloads image galleries and collections from many image hosting sites, with configurable file naming. (Python, 20.6k stars)
- [RustScan](https://www.trmn.sh/tools/rustscan.md): Port scanner written in Rust that scans all 65k ports in about 3 seconds and can pipe open ports into Nmap or custom Python, Lua, and Shell scripts. (Rust, 20.8k stars)

---

Canonical: https://www.trmn.sh/tools/browsh
