Command Runner (plugin ID 'azexec')
This plugin runs a configurable command on completion of a download.
It also supports invocation as a script from a BiglyBT Tag's "Execute On Assign" action using the script syntax of "plugin( azexec, "command" ) since BiglyBT 2801_B16 and plugin version 1.4.8
Since version 1.4.9 and BiglyBT 2801_B19 it also supports single invocation from a script with multiple downloads selected. In this case the variables expansions result in a list of values, not a single value. For example, if you select two downloads with display names "dn1" and "dn2" and then tag them at the same time the %N variable with be expanded to "dn1 dn2" (no quotes unless you add them. To indicate that you want this new behaviour (as opposed to separate invocations) you need to add a "+" to the plugin id - "plugin( azexec+, "command" )
The command supports the following variable expansions:
- %F - Name of the downloaded file (for single file torrents)
- %D - Directory where files are saved
- %N - Displayed name of the download
- %L - Torrent Category/Label
- %T - Tracker Name
- %I - Hex encoded info-hash
- %K - Kind of torrent (single|multi)
- %M - Full torrent file name
- %P - Save path of the torrent (since 1.4.9)
Say you want to execute a command when a completed download enters a stopped state.
Create a new Tag (e.g. go to View->Tags Overview and hit the 'Add Tag...' button top right).
Go to the settings for the Tag and set its constraint to "isComplete() && isStopped()" - make sure you do this BEFORE setting the Tag's "execute on assign" value unless you want to execute the command on all existing completed and stopped downloads...)
Right-click on the Tag and select "Execute On Assign->Script" and then enter "plugin( azexec, command-to-run )"