From bb6f9b136bb32560cc81e84afab400738471bc3e Mon Sep 17 00:00:00 2001
From: Kitty <ioanaavram46@yahoo.com>
Date: Fri, 18 Apr 2025 14:19:12 +0100
Subject: [PATCH 1/3] adding appimage guide

---
 source/desktop/creating-app-image.rst | 98 +++++++++++++++++++++++++++
 1 file changed, 98 insertions(+)
 create mode 100644 source/desktop/creating-app-image.rst

diff --git a/source/desktop/creating-app-image.rst b/source/desktop/creating-app-image.rst
new file mode 100644
index 0000000..19c680e
--- /dev/null
+++ b/source/desktop/creating-app-image.rst
@@ -0,0 +1,98 @@
+Manual AppImage Build for Cryptomator
+======================================
+
+Prerequisites
+-------------
+
+Install the following packages before following the guide if you don't have them already. You will also need JDK 23 (Bellsoft JDK works fairly well) as well as per the Github docs:
+
+.. code-block:: bash
+
+    sudo apt install maven squashfs-tools unzip curl
+
+Download the AppImage tool:
+
+.. code-block:: bash
+
+    curl -LO https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage
+    chmod +x appimagetool-x86_64.AppImage
+
+Clone and Build the Project
+---------------------------
+
+.. code-block:: bash
+
+    git clone https://github.com/cryptomator/cryptomator.git
+    cd cryptomator
+    mvn clean install -Plinux
+
+Optionally test the JAR file
+----------------------------
+
+.. code-block:: bash
+
+    java -Dcryptomator.ipcSocketPath=/tmp/cryptomator.sock \
+         -Dcryptomator.mountPointsDir=/tmp/cryptomounts \
+         -cp "/your/path/to/cryptomator/target/mods/*:cryptomator-1.16.0-SNAPSHOT.jar" \
+         org.cryptomator.launcher.Cryptomator
+
+.. note::
+   This is required because there's no main manifest defined. The mount point and IPC socket are also mandatory for unlocking vaults.
+
+Build the AppImage folder
+-------------------------
+
+1. Create a folder named ``Cryptomator.AppDir``.
+2. Inside it, place:
+
+   - ``AppRun`` (see below)
+   - A ``.desktop`` file
+   - App icon (``.png``)
+   - A ``usr/`` folder
+
+Inside ``usr/`` create:
+
+::
+
+    usr/
+    ├── bin/         → place your JAR and ``mods/`` folder here
+    └── share/
+        ├── icons/
+        ├── applications/
+        ├── mime/packages/
+        └── metainfo/
+
+.. tip::
+   You can get all the required files from the cloned repository, except the AppRun file and the jar binary, which must be manually made, by running maven.
+
+Build the AppRun Script
+-----------------------
+
+.. code-block:: bash
+
+    #!/bin/bash
+    HERE="$(dirname "$(readlink -f "${0}")")"
+    java -Dcryptomator.ipcSocketPath=/tmp/cryptomator.sock \
+         -Dcryptomator.mountPointsDir=/tmp/cryptomounts \
+         -cp "$HERE/usr/bin/mods/*:$HERE/usr/bin/cryptomator-1.16.0-SNAPSHOT.jar" \
+         org.cryptomator.launcher.Cryptomator
+
+Make it executable:
+
+.. code-block:: bash
+
+    chmod +x AppRun
+
+Change the .desktop file to execute from the AppRun file, before running appimage tool.
+
+
+Build the AppImage
+------------------
+
+.. code-block:: bash
+
+    ARCH=x86_64 ./appimagetool-x86_64.AppImage Cryptomator.AppDir
+
+Replace the folder name if needed. Then just make the `.AppImage` executable and run it.
+
+Done!

From ece3fed6bfe0a67e3d8f88172916c615c26592e9 Mon Sep 17 00:00:00 2001
From: Kitty <ioanaavram46@yahoo.com>
Date: Fri, 18 Apr 2025 16:17:08 +0100
Subject: [PATCH 2/3] Update creating-app-image.rst

---
 source/desktop/creating-app-image.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/desktop/creating-app-image.rst b/source/desktop/creating-app-image.rst
index 19c680e..a4984ea 100644
--- a/source/desktop/creating-app-image.rst
+++ b/source/desktop/creating-app-image.rst
@@ -33,7 +33,7 @@ Optionally test the JAR file
 
     java -Dcryptomator.ipcSocketPath=/tmp/cryptomator.sock \
          -Dcryptomator.mountPointsDir=/tmp/cryptomounts \
-         -cp "/your/path/to/cryptomator/target/mods/*:cryptomator-1.16.0-SNAPSHOT.jar" \
+         -cp "/your/path/to/cryptomator/target/mods/*:/your/path/to/cryptomator/target/cryptomator-1.16.0-SNAPSHOT.jar"\
          org.cryptomator.launcher.Cryptomator
 
 .. note::

From 6de7b564a7491e2c75bb001e093f020e715bfe69 Mon Sep 17 00:00:00 2001
From: Kitty <ioanaavram46@yahoo.com>
Date: Fri, 18 Apr 2025 17:06:29 +0100
Subject: [PATCH 3/3] added the file to the index page

---
 source/index.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/source/index.rst b/source/index.rst
index 47d3b86..0f0c0a9 100644
--- a/source/index.rst
+++ b/source/index.rst
@@ -20,6 +20,7 @@ If you are interested in the security of Cryptomator, have a look at our :ref:`s
    :caption: Desktop
 
    desktop/setup.rst
+   desktop/creating-app-image.rst
    desktop/getting-started.rst
    desktop/adding-vaults.rst
    desktop/accessing-vaults.rst