appimages/README.md

   1 # How to create AppImages for Geeqie
   2
   3 ## Download the required tools:
   4
   5 Download the `linuxdeploy` tool. At the time of writing, this is:
   6
   7 `wget https://github.com/linuxdeploy/linuxdeploy/releases/download/continuous/linuxdeploy-x86_64.AppImage`
   8
   9
  10 Move this file to `$HOME/bin` or somewhere else in your `$PATH` and make executable.
  11
  12
  13 ## Generate the executable
  14
  15 `cd <your working area>`
  16
  17 Download Geeqie sources:
  18 `git clone git://www.geeqie.org/geeqie.git`
  19 `cd geeqie`
  20
  21 If a run has already been made, remove any existing targets:
  22 `rm -r  <target dir>/AppDir`
  23 `sudo rm -rf doc/html`
  24
  25 Create a fresh target directory:
  26 `mkdir <target dir>/AppDir`
  27
  28 Generate the Geeqie executable:
  29 `sudo make maintainer-clean`
  30 `./autogen.sh --prefix="/usr/"`
  31 `make -j`
  32 `make install DESTDIR=<full path to target dir>/AppDir`
  33
  34 ## Generate the AppImage
  35
  36 `cd <target dir>`
  37 `linuxdeploy-x86_64.AppImage \`
  38 `--appdir ./AppDir --output appimage \`
  39 `--desktop-file ./AppDir/usr/share/applications/geeqie.desktop \`
  40 `--icon-file ./AppDir/usr/share/pixmaps/geeqie.png \`
  41 `--executable ./AppDir/usr/bin/geeqie`
  42
  43 ## Rename AppImage
  44 If required, rename the AppImage executable - e.g.:
  45 `mv ./Geeqie-v1.6-x86_64.AppImage $(./Geeqie-v1.6-x86_64.AppImage -v | sed 's/git//' | sed 's/-.* /-/' | sed 's/ /-v/' | sed 's/-GTK3//').AppImage`
  46
  47 The script `./scripts/generate-appimage.sh` automates this process.