linuxdeployqt/README.md

# linuxdeployqt

linuxdeployqt takes an application as input and makes it self-contained by copying in the Qt libraries and plugins that the application uses into an [AppDir](http://rox.sourceforge.net/desktop/AppDirs.html) bundle. This can optionally be put into an [AppImage](http://appimage.org/). It is based on macdeployqt in the tools applications of the Qt Toolkit.

## Known issues

* __This is not fully working yet.__ This is not ready for production use. Help is appreciated.
* Some functions still refer to macOS specifics. These need to be converted over to their Linux counterparts or deleted.

## Installation

* Open in Qt Creator and build
* Build and install [patchelf](https://nixos.org/patchelf.html) (a small utility to modify the dynamic linker and RPATH of ELF executables; similar to `install_name_tool` on macOS). To learn more about this, see http://blog.qt.io/blog/2011/10/28/rpath-and-runpath/

## Usage

```
Usage: linuxdeployqt app-binary [options]

Options:
   -verbose=<0-3>     : 0 = no output, 1 = error/warning (default), 2 = normal, 3 = debug
   -no-plugins        : Skip plugin deployment
   -appimage          : Create an AppImage
   -no-strip          : Don't run 'strip' on the binaries
   -use-debug-libs    : Deploy with debug versions of libraries and plugins (implies -no-strip)
   -executable=<path> : Let the given executable use the deployed libraries too
   -qmldir=<path>     : Scan for QML imports in the given path
   -always-overwrite  : Copy files even if the target file exists
   -libpath=<path>    : Add the given path to the library search path

linuxdeployqt takes an application as input and makes it
self-contained by copying in the Qt libraries and plugins that
the application uses.
```