# frogmouth

> Terminal-based Markdown viewer/browser with navigation, bookmarks, and GitHub repository support

Stars: 3.3k · Categories: Productivity

- Repository: https://github.com/Textualize/frogmouth
- Website: https://www.textualize.io/
- Page: https://www.trmn.sh/tools/frogmouth

## Install

- pipx: `pipx install frogmouth`
- pip: `pip install frogmouth`
- Homebrew: `brew tap textualize/homebrew && brew install frogmouth`

## Overview

Frogmouth is a terminal-based Markdown viewer and browser built with Textual. It opens local `.md` files or files from URLs, providing a browser-like experience within the terminal. The tool includes navigation controls, browsing history, bookmarks, and a table of contents for easy document exploration.

The application supports both mouse and keyboard navigation, with tab-based movement between interface controls. Users can load README files directly from GitHub repositories using the `gh` command syntax, such as `frogmouth gh textualize/textual`. This functionality extends to the built-in address bar for quick repository access.

Frogmouth runs on Linux, macOS, and Windows, requiring Python 3.8 or above. The tool provides familiar browser navigation patterns adapted for terminal use, making it suitable for developers who prefer command-line workflows but need to read documentation and Markdown files regularly.

### Installation

```bash
# via pipx
pipx install frogmouth
```

```bash
# via pip
pip install frogmouth
```

```bash
# via Homebrew
brew tap textualize/homebrew && brew install frogmouth
```

![Frogmouth main interface](https://media.trmn.sh/cached/6f730cde96cfbb056793e3ec845e7a62b095043639ff4852c22563f0440e16fe.png)

![Frogmouth table of contents](https://media.trmn.sh/cached/1a5e0f28f28c91687870211397f16bca7d21b9121641ff7383da3b4953ca511c.png)

![Frogmouth bookmarks interface](https://media.trmn.sh/cached/d2410b66e296643a48b9469815b2e908063cf614f5f501e3f15545502da32290.png)

## Alternatives

- [dooit](https://www.trmn.sh/tools/dooit.md): A terminal-based todo manager with vim-like keybindings and customizable themes (3.0k stars)
- [Pop](https://www.trmn.sh/tools/pop.md): Send emails from the terminal via a TUI or CLI flags, using Resend or SMTP, with Markdown bodies, attachments, and AI agent skill support. (Go, 2.9k stars)
- [dijo](https://www.trmn.sh/tools/dijo.md): Terminal-based habit tracker with vim-like navigation and scriptable automation for tracking events (2.9k stars)
- [Numbat](https://www.trmn.sh/tools/numbat.md): Statically typed scientific calculator language with physical dimensions as types and first-class units, with an interactive REPL and unit conversion via ->. (Rust, 2.8k stars)
- [NeoMutt](https://www.trmn.sh/tools/neomutt.md): Terminal email client that collects community patches against Mutt, with Notmuch, NNTP, sidebar, compressed folders and header cache options. (C, 3.9k stars)

## Guides

- [glow vs frogmouth](https://www.trmn.sh/compare/glow-vs-frogmouth): Compare glow, frogmouth: workflows, strengths and tradeoffs.

---

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