New plugin hook: finalizeTranscoderArgs

[chocolateboy]

As of PMS 1.30.0, a new plugin hook will be available (actually, it's available already, but the API is fixed in 1.30.0). The hook allows plugins to easily customize transcoder command-line arguments before PMS launches the command.

Plugins that wish to utilize this hook can do so by implementing the net.pms.external.FinalizeTranscoderArgsListener interface:

Code: Select all

public interface FinalizeTranscoderArgsListener extends ExternalListener {
    public List<String> finalizeTranscoderArgs(
        Player player,
        String fileName,
        DLNAResource dlna,
        DLNAMediaInfo media,
        OutputParams params,
        List<String> cmdList
    );
}


The parameters should be self-explanatory. Plugins can modify cmdList in-place and return that or return a new List. The hook is called at the last point before the command is executed.

This hook is available for all built-in engines (MEncoderVideo, MPlayerAudio, TSMuxerVideo &c.) and can easily be used by custom subclasses of the builtin engines (see PMSEncoder for an example of a custom transcoding engine).

For an example plugin that uses the new API, see PMS-EDL.