Getting Started

Installation

No internet connection required after download. Everything runs locally on your desktop.

Quick Install

The easiest way to install Mugove on Ubuntu, Debian, or Linux Mint. The included script detects your distro and installs the correct runtime libraries automatically.

chmod +x install.sh && ./install.sh

Then make the binary executable and launch it:

chmod +x ./Mugove
./Mugove
💡

You can also double-click the binary in your file manager. If it does not run, right-click it, choose Properties, and enable "Allow executing as program."


Manual Install

If you prefer not to run the install script, install the required WebKit library directly. The package name varies by OS version.

OS VersionCommand
Ubuntu 22.04 / Mint 21 sudo apt install libwebkit2gtk-4.0-37 libgtk-3-0
Ubuntu 24.04 / Mint 22 sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0t64
⚠️

Ubuntu 24.04 / Mint 22 users: The package libwebkit2gtk-4.0-37 was removed in Ubuntu 24.04. If you see a "cannot open shared object file: libwebkit2gtk-4.0.so.37" error, download the build compiled against WebKit 4.1 from your purchase confirmation email, or contact us.


Other Linux Distros

DistroCommand
Fedora / RHELsudo dnf install webkit2gtk4.0 gtk3
Arch / Manjarosudo pacman -S webkit2gtk gtk3
openSUSEsudo zypper install libwebkit2gtk-4_0-37 gtk3

Steam Deck

SteamOS has a read-only filesystem by default. You need to temporarily disable the lock before running the install script.

sudo steamos-readonly disable
./install.sh
sudo steamos-readonly enable
ℹ️

SteamOS system updates reset the read-only state, so you may need to re-run the install step after a SteamOS update. Your Mugove binary and data are stored in your home directory and are not affected.


Your Data

Mugove stores your entire financial history in a single file:

~/.config/Mugove/mugove.db
🔒

This file never leaves your desktop. Back it up anywhere you like — an external drive, a USB stick, or an encrypted folder. To move Mugove to a new machine, just copy this file over.

Installation

The Windows build is a self-contained .exe. WebView2 is pre-installed on Windows 10 and 11, so there is nothing extra to install.

1
Download the binary

Grab Mugove.exe from the link in your purchase confirmation email.

2
Run the app

Double-click Mugove.exe. If Windows SmartScreen shows a warning, click More info then Run anyway. This appears because the app is not yet signed with a Microsoft certificate.


Your Data

Mugove stores all your data locally in a SQLite file under your user profile. It never connects to the internet and nothing is uploaded anywhere.

🔒

To back up or move your data, copy the mugove.db file from your app's data folder to wherever you like. You can find the exact path in Mugove under Settings.

Installation

The macOS build is a universal .app bundle that runs on both Intel and Apple Silicon, distributed as a .tar.gz archive to preserve file permissions.

1
Extract the archive
tar -xzf mugove-macos-universal.tar.gz
2
Make the binary executable
chmod +x Mugove.app/Contents/MacOS/Mugove
3
Remove the macOS quarantine flag

macOS automatically quarantines files downloaded from the internet. This command clears that flag.

xattr -cr Mugove.app
4
Open the app
open Mugove.app

Or double-click Mugove.app in Finder.


⚠️

"Cannot be opened" or "damaged" error? macOS blocks unsigned apps by default. After running the steps above, go to System Settings › Privacy & Security, scroll to the Security section, and click Open Anyway next to Mugove. You only need to do this once.


Your Data

Mugove stores all your financial data in a single SQLite file on your desktop. No account is required and nothing is uploaded anywhere.

🔒

To back up or move your data, copy the mugove.db file to wherever you like. The exact path is shown in Mugove under Settings.

Still need help?

Something not working as expected? We're happy to help.

Get in touch