Repository navigation
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 (
⌘ + Son macOS,Ctrl + Son Windows and Linux). Nothing reaches PostgreSQL until you save. Results that cannot be edited safely (for example joins orDISTINCT) 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.gzwrapper 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
- Download
Dockwave-0.4.0-universal.zipand unzip it. - Drag
Dockwave.appto/Applicationsin Finder. - 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
- Download
Dockwave-0.4.0-windows-x64.zipand unzip it into a folder of your choice. - 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.
- Download
Dockwave-0.4.0-linux-x86_64.tar.gz. - 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. - 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 tocrash.login 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.