If no Program is specified, this option represents the entire command-line, which will be executed in the context of the default cmd.exe Command Prompt window as described above. Parameter Default: NoneĬommand-line parameters. exe "program" to run in any case, and are simply internal functions of cmd.exe. Basic "DOS" commands like "dir" or "copy" don't have any.
LEVELATOR RAINMETER PLUGIN WINDOWS
Command-line program will simply cause Windows to first execute cmd.exe anyway, to create the Command Prompt environment the program must run in. Generally it is best to leave this undefined and use the Parameter option to define the command and parameters to be executed. If not specified, the default value is the %ComSpec% environment variable (normally cmd.exe) with the parameters "\U" for Unicode pipe output and "\C" to close the Command Prompt window and exit the cmd.exe shell when finished. Options General measure optionsĪll general measure options are valid.
LEVELATOR RAINMETER PLUGIN SKIN
These can be used to take different skin actions depending on the numeric return value. If the program finishes without error, the number value of the measure will be 1, meaning "success". If an error occurs, the number value of the measure will indicate the type of error that has occurred. While the command is running, the number value of the measure will be 0. Before the command has first run, the number value of the measure will be -1. You can get the number value of the measure by using Section Variables (e.g. The number value of the measure will indicate if the command finished with or without any errors. In effect, what you would see if you manually ran the command in a cmd.exe Command Prompt window will become the string value of the measure. The string value of the measure will be any output that the program writes to STDOUT. The plugin will monitor the program defined in the Program option, and when it ends, when the executable terminates, any string output the program did to STDOUT (Standard Out) will be captured and set as the string value of the plugin measure. Command-line programs by their nature always run in a cmd.exe Command Prompt window. In most cases, the purpose of the plugin is to execute a Command Line Interface (CLI) program that takes some action or returns some value. What the plugin does when triggered with is to execute what is defined in the measure's Program option, appending any program parameters defined in the Parameter option.