Setup

Gyaanmitra on Linux

Native packages for x64, Arm64, and Arm32, the architectures you will meet on Linux desktops and small boards.

Package downloads

sudo apt install ./gyaanmitra_<version>_<arch>.deb

apt install pulls in any missing shared libraries for you.

Architecture support

Windows

x64
Arm64

macOS

Apple Silicon
Intel

Linux

x64
Arm64
Arm32

Check your architecture with uname -m: x86_64 maps to the x64 build, aarch64 maps to Arm64, and armv7l maps to Arm32.

Adding an apt/yum repository (recommended for updates)

Installing from a .deb or .rpm file works. If you register Gyaanmitra's package repository, your package manager can handle later updates the same way it handles everything else:

# Debian/Ubuntu
curl -fsSL https://gunamaya.com/linux/gpg | sudo gpg --dearmor -o /usr/share/keyrings/gyaanmitra.gpg
echo "deb [signed-by=/usr/share/keyrings/gyaanmitra.gpg] https://gunamaya.com/linux/apt stable main" | sudo tee /etc/apt/sources.list.d/gyaanmitra.list
sudo apt update && sudo apt install gyaanmitra

Linux-specific notes

1

Missing shared libraries on minimal distributions

If Gyaanmitra fails to start and mentions a missing .so file, a minimal install is probably missing a GTK or libnss library that desktop installs usually already have. Install your distribution's gtk3 and libnss3 packages (or the equivalent names).

2

File watchers and inotify limits

A very large workspace can pass the default Linux limit on how many files a process can watch. You will see a warning that file watching is off for part of the workspace. Raise the limit with:

echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

3

Wayland vs. X11

Gyaanmitra runs on both. If dragging windows or fractional scaling feels off under Wayland, launch with --ozone-platform=wayland. That uses native Wayland rendering instead of XWayland.

Uninstalling

# Debian/Ubuntu
sudo apt remove gyaanmitra
 
# Fedora/RHEL
sudo rpm -e gyaanmitra

Configuration and extensions live in ~/.config/Gyaanmitra and ~/.gyaanmitra. They stay after you uninstall, so a later reinstall keeps your settings. See Portable Mode & Uninstalling if you want those gone too.