Skip to content

Dockwave v0.4.0

Latest

Choose a tag to compare

@Rommel96 Rommel96 released this 05 Nov 03:18

Dockwave 0.4.0 is a stable release for macOS, Windows and, for the first time, Linux, all built from the same source. It adds editing of query results and supersedes v0.3.1.

What's new since 0.3.1

  • Edit query results. When a result comes from a single table with a primary key, you can edit its cells in the grid. Edits are staged locally first: the bar above the grid counts them and lets you preview the SQL, discard them, or save them (⌘ + S on macOS, Ctrl + S on Windows and Linux). Nothing reaches PostgreSQL until you save. Results that cannot be edited safely (for example joins or DISTINCT) say why and stay read-only.
  • Safe saves. A save checks that the rows have not changed since you loaded them. If another session changed a row, or PostgreSQL rejects a value, nothing is saved and your edits stay staged so you can fix them.
  • No lost edits. Running a query again or closing a tab with unsaved edits asks first. Keep editing is the default.
  • Linux is now a stable platform, with the AppImage and the .tar.gz wrapper introduced in the Linux previews.

Downloads

Platform Asset SHA-256
macOS (universal) Dockwave-0.4.0-universal.zip 4feeb67afcc6690438bcf9841145ee5b8cd6c5fef56fa0c46ff57f343d6e6476
Windows (x86_64, portable) Dockwave-0.4.0-windows-x64.zip 15bb0a574d1fec57dd191cb735d99cce11a75fda43de427fb2d66168f5eeb2ed
Linux (x86_64, recommended) Dockwave-0.4.0-linux-x86_64.tar.gz 737f3c4d6fc3ba192d582bce9dbb215275a9c213eb2713c407e66469ccbac270
Linux (x86_64, raw AppImage) Dockwave-0.4.0-linux-x86_64.AppImage 1dc05883e3b65ecb6849b6fb0ce19720f86329a187db221f0050187610918dc3

Each artifact has a matching .sha256 sidecar. No source code or credentials are included. The Linux AppImage runtime's corresponding source (fuse-3.15.0.tar.xz and the AppImage runtime source archive) is published alongside it.

Support

  • macOS: validated on macOS 27.2 on Apple Silicon (arm64). The archive is universal, but the Intel (x86_64) build is not verified. The minimum declared version is macOS 11.0; other macOS versions are best-effort and unverified.
  • Windows: validated on Windows 11 Pro (build 26300) on x86_64. Windows 10, other Windows 11 builds, and Windows on ARM are untested.
  • Linux: validated on Omarchy 4.0.6 (Hyprland, Wayland) on x86_64, glibc 2.35 or newer. Every other distribution, desktop and session is untested.

Install

macOS

  1. Download Dockwave-0.4.0-universal.zip and unzip it.
  2. Drag Dockwave.app to /Applications in Finder.
  3. Open Dockwave once. If macOS blocks it, go to System Settings → Privacy & Security, choose Open Anyway, and confirm.

The app is ad-hoc signed, not signed with an Apple Developer ID, and not notarized, so macOS may block the first launch. Do not strip the quarantine attribute.

Windows

  1. Download Dockwave-0.4.0-windows-x64.zip and unzip it into a folder of your choice.
  2. Run dockwave.exe. If SmartScreen shows "Windows protected your PC", choose More info → Run anyway.

The Windows build is not code-signed, so SmartScreen warns on first launch. It is portable: there is no installer, Start menu entry, or auto-update. To remove it, delete the folder, %APPDATA%\com.dockwave.desktop\, and %LOCALAPPDATA%\com.dockwave.desktop\.

Linux

Recommended: the .tar.gz wrapper.

  1. Download Dockwave-0.4.0-linux-x86_64.tar.gz.
  2. Extract it: in Nautilus, right-click the file and choose Extract; in a terminal, tar -xzf Dockwave-0.4.0-linux-x86_64.tar.gz.
  3. Double-click the extracted AppImage.

The archive holds exactly one executable file, so the extracted AppImage is ready to run.

Alternative: download Dockwave-0.4.0-linux-x86_64.AppImage, run chmod +x Dockwave-0.4.0-linux-x86_64.AppImage, then start it.

Running the AppImage requires FUSE 3. Without it, set APPIMAGE_EXTRACT_AND_RUN=1 or pass --appimage-extract-and-run. The AppImage is unsigned. Checking the .sha256 sidecar is optional: sha256sum -c <artifact>.sha256.

Privacy

  • Saved passwords are stored in Keychain on macOS, Windows Credential Manager on Windows, and the Secret Service keyring (for example GNOME Keyring) on Linux, never in Dockwave's files. If the keyring is locked or unavailable, Dockwave reports it and does not fall back to a file.
  • Query history, saved queries and open tabs are stored locally, unencrypted, in your user folders. Anything typed into SQL, including secrets, is saved as written.
  • To let you inspect long values, the full text of result cells on screen is cached on disk and removed when the result is replaced or the app quits.

Platform differences

  • Shortcuts use Ctrl on Windows and Linux where macOS uses Cmd (for example, Ctrl+Enter runs SQL and Ctrl+S saves edits).
  • App data lives in %APPDATA%\com.dockwave.desktop\ on Windows and ~/.local/share/com.dockwave.desktop/ on Linux. If the app crashes, a size-limited crash report is written to crash.log in that folder. Passwords in it are redacted; open it and remove any SQL, host names, user names, or data values before attaching it to an issue.
  • Quitting the app discards edits that have not been saved, without asking.