12 Installation
Peter Hutterer edited this page 2019-11-13 09:29:39 +10:00
This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

The recommended way of running Tuhi is by using its flatpak. This is especially true on any distrubution older than a few months.

$> flatpak install --user org.freedesktop.Tuhi
Looking for matches…
Found similar ref(s) for org.freedesktop.Tuhi in remote flathub (user).
Use this remote? [Y/n]: y
...

Running from git

Tuhi uses the meson build system. It requires the following packages to be installed:

  • Fedora: python3-devel and pygobject3-devel
  • Debian/Ubuntu: python3-dev and python3-gi

To build Tuhi, run the following commands:

 $> git clone http://github.com/tuhiproject/tuhi
 $> meson builddir
 $> ninja -C builddir
 $> ./builddir/tuhi.devel

Note the special binary tuhi.devel, it is provided to run everything from the git repository.

Installation from git

To install, simply run ninja -C builddir install after the meson stage:

 $> git clone http://github.com/tuhiproject/tuhi
 $> cd tuhi
 $> meson builddir
 $> ninja -C builddir install
 $> tuhi

Note that we now run tuhi instead of tuhi.devel - this is the system-installed version that uses system-wide modules.

Installation as locally-built flatpak

Alternatively, you can build a local flatpak and run that. For that, you need the correct SDK installed

$> flatpak --user install org.gnome.Sdk/x86_64/3.32

This SDK is used by several applications, so you may already have it installed. Leaving out the --user argument installs it system-wide.

$> git clone http://github.com/tuhiproject/tuhi
$> cd tuhi
$> flatpak-builder --install --user build-dir --force-clean org.freedesktop.Tuhi.json
   ... this builds all dependencies as well and install the flatpak
$> flatpak run org.freedesktop.Tuhi

To remove Tuhi, run flatpak remove org.freedesktop.Tuhi.

Distribution repositories

Tuhi is packaged in the following distributions:

Note that we have little influence over the distribution packages and cannot guarantee that they are up-to-date.