1. Download and Installation

blunderDB is a single executable that requires no installation.

The latest version of blunderDB is available under the MIT license:

For an offline consultation, you can also download this documentation in PDF format: https://github.com/kevung/blunderDB/releases/latest/download/blunderDB-0.27.1-en.pdf

Note

blunderDB uses Webview2 for rendering the graphical interface. It is likely that Webview2 is already present natively on your operating system. If not, the first execution of blunderDB will offer to download and install it. No user action is required.

1.1. Installing on Linux

Several formats are available for Linux. The packages and archives below make blunderDB executable automatically: unlike the raw binary downloaded through a browser, they avoid having to run chmod +x after every download or update. They also add an entry to the applications menu.

1.1.1. Native packages (.deb / .rpm)

Recommended method on Debian, Ubuntu and Linux Mint (.deb) as well as Fedora and openSUSE (.rpm). The package manager automatically installs the appropriate webkit2gtk dependency. Replace x.y.z with the downloaded version:

sudo apt install ./blunderdb_x.y.z_amd64.deb     # Debian / Ubuntu / Mint
sudo dnf install ./blunderdb-x.y.z.x86_64.rpm    # Fedora / openSUSE

1.1.2. Arch Linux (AUR)

The blunderdb-bin package is available on the AUR and updated automatically by AUR helpers:

yay -S blunderdb-bin      # ou : paru -S blunderdb-bin

1.1.3. .tar.gz archive

For other distributions. Extracting an archive preserves the executable bit, so no chmod is needed:

tar xzf blunderDB-linux-webkit2gtk-4.1-x.y.z.tar.gz
cd blunderDB-linux-webkit2gtk-4.1-x.y.z
./blunderdb

1.1.4. Raw binary (advanced method)

The raw binary https://github.com/kevung/blunderDB/releases/latest/download/blunderDB-linux-0.27.1 remains available. Since a browser strips the executable bit on download, you must restore it before the first run:

chmod +x ./blunderDB-linux-x.y.z

Note

Two Linux variants are published depending on the webkit2gtk library version. If you get the error libwebkit2gtk-4.0.so.37: cannot open shared object file, your distribution uses webkit2gtk-4.1: use the .deb/.rpm package, the AUR package, or download the dedicated build https://github.com/kevung/blunderDB/releases/latest/download/blunderDB-linux-webkit2gtk-4.1-0.27.1. Native packages select the correct dependency automatically.

1.2. Windows and Mac warnings

Warning

On Windows, it is possible that it may hesitate to run blunderDB. See: Section 10 for an explanation of why and how to bypass any potential blocks.

Warning

On Mac, it is possible that it may have reservations about running blunderDB. See Section 11 to understand why and bypass any potential blocks.