Yad

Yad

(Yad Project Page: Yad)

All GUI elements in tinkergame use yad (>=7.2).

Several distributions don't have an up-to-date yad package and/or a yad package maintainer (f.e. debian/ubuntu/mint flavours). If this applies to your distribution you have the following options to fix this:

• (find or be a maintainer for yad for your distribution)
• compile from source
• use a custom Yad
• use exodus to generate a "portable" yad bundle from another distro which has yad

(for further yad related information, this old discussion might be interesting)

Compile Yad

Compiling yad from source is not that hard. Simply follow the upstream instructions on the yad project page

Custom Yad

tinkergame has an option to define a yad binary directly from the command line, which makes a global/system-wide yad installation no longer a hard dependency (won't change the Arch PKGBUILD though)

Valid parameters for <YAD> in tinkergame yad <YAD> are:

• an absolute path to a custom binary (f.e tinkergame yad /path/to/custom/yad)
• conty (so simply tinkergame yad conty). If not found, the latest Conty release will be downloaded automatically and a yad symlink pointing to it will be defined as yad. Huge download!
• ai or appimage (so simply tinkergame yad ai or tinkergame yad appimage) (see AppImage)

The yad (10.90 (GTK+ 3.24.30)) AppImage was built on Arch Linux using https://github.com/kadogo/easy-builder (the author initially contributed the first yad AppImage used in tinkergame). The built yad has built-in support for WebKit, so the AppImage is pretty big. I won't be able to support and/or maintain custom AppImages, so you're welcome to help here!

AppImage

The ai or appimage command line option accepts multiple options:

tinkergame yad ai → current default AppImage is downloaded/used from here (built using GitHub CI) tinkergame yad ai /path/to/a/local/yad-appimage → sets the absolute path as yad command tinkergame yad ai http/s/url → multiple options:

• valid URL
  • the URL ends with AppImage → the filename will be used from the URL
  • the URL does not end with AppImage → the filename will be created from Yad-$(date +%Y%m%d)-x86_64.AppImage
• invalid URL → the failed download won't be accepted, leaving the currently set yad command untouched

tinkergame yad ai /path/to/an/unusable/file → ignored, leaving currently set yad command untouched tinkergame yad ai /invalid/absolute/path → skipped and current default AppImage is downloaded/used

• the default destination directory for downloads is ~/config/tinkergame/downloads/yadappimage/
• the default AppImage download is sha512sum-checked