Installation

Download Matchstick Events for your platform from GitHub Releases.

Linux

Linux users have two options: .deb packages for Debian-based distributions, or .AppImage for universal compatibility.

Option 1: Debian Package (.deb)

For Ubuntu, Debian, Pop!_OS, Linux Mint, and other Debian-based distributions.

1. Download the package

# Download the latest .deb release
curl -LO https://github.com/matchstick-trading/matchstick-events-apps/releases/latest/download/matchstick-events_0.0.2_amd64.deb

2. Install dependencies

The app requires WebKit2GTK for the embedded browser:

# Ubuntu 22.04+ / Debian 12+
sudo apt update
sudo apt install -y libwebkit2gtk-4.1-0 libgtk-3-0

# Ubuntu 20.04 / Debian 11
sudo apt update
sudo apt install -y libwebkit2gtk-4.0-37 libgtk-3-0

3. Install the package

sudo dpkg -i matchstick-events_0.0.2_amd64.deb

# If there are dependency errors, run:
sudo apt --fix-broken install

4. Launch

matchstick-events

Or find "Matchstick Events" in your application menu.

---

Option 2: AppImage

AppImages are self-contained and work on most Linux distributions without installation.

1. Download the AppImage

curl -LO https://github.com/matchstick-trading/matchstick-events-apps/releases/latest/download/matchstick-events_0.0.2_amd64.AppImage

2. Make it executable

chmod +x matchstick-events_0.0.2_amd64.AppImage

3. Install FUSE (if needed)

AppImages require FUSE to run. Most modern distributions include it, but if you get a FUSE error:

# Ubuntu/Debian
sudo apt install libfuse2

# Fedora
sudo dnf install fuse

# Arch
sudo pacman -S fuse2

4. Run the AppImage

./matchstick-events_0.0.2_amd64.AppImage

Desktop Integration

To add the AppImage to your application menu, use a tool like AppImageLauncher or move the file to ~/.local/bin/ and create a .desktop file.

---

Troubleshooting Linux

"error while loading shared libraries: libwebkit2gtk"

Install the WebKit2GTK library:

# Try the 4.1 version first (newer distros)
sudo apt install libwebkit2gtk-4.1-0

# If that fails, try 4.0 (older distros)
sudo apt install libwebkit2gtk-4.0-37

AppImage won't start

1. Ensure FUSE is installed: sudo apt install libfuse2
2. Check the file is executable: chmod +x *.AppImage
3. Try extracting and running directly:

   ./matchstick-events*.AppImage --appimage-extract
   ./squashfs-root/matchstick-events

Blank window or white screen

This usually indicates a GPU driver issue with WebKit. Try:

# Disable GPU acceleration
WEBKIT_DISABLE_COMPOSITING_MODE=1 matchstick-events

No notifications appearing

Check that your notification daemon is running:

# For GNOME
systemctl --user status org.gnome.Shell.Notifications

# For other DEs, ensure libnotify is installed
sudo apt install libnotify-bin
notify-send "Test" "This is a test notification"

---

macOS

1. Download the DMG

Download matchstick-events_0.0.2_x64.dmg from GitHub Releases.

2. Install

1. Open the downloaded .dmg file
2. Drag "Matchstick Events" to your Applications folder
3. Eject the disk image

3. First launch

On first launch, macOS may block the app because it's from an "unidentified developer":

1. Open System Preferences → Security & Privacy → General
2. Click "Open Anyway" next to the Matchstick Events message
3. Confirm in the dialog that appears

Or from Terminal:

xattr -d com.apple.quarantine /Applications/Matchstick\ Events.app

---

Windows

1. Download the installer

Choose either:

• .msi — Standard Windows installer (recommended)
• .exe — NSIS installer (alternative)

2. Install

Run the downloaded installer and follow the prompts.

3. Windows Defender warning

You may see a "Windows protected your PC" message. Click "More info" then "Run anyway" to proceed.

---

Verifying Downloads

All release files include SHA256 checksums. To verify:

# Linux/macOS
sha256sum matchstick-events_0.0.2_amd64.deb

# Compare with the checksum in the release notes

---

Building from Source

For developers or users who prefer to build from source:

# Clone the repository
git clone https://github.com/matchstick-trading/matchstick-events-apps.git
cd matchstick-events-apps

# Install dependencies
pnpm install

# Build the desktop app
cd desktop
npm install
npm run build

The built application will be in desktop/src-tauri/target/release/bundle/.

See the README for detailed build instructions.

---

Next Steps

• Quick Start — Configure and run your first session
• Event Types — Understand the data you'll receive