Install and first start
One file to install on each system, one question at the first start, and after that the application keeps itself up to date when you let it.
Pick the file
The download page lists the files of the current release.
On Windows
Open the installer. The beta is not signed yet, so Windows may say it protected your PC: choose More info, then Run anyway. Before it installs anything, the installer shows the licence agreement and goes on once you accept it. Mantichora runs in WebView2, which Windows 11 already has; where it is missing, the installer fetches it.
On macOS
Open the disk image and drag Mantichora to Applications, then open it. The beta is not notarised yet, so macOS says it cannot check the developer. Open System Settings → Privacy & Security and choose Open Anyway under Mantichora.
NoteIf there is no such button, run xattr -dr com.apple.quarantine /Applications/Mantichora.app in Terminal and open it again.
On Linux
Make the AppImage executable and open it:
chmod +x Mantichora_*_amd64.AppImage
./Mantichora_*_amd64.AppImage
Or install the package, which has apt bring WebKitGTK 4.1, GTK 3 and the ODBC library with it:
sudo apt install ./Mantichora_*_amd64.deb
The build is made on Debian 12, so the system needs to be at least that new.
The first start
If the copy you installed can send crash reports or usage counts, the window asks once: Help make Mantichora better? Both boxes start unticked, and nothing is sent unless you tick one. Send nothing and Save both close the question for good; Settings → Privacy changes either answer later. The support page says exactly what each would send.
With no connection saved yet, the window offers three ways in: Make one here opens the connection form, Take one from another application imports connections from DataGrip or TablePlus, and New database file makes a SQLite file and a connection to it. Your first connection walks through the form.
Updates
Once a day the application reads one file from this site, the description of the newest release. When there is a newer version, a window says Mantichora 0.x is available with its notes. Install downloads it, checks its signature and restarts into it, asking first about anything unsaved, the way closing the window does; Later leaves it.
Settings → About has the switch Check for updates automatically and the button Check now, which asks at once.
Where it keeps things
Connections, history, settings and themes live in one folder, logs in another. Passwords are not in either: they are in the system’s store (see Passwords and the secret store).
| system | data | logs |
|---|---|---|
| Windows | %APPDATA%\dev.mantichora.desktop | %LOCALAPPDATA%\dev.mantichora.desktop\logs |
| macOS | ~/Library/Application Support/dev.mantichora.desktop | ~/Library/Logs/dev.mantichora.desktop |
| Linux | ~/.local/share/dev.mantichora.desktop | ~/.local/share/dev.mantichora.desktop/logs |
Only one copy runs at a time: starting it again brings the open window to the front.