6.2 Installation

Hollywood plugins use the file extension *.hwp. The location where Hollywood plugins must be installed differs from platform to platform. Here is a breakdown of the different search paths that Hollywood will scan for plugins:

• – AmigaOS and compatibles: Plugins can either be stored in a directory named Plugins that is in the same directory as the Hollywood interpreter or they can be installed globally in LIBS:Hollywood. Hollywood will first look for plugins in the Plugins directory in its program directory, then it will scan LIBS:Hollywood.

• – Android: The Android version of Hollywood also supports Hollywood plugins. You have to copy them to the directory Hollywood/Plugins on your SD card. Hollywood will scan this location on every startup and load all plugins from there.

• – Linux: Plugins must be stored in a directory named Plugins (case sensitive!) that is in the same directory as the Hollywood interpreter.

• – macOS: ~/Library/Application Support/AirsoftSoftwair/Hollywood/Plugins is the directory that should be used for storing plugins. If it doesn't exist, just create it. Alternatively, you can also store plugins inside Hollywood's app bundle in Hollywood.app/Contents/Resources/Plugins but this isn't recommended because it requires you to modify the Hollywood distribution and it might also require administrator privileges.

• – Windows: C:\Users\...\AppData\Local\AirsoftSoftwair\Hollywood\Plugins is the directory that should be used for storing plugins. If it doesn't exist, just create it. Alternatively, you can also store plugins in the Plugins directory in Hollywood's installation directory, e.g. in C:\Program Files\Hollywood\Plugins but this isn't recommended because it requires you to modify the Hollywood distribution and it might also require administrator privileges to write to Hollywood's installation directory.

All these search paths can also be modified by editing the file sysroot.conf that is part of the Hollywood installation. Alternatively, you can also use the ‘-sysroot’ and ‘-postsysroot’ console arguments to modify Hollywood's search paths. See Console arguments for details.

When distributing a compiled Hollywood program, plugins required by your program must simply be put into the same directory as your program. The only exception is when compiling application bundles for macOS: In the case of macOS app bundles, plugins need to be put into the Resources directory of the application bundle, i.e. in MyProject.app/Contents/Resources.

Of course, plugins can also be linked directly into the executables you compile with Hollywood. In that case, you don't have care about where to put plugins at all. See Linking plugins for details.