This topic provides a basic introduction to using software tools that do not have a graphical user interface (GUI) and instead can only be used at the Windows Command Prompt.
Several of the applications available on this site are command-line only applications. This means that they do not have a graphical user interface (GUI) and, instead, must be run via the Windows Command Prompt. The following discussion is provided to help you run command line applications.
You will know the program is a command line application if you see one of the following behaviors:
You run the program shortcut (e.g. Start->Programs->PAST Toolkit->Residue Frequency Summarizer) and a black window appears in the background, while a Program Syntax window appears in the foreground (see Figure 1 in CommandLineHelp.pdf, available below) You navigate to the program’s folder in C:\Program Files\ and double click the program executable (e.g. ResidueFrequencySummarizer.exe) and, again, you see a black window in the background and a syntax window in the foreground (see Figure 1 in CommandLineHelp.pdf) You run the program (either by shortcut or double clicking the .Exe) and a black window appears very briefly and then disappears (see Figure 2 in CommandLineHelp.pdf)
In order to properly run a command line application, you will need to follow these steps. Note that CommandLineHelp.pdf (available below) also includes screenshots for these steps.
When running a command line program, you will typically need to pass some information to the program, e.g. a filename to process or a parameter that specifies a processing option. Windows command line programs typically use the / character (forward slash) for a switch, though sometimes the - character (dash) is used instead. In the example shown in the above figure, the /i switch was used to specify the input file for the program, like this:
Each command line program available on this site should include a Readme.txt file that explains the switches appropriate for the given program. Alternatively, if you run the program without any switches, or with the /? switch, you should see the program syntax, either in a new window or in the command prompt window (as shown in Figures 1 and 2, above).
You can find numerous web pages that describe the use of the command prompt in Windows. For example, the top hits for googling using the windows command prompt include tutorials at these sites: