$ cat INSTALL-LINUX.md

## Prerequisites

Before installing Fontmatrix, make sure your system has the following dependencies:

# Required libraries
libfreetype6-dev
libfontconfig1-dev
cmake (>= 2.8)
qt5-default (or qt6-base-dev)
libicu-dev

## Debian / Ubuntu / Linux Mint

# Install from official repositories
$ sudo apt update
$ sudo apt install fontmatrix

# Or install build dependencies and compile from source
$ sudo apt install build-essential cmake libfreetype6-dev \
    libfontconfig1-dev qtbase5-dev libicu-dev git
$ git clone https://github.com/fontmatrix/fontmatrix.git
$ cd fontmatrix && mkdir build && cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr ..
$ make -j$(nproc)
$ sudo make install

## Fedora / RHEL / CentOS

# Install from RPM repositories
$ sudo dnf install fontmatrix

# Or build from source on Fedora
$ sudo dnf install gcc-c++ cmake freetype-devel \
    fontconfig-devel qt5-qtbase-devel libicu-devel git
$ git clone https://github.com/fontmatrix/fontmatrix.git
$ cd fontmatrix && mkdir build && cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr ..
$ make -j$(nproc)
$ sudo make install

## Arch Linux / Manjaro

# Install from AUR
$ yay -S fontmatrix

# Or with pacman if available in community repo
$ sudo pacman -S fontmatrix

# Or build from source
$ sudo pacman -S base-devel cmake freetype2 fontconfig \
    qt5-base icu git
$ git clone https://github.com/fontmatrix/fontmatrix.git
$ cd fontmatrix && mkdir build && cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr ..
$ make -j$(nproc)
$ sudo make install

## openSUSE

# Install via zypper
$ sudo zypper install fontmatrix

# Build from source
$ sudo zypper install -t pattern devel_basis
$ sudo zypper install cmake freetype2-devel fontconfig-devel \
    libqt5-qtbase-devel libicu-devel git
$ git clone https://github.com/fontmatrix/fontmatrix.git
$ cd fontmatrix && mkdir build && cd build
$ cmake ..
$ make -j$(nproc)
$ sudo make install

## Flatpak (Universal)

# Install via Flatpak (works on any distro)
$ flatpak install flathub org.fontmatrix.Fontmatrix
$ flatpak run org.fontmatrix.Fontmatrix

## Post-Installation

# Verify installation
$ fontmatrix --version
fontmatrix 0.9.0

# Launch Fontmatrix
$ fontmatrix &

# Refresh font cache (if needed)
$ fc-cache -fv

# Check font directories
$ fc-list : file | head -20

## Troubleshooting

• Q: Fontmatrix won't start? → Check Qt dependencies: ldd $(which fontmatrix) | grep "not found"
• Q: Missing fonts in the list? → Run fc-cache -fv and restart Fontmatrix.
• Q: Build fails with CMake error? → Ensure cmake >= 2.8 and all -dev packages are installed.
• Q: Fonts look different in Fontmatrix? → Check your fontconfig settings in /etc/fonts/local.conf.