# dbdelve (ShayanAbbas1/dbdelve)

> A fast, native, cross-platform database client that supports many engines. It is written in Rust with GPUI, with no Electron and no JVM, so it starts quickly and uses little memory.

- GitHub: https://github.com/ShayanAbbas1/dbdelve
- GitHub.Locker page: https://github.locker/ShayanAbbas1/dbdelve
- Stars: 1.5K
- Language: Rust
- License: GPL-3.0
- Last push: 2026-11-17

## Questions and answers

Written by GitHub.Locker from the README and the repository; check the README below for details.

**Is it a desktop app or a server I have to host?**

A desktop app. It runs on your own machine and connects out to your databases, so there is no server to deploy.

**Do I need anything extra installed first?**

The README sends Linux requirements to docs/install.md. For databases reached through ODBC you must install that database's ODBC driver yourself.

**Any catches I should know about?**

For databases reached through ODBC, grid editing is off, and statements you type run under the connection's mode. The macOS build is not notarized, so it needs the cask or a quarantine workaround.

**Does it send my data anywhere?**

No telemetry. The only request it makes on its own is an update check, and you can turn that off. Logs stay on your machine.

**How much faster is it than DBeaver?**

In the author's benchmark (Postgres, M1 Pro, median of 5 runs) DBDelve launched in 1.1 s versus 5.2 s, used 133 MB idle versus 606 MB, and loaded 1M rows in 56 s versus 208 s.

**Can I open a CSV or Excel file without a database?**

Yes. Drop a CSV, Excel, Parquet or JSON file on the window and it opens in in-memory DuckDB as an editable query.

**Can I check an edit before it runs?**

Yes. When you change a cell, DBDelve writes the UPDATE statement for you to read before it runs.

**Why did the author build it?**

Existing clients were either bloated Electron or JVM apps or paid, so the author wanted a fast, modern, low-memory alternative. The project says no feature will ever sit behind a paywall.


---

## README (checked against GitHub 2026-11-18)

Source: https://github.com/ShayanAbbas1/dbdelve/blob/main/README.md

# <img src="assets/icon/dbdelve.svg" alt="" width="48" align="absmiddle"> DBDelve

A fast, native, cross-platform, multi-engine database client. Written in Rust
with GPUI, no Electron and no JVM: instant startup, friendly on your memory,
and smooth scrolling through large tables where other clients crash or
introduce limits.


## Community

Ideas and discussion on [Discord](https://discord.gg/7PegWzwqCm).


![DBDelve in Gruvbox Dark Glass: a SELECT on the events table in the editor and its result grid below](assets/screenshots/query-dark.png)

![DBDelve in Gruvbox Light Glass: a join in the editor and its result grid below](assets/screenshots/query-light.png)

Scrolling a million rows:

https://github.com/user-attachments/assets/6e15d566-a110-46c6-a236-52af7d877d4c

Launching, with the last results already there:

https://github.com/user-attachments/assets/9e55da56-8577-43e0-812a-c77eb5d0e701

## Why

I wanted something which is performant, modern and consumes little ram. The existing DB clients are either filled with bloat (Electron and JVM) or paid. This is an alternative to them. No feature is ever going behind a paywall and with time we will have complete parity on features with those too.

## Install

**macOS** (Apple Silicon, macOS 12 or later):

```sh
brew install --cask ShayanAbbas1/dbdelve/dbdelve
```

The app isn't notarized, so the cask clears the quarantine flag macOS would
otherwise refuse it over. Without Homebrew:

```sh
curl -fsSL https://raw.githubusercontent.com/ShayanAbbas1/dbdelve/main/install.sh | sh
```

**Linux** (x86_64 or aarch64): the same one-liner installs it under `~/.local`
with no root, or `yay -S dbdelve-bin` from the AUR, or the tarball or AppImage
from [the latest release][releases].

**Windows** (x86_64): run the installer from [the latest release][releases],
or unzip the zip and run `dbdelve.exe`. The installer asks for AppData (just
for you) or Program Files (all users).

Updating, the `.dmg`, Linux requirements, building from source and where your
data lives are all in [docs/install.md](docs/install.md).

[releases]: https://github.com/ShayanAbbas1/dbdelve/releases/latest

## Supported databases

Postgres, MySQL, MariaDB, SQLite, Turso, DuckDB, Snowflake, SQL Server, MongoDB,
Redis (and Valkey, KeyDB, Dragonfly) and ClickHouse.

Any other database with an ODBC driver is reachable through the bundled ODBC
bridge, with that driver installed: IBM Db2, Oracle, SAP HANA, SAP ASE
(Sybase), Informix, Teradata, Vertica, Exasol, Firebird, Amazon Redshift,
Google BigQuery, Databricks, Apache Hive, Trino and Presto, Dremio,
InterSystems IRIS, Microsoft Access and more. See
[Connecting through ODBC](docs/odbc.md).


![The welcome screen: paste a connection URL or pick one of the engines, import from DBeaver or TablePlus, or pick a theme](assets/screenshots/welcome.png)

## What it does

- **Make it yours.** The app's own themes alongside Catppuccin, Tokyo Night,
  Gruvbox and Dracula, each in dark, light and glass. Import themes from Zed or
  VS Code, or [write your own](docs/themes.md).

  ![The theme picker, with themes imported from Zed and VS Code and the import commands below them](assets/screenshots/themes.png)

- **Bring your connections with you.** Import every saved connection,
  passwords and SSH settings included, from DBeaver, or TablePlus on macOS.
- **Organize your connections into projects,** and jump to any of them from
  the palette, or disconnect back to a home screen that lists them all.

  ![The palette scoped to connections, grouped into two projects, with the current connection marked](assets/screenshots/projects.png)

- **Never mistake prod for staging.** Every connection is isolated and can
  color the title bar. Run it read-only, read-write or with full access, and
  DBDelve asks before anything destructive.

  ![The connection form, grouped into connection, security and behaviour, with a color and a project for the connection](assets/screenshots/connection-form.png)

- **Edits you can read first.** Change a cell and DBDelve writes the `UPDATE`
  for you to check before it runs.
- **Keep the columns you need.** Hide or pin columns, and the layout survives
  a restart.
- **Read a row in full** in the row panel, with JSON highlighted, and edit long
  values there.

  ![A table open in the grid, with the row panel showing one row's values and its JSON highlighted](assets/screenshots/table-dark.png)

- **Import rows** from CSV, TSV or JSON, with every row checked and every
  statement shown before anything runs.

  ![Importing events.csv: format options on the left, each file column mapped to a table column, and a preview of the rows](assets/screenshots/import.png)

- **Open a data file** by dropping it on the window: a CSV, Excel, Parquet or
  JSON file opens in DuckDB, held in memory, as a query you can change. A
  `.sql` file opens in a new query tab on the connection you're on, and runs
  only when you run it.

- **See the query plan** highlighted in its own pane, with bad row estimates
  called out.

  ![An Explain Analyze plan for a join: each node with its actual and estimated rows and time, and a ×76 misestimate flagged](assets/screenshots/query-plan.png)

- **Completion that knows your schema:** tables, and a table's columns after
  its name and a dot. A table is written with an alias, and after `JOIN` with
  the condition its foreign keys imply.

  ![Completing accounts. to its columns in a join](assets/screenshots/completion.png)

- **Keyboard-first.** One palette for commands, tables, saved queries, history
  and connections, and every shortcut rebindable.

  <img src="assets/screenshots/shortcuts.png" width="360" alt="The Shortcuts page in Settings: every action with its key binding and an Edit button">

- **Your SSH, not a reimplementation.** Tunnels run through your own `ssh`, so
  your config, agent and hardware keys just work.
  For Postgres, a Host that is a directory (`/var/run/postgresql`) reaches that
  Unix socket on the SSH host, optionally as another user (Run as); the server
  needs `socat`, and passwordless `sudo` for it when Run as is set. TLS modes
  other than `disable` and `prefer` are refused there.
- **Reach private databases through AWS SSM.** Choose AWS SSM in the connection
  form to use your installed AWS CLI and Session Manager plugin, with profile
  and region settings and automatic local port selection. See
  [SSM tunnels](docs/ssm-tunnels.md) for setup and TLS restrictions.
- **Sign in with a short-lived token.** On Postgres, MySQL, MariaDB, SQL
  Server, Redis and ClickHouse, a profile's Password command prints the
  password at every login, so cloud IAM auth keeps working after the token
  expires. For Amazon RDS:

  ```sh
  /opt/homebrew/bin/aws rds generate-db-auth-token --hostname %HOSTNAME% --port %PORT% --username %USERNAME% --region <region>
  ```

  `%HOSTNAME%`, `%PORT%` and `%USERNAME%` are the profile's own. DBDelve
  quotes them itself, so write them unquoted: one inside quotes stops the
  command from running. Give the program's full path (`which aws` prints it):
  an app opened from the Finder or a desktop launcher does not see the PATH
  your shell sets. Expires after
  reuses the output for that many seconds, in memory only; blank runs the
  command at every login.

Free and open source, nothing behind a paywall, and no telemetry: the only
request DBDelve makes on its own is an update check, which you can turn off.

## Benchmarks

DBDelve 0.3.6 against DBeaver 25.3.1 on the same Postgres table, median of 5
runs each (2026-10-11, M1 Pro, 32 GB):

|                   | DBDelve | DBeaver |
| ----------------- | ------- | ------- |
| Launch            | 1.1 s   | 5.2 s   |
| Idle memory       | 133 MB  | 606 MB  |
| 1,000-row query   | 0.21 s  | 1.96 s  |
| 1M rows, time     | 56 s    | 208 s   |
| 1M rows, memory\* | 4.9 GB  | 17 GB   |

\* The whole 1M-row table pulled into memory on purpose, with the row limit
off. Method and full results in [BENCHMARKS.md](BENCHMARKS.md).

## Logs and bug reports

DBDelve keeps a diagnostic log on your machine and never sends it anywhere. To
attach it to an issue, use **Help → Copy Diagnostics** and paste; **Help → Open
Logs Folder** shows the files. If the default log doesn't show the problem, turn
on **Verbose logging** in Settings and reproduce it.

Read a log before you post it and remove anything sensitive. A verbose one can
hold hostnames, database names and anything a database driver logs.

## License

Copyright (C) 2026 Shayan Abbas and contributors, licensed under the
[GPL-3.0](LICENSE). Code contributed before the switch was released under the
[MIT License](licenses/MIT-dbdelve.txt), and that notice still applies to it.
Third-party font and theme licenses are in [NOTICES.md](NOTICES.md).

## Sponsors

Support DBDelve on [Patreon](https://www.patreon.com/membership/30003257). Sponsors are listed here and on the site.

<a href="https://dbdelve.github.io/#sponsors"><img src="https://dbdelve.github.io/sponsors/sponsors.svg" alt="DBDelve's sponsors"></a>

## Contributors

Thank you to everyone who has contributed to DBDelve.

<a href="https://github.com/ShayanAbbas1/dbdelve/graphs/contributors"><img src="https://contrib.rocks/image?repo=ShayanAbbas1/dbdelve" alt="DBDelve's contributors"></a>

Want to join them? Read [CONTRIBUTING.md](CONTRIBUTING.md).

