# GDB dashboard

> A standalone .gdbinit written in Python that shows a modular dashboard of program state in GDB each time the debugged program stops.

Stars: 12.3k · Language: Python · License: MIT · Categories: Dev Tools

- Repository: https://github.com/cyrus-and/gdb-dashboard
- Page: https://www.trmn.sh/tools/gdb-dashboard

## Install

- wget: `wget -P ~ https://github.com/cyrus-and/gdb-dashboard/raw/master/.gdbinit`
- pip (optional syntax highlighting): `pip install pygments`

## Overview

GDB dashboard is a single `.gdbinit` file written with GDB's Python API. It adds a modular interface that shows information about the program being debugged. The dashboard appears automatically every time the inferior program stops, so you need fewer manual GDB commands to inspect program state and can concentrate on control flow.

It does not redefine any existing GDB command. All of its features are available through one `dashboard` command, which is documented through `help dashboard`. If Pygments is installed, the dashboard uses it for syntax highlighting. The wiki covers the most common configuration and usage tasks.

It is for developers who debug native programs with GDB and want persistent visibility of program state. Setup is one file in the home directory, with no other GDB plugins required.

### Installation

```bash
# via wget
wget -P ~ https://github.com/cyrus-and/gdb-dashboard/raw/master/.gdbinit
```

```bash
# via pip (optional syntax highlighting)
pip install pygments
```

![GDB dashboard screenshot](https://media.trmn.sh/cached/9e3367cff950be021e66d0a348ba4804bb541183b26f455071aef080e390956c.png)

## Alternatives

- [AWS CLI](https://www.trmn.sh/tools/aws-cli.md): Official command line interface for Amazon Web Services, with profile-based credentials, configurable output, and shell tab completion. (Python, 17.3k stars)
- [harlequin](https://www.trmn.sh/tools/harlequin.md): Terminal-based SQL IDE with database adapter support for DuckDB, SQLite, PostgreSQL, MySQL and dozens of other databases (Python, 6.5k stars)
- [Azure CLI](https://www.trmn.sh/tools/azure-cli.md): Microsoft's cross-platform command-line interface for managing Azure resources with az group/subgroup/command syntax, JMESPath queries, and tab completion. (Python, 4.7k stars)
- [textual-astview](https://www.trmn.sh/tools/textual-astview.md): TUI tool for exploring Python Abstract Syntax Trees (AST) with interactive tree view and source highlighting (Python, 100 stars)
- [peplum](https://www.trmn.sh/tools/peplum.md): Terminal-based browser and search interface for Python Enhancement Proposals (PEPs) (Python, 27 stars)

---

Canonical: https://www.trmn.sh/tools/gdb-dashboard