Product page: Command Status for Windows · Get it on the Elgato Marketplace
Email contact@gramshift.com in English or Japanese. We reply within 7 business days, usually sooner. Please include your Windows version, your Stream Deck app version, the command and the "Run with" choice (remove anything secret), and, if possible, a photo or screenshot of the key and of its settings. Please do not send passwords, keys or other secrets.
npm test, and the Folder it runs in, for example C:\Users\you\source\app. Tip: in File Explorer, select a folder and press Ctrl+Shift+C ("Copy as path"), then paste it. Quotes are removed, and %USERPROFILE% style variables and a leading ~ work. An empty folder means your user folder. A network folder (\\server\share) can not be used with Command Prompt, because cmd.exe does not run in such a folder (it would run in C:\Windows instead); the key then shows ERROR. Use Windows PowerShell or a mapped drive letter.cmd.exe /d /s /c "<command>", so &, > and .bat / .cmd files work as in a Command Prompt), Windows PowerShell (powershell.exe -NoProfile -NonInteractive; when the last statement of your command fails, the exit code is that of the last program it ran, or 1 for a PowerShell error, so success codes such as 0-7 for robocopy work here too), or Program (no shell) (the first word, or a quoted path, is the program; the rest of the line is passed to it unchanged).| Key | Meaning |
|---|---|
Green frame, OK | The command ended with a success exit code (default 0). |
Red, FAILED | The command ended with another exit code. The code is shown, for example exit 1. A command that Command Prompt does not know ends with exit 1 and its message is the last line. |
Red, TIMED OUT | The command ran longer than the time limit (default 10 minutes). It and any programs still running under it were ended. |
Gray, STOPPED | You pressed the key while it ran. It and any programs still running under it were ended. |
Red, NOT FOUND | With "Program (no shell)": the program was not found. Check the name or path, or use Command Prompt. |
Red, NO FOLDER | The working folder does not exist or is not a full path (a full path starts with a drive letter such as C:\, or with \\server\). |
Red, ERROR | The command could not be started. use cmd for .bat / .cmd: a batch file can not be started as a program; choose Command Prompt. |
A red key also shows the Stream Deck warning triangle once. A Watch Command key that keeps failing shows it only when it turns from OK to failed, not at every run.
A program that needs an exit code other than 0 for success.
Enter the Success codes: numbers and ranges separated by commas, for example 0-7 for robocopy or 0, 1. Parts that are not understood are ignored and named in the Result line.
The command asks a question and never ends.
Commands get no input, so a question gets no answer. Most programs then stop with an error; others wait until the time limit. Use the program's option to run without questions (for example --yes or /Y).
Japanese or other non-English output looks wrong.
The plugin reads each line as UTF-8 when it is valid UTF-8 and otherwise in your console code page (on Japanese Windows, Shift_JIS), and it reads English UTF-16 output too. Japanese text from cmd /u (UTF-16) shows as an empty line. If a program writes in yet another encoding, its lines may look wrong; the exit code and the colors are not affected.
Very long output.
Only the last 64 KB are kept. The Result line then says so.
A .ps1 script turns the key red with exit 1.
PowerShell commands typed on the key run as they are, but the Windows default execution policy (Restricted) blocks script files. Choose Command Prompt (cmd) and run powershell -ExecutionPolicy Bypass -File "C:\path\script.ps1". A policy set by your organization through Group Policy still applies.
A program with its own window.
Run through Command Prompt, it keeps the key on running until you close it, and the time limit (default 10 minutes) ends it along with any unsaved work. With Program (no shell) its window may not appear. To only open a program, use Command Prompt: start "" program.exe.
A tool I just installed is not found.
Commands get the environment the Stream Deck app started with, so restart the Stream Deck app. Windows PowerShell runs without your profile and Command Prompt without AutoRun.
Programs started in the background by my command.
When a command ends by itself, programs it started to keep running (for example a server started with start) are left alone. When the plugin ends a command (at the time limit, when you press the key while it runs, and when the Stream Deck app closes), it ends the command and the programs running under it. A program whose starter has already exited (some launchers work that way) is no longer under the command and keeps running.
Deleting a key while its command runs.
The command keeps running until it ends or reaches its time limit. Press the key to stop it before you delete it.
Does it run as administrator?
The plugin never asks for administrator rights. Commands run with the same Windows account and permissions as the Stream Deck app (normally your user without administrator rights). A command that needs administrator rights then fails, or opens a Windows prompt, depending on the program.
Does it work on Mac?
No. This plugin is for Windows 10 or later only.
Enter your license key in the settings of any key. If it fails, email contact@gramshift.com.
New versions: download the latest one from your thank-you page or the license key page you received. Your license key keeps working.
Refunds: if the plugin does not work on your PC, email contact@gramshift.com within 14 days of purchase for a full refund. You can also ask Link support. The license key stops working after a refund.
The plugin runs entirely on your PC and sends no data anywhere. A copy bought directly from GRAMSHIFT also goes online to check its license key. See the Privacy Policy.