Plugin configuration file

The plugin configuration file (.plugin extension) is used by both channel and application plugins.

• It is optional for channel plugins and is only used if the plugin wants to define parameters. This file must reside in the same directory as the plugin script itself and have the same name (except for the extension).
  
  
• It is mandatory for application plugins and must reside in the $/AppPlugins directory (or sub-directory) where it will be read by Awasu when it starts. It must contain at least the name of the plugin script, which must reside in the same directory. It can also contain definitions of any global or per-channel parameters.

The format of this file is as follows:

[Config]
Plugin=                  // Plugin script file. Must be in the same directory.
AppPluginId=             // Application plugin ID. Must be unique within Awasu and contain only
                         //   letters, digits and underscores.
AppPluginDisplayName=    // Application plugin display name that the user will see. 
AuthorName=              // Plugin author's name (optional).
AuthorEmailAddress=      // Plugin author's email address (optional).
PluginNotes=             // User notes (optional).

Defining plugin parameters

Plugins can also define user-configurable parameters. Global plugin parameters apply to all channels being serviced by the plugin and are defined as follows:

[PluginParameterDefinition-1]
Name=           // Parameter name. Must be unique.
Type=           // Parameter type. Must be one of "int", "bool", "string", "double" or "file".
DefaultValue=   // Default value (optional).
Description=    // Description of the parameter (optional).

This information can be repeated for as many parameters as the plugin wishes to define, just keep incrementing the number in the section name.

Per-channel parameters are defined in a similar way. Each channel will get its own copy of these parameters, allowing the user to configure them independently of other channels:

[ChannelParameterDefinition-1]
Name=           // Parameter name. Must be unique.
Type=           // Parameter type. Must be one of "int", "bool", "string", "double" or "file".
DefaultValue=   // Default value (optional).
Description=    // Description of the parameter (optional).

Special plugin parameters

There are several parameters that have special meaning for Awasu.

• DownloadUrl
  Contains the URL of a file that Awasu will download on behalf of the plugin.

  This is useful since Awasu will take care of cookies and proxies. Authentication details can be set in the optional DownloadUrl_UserName and DownloadUrl_Password parameters. When the plugin is run, the path to the downloaded file will be passed to the plugin in the DownloadUrlFile parameter in the [System] section of the INI file.
• ScriptTimeout
  Specifies how long the script will be allowed to run (in seconds) before Awasu will abort it.

  If this parameter is not present, Awasu will use the global default value set in the Program Options.