Initial commit

Author: TheAssassin

.gitignore

@@ -0,0 +1,3 @@
+*.swp
+*AppDir*/
+*.AppImage*

LICENSE.txt

@@ -0,0 +1,19 @@
+Copyright 2021 TheAssassin, X0rg and the linuxdeploy contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,43 @@
+# Collection of miscellaneous linuxdeploy plugins
+
+This repository contains miscellaneous [linuxdeploy plugins](https://github.com/linuxdeploy/linuxdeploy/wiki/Plugin-system). They're mostly written in plain bash (or even just Bourne shell).
+
+
+## Usage
+
+```bash
+# get linuxdeploy
+> wget -c "https://github.com/linuxdeploy/linuxdeploy/releases/download/continuous/linuxdeploy-x86_64.AppImage"
+
+# get some plugin
+> wget -c "https://raw.githubusercontent.com/linuxdeploy/misc-plugins/master/demo/linuxdeploy-plugin-demo.sh"
+
+# first option: install your app into your AppDir via `make install` etc.
+# second option: bundle your app's main executables manually
+# see https://docs.appimage.org/packaging-guide/from-source/native-binaries.html for more information
+> [...]
+
+# call through linuxdeploy
+> ./linuxdeploy-x86_64.AppImage --appdir AppDir --plugin demo --output appimage --icon-file mypackage.png --desktop-file mypackage.desktop
+```
+
+
+## Contributing new plugins
+
+Plugins in this repository must be "download, make executable, run". That means that they must be written in script languages that are typically available on systems (e.g., bash). They must be able to run standalone (that means, making them executable and running them without linuxdeploy should yield some useful log). The files must respect the linuxdeploy [plugin naming](https://github.com/linuxdeploy/linuxdeploy/wiki/Plugin-system#plugin-naming), and implement the [mandatory CLI parameters](https://github.com/linuxdeploy/linuxdeploy/wiki/Plugin-system#mandatory-parameters).
+
+Most of these plugins just call other tools on the system, install AppRun hooks, or perform other simple tasks. More complex ones should be moved into dedicated repositories.
+
+Plugins may have dependencies on system tools. Ideally, these are commonly available (e.g., `readelf`). They should always check whether these are available, and either hard-fail (print error and exit), or warn the user and deactivate certain functionality if programs cannot be found in `$PATH`.
+
+linuxdeploy can be expected to be available (`$LINUXDEPLOY` usually points to a working binary), and it can be used to perform certain tasks such as bundling additional binaries or libraries along with their dependencies.
+Even though `$LINUXDEPLOY` is set by linuxdeploy automatically, the plugin should always check for its existence (e.g., with `[ -x "$LINUXDEPLOY" ]`) and provide meaningful feedback.
+
+The `demo` plugin is a very simple, minimal working example plugin. Please feel free to take it as an inspiration for your own plugins.
+
+Only plugins with free software licenses (recognized by the OSI) are accepted into this repository. It is highly recommended to use the MIT license (the same license linuxdeploy and all official plugins use), but it's not mandatory. However, if your plugin uses a non-permissive license (e.g., a copyleft one), it might be rejected, depending on how it works.
+
+
+## Licensing
+
+All plugin scripts reside in subdirectories of this repository, along with a README. If there is no LICENSE file next to the plugin script, the license in `LICENSE.txt` in the root directory of the repository applies.

demo/README.md

@@ -0,0 +1,20 @@
+# linuxdeploy-plugin-demo
+
+This is a minimal demo of a linuxdeploy plugin written in plain bash. You can use it as a template for other plugins.
+
+
+## Usage
+
+```bash
+# get linuxdeploy and linuxdeploy-plugin-demo
+> wget -c "https://github.com/linuxdeploy/linuxdeploy/releases/download/continuous/linuxdeploy-x86_64.AppImage"
+> wget -c "https://raw.githubusercontent.com/linuxdeploy/misc-plugins/master/demo/linuxdeploy-plugin-demo.sh"
+
+# first option: install your app into your AppDir via `make install` etc.
+# second option: bundle your app's main executables manually
+# see https://docs.appimage.org/packaging-guide/from-source/native-binaries.html for more information
+> [...]
+
+# call through linuxdeploy
+> ./linuxdeploy-x86_64.AppImage --appdir AppDir --plugin demo --output appimage --icon-file mypackage.png --desktop-file mypackage.desktop
+```

demo/linuxdeploy-plugin-demo.sh

@@ -0,0 +1,45 @@
+#! /bin/bash
+
+# exit whenever a command called in this script fails
+set -e
+
+appdir=""
+
+show_usage() {
+    echo "Usage: bash $0 --appdir <AppDir>"
+}
+
+while [ "$1" != "" ]; do
+    case "$1" in
+        --plugin-api-version)
+            echo "0"
+            exit 0
+            ;;
+        --appdir)
+            appdir="$2"
+            shift
+            shift
+            ;;
+        *)
+            echo "Invalid argument: $1"
+            echo
+            show_usage
+            exit 2
+    esac
+done
+
+if [[ "$appdir" == "" ]]; then
+    show_usage
+    exit 2
+fi
+
+echo "Hello, this is linuxdeploy-plugin-demo"
+echo "\$LINUXDEPLOY: \"$LINUXDEPLOY\""
+
+# install a demo AppRun hook
+# usually, they're not supposed to print anything, but remain as silent as possible
+set -x
+mkdir -p "$appdir"/apprun-hooks
+cat > "$appdir"/apprun-hooks/linuxdeploy-plugin-demo.sh <<\EOF
+echo "Hello from linuxdeploy-plugin-demo"
+EOF