Use linuxdeploy GTK plugin
[geeqie.git] / appimages / README.md
index 04200d5..984f70b 100644 (file)
@@ -1,13 +1,19 @@
 # How to create AppImages for Geeqie
 
-## Download the required tools:
+## Download the required tools
+
+Download the `linuxdeploy` tools. At the time of writing, these are:
 
-Download the `linuxdeploy` tool. At the time of writing, this is:
 ```sh
-wget https://github.com/linuxdeploy/linuxdeploy/releases/download/continuous/linuxdeploy-x86_64.AppImage
+wget -c https://github.com/linuxdeploy/linuxdeploy/releases/download/continuous/linuxdeploy-x86_64.AppImage
+chmod +x linuxdeploy-x86_64.AppImage
+wget -c https://raw.githubusercontent.com/linuxdeploy/linuxdeploy-plugin-gtk/master/linuxdeploy-plugin-gtk.sh
+chmod +x linuxdeploy-plugin-gtk.sh
+sudo apt install patchelf
+sudo apt install librsvg2-dev
 ```
 
-Move this file to `$HOME/bin` or somewhere else in your `$PATH` and make executable.
+The first two of these files must be in your `$PATH` environment variable.
 
 ## Generate the executable
 
@@ -16,23 +22,27 @@ cd <your working area>
 ```
 
 Download Geeqie sources:
+
 ```sh
 git clone git://www.geeqie.org/geeqie.git
 cd geeqie
 ```
 
 If a run has already been made, remove any existing targets:
+
 ```sh
 rm -r  <target dir>/AppDir
 sudo rm -rf doc/html
 ```
 
 Create a fresh target directory:
+
 ```sh
 mkdir <target dir>/AppDir
 ```
 
 Generate the Geeqie executable:
+
 ```sh
 sudo make maintainer-clean
 ./autogen.sh --prefix="/usr/"
@@ -48,14 +58,18 @@ linuxdeploy-x86_64.AppImage \
     --appdir ./AppDir --output appimage \
     --desktop-file ./AppDir/usr/share/applications/geeqie.desktop \
     --icon-file ./AppDir/usr/share/pixmaps/geeqie.png \
+    --plugin gtk \
     --executable ./AppDir/usr/bin/geeqie`
 ```
 
 ## Rename AppImage
+
 If required, rename the AppImage executable - e.g.:
+
 ```sh
 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
 ```
 
 ## Automation script
+
 The script `./scripts/generate-appimage.sh` automates this process.