The Philter Studio command line interface (CLI) lets you filter files and documents from the command line without having to use the Philter Studio user interface. The purpose of the CLI is to provide an interface to Philter on Windows desktops that can be used through scripts or integrated with other applications.
The Philter Studio executable is named
PhilterStudioCLI.exe and is located in Philter Studio's installation directory. The installation directory is
C:\Program Files\Philter Studio unless a different folder was selected during the setup.
PhilterStudioCLI.exe without any parameters will show the usage details:
$ PhilterStudioCLI.exe2020-04-01 11:17:34,674 INFO PhilterStudio.CLI - Starting Philter Studio CLI 18.104.22.168Philter Studio CLI 22.214.171.124Copyright (c) 2020 Mountain Fog, Inc.ERROR(S):Required option 'f, filenames' is missing.-v, --verbose Set output to verbose messages.-c, --context The filtering context.-p, --profile The name of the filter profile.-h, --host The Philter host.-i, --ignoreSsl Ignore certificate validation errors.-f, --filenames Required. One or more files to process.--help Display this help screen.--version Display version information.
The only required parameter is
-f which is the file name to filter:
PhilterStudioCLI.exe -h https://192.168.1.1:8080 -f c:\file.txt
Multiple files can be specified by listing them:
PhilterStudioCLI.exe -h https://192.168.1.1:8080 -f c:\file1.txt c:\file2.txt c:\file3.txt
The two above examples will send the file or document to Philter using the context
none and the filter profile
default. To specify a context and a filter profile we can use the
-p options, respectively:
PhilterStudioCLI.exe -h https://192.168.1.1:8080 -f c:\file.txt -c my-context -p my-filter-profile
The filtered file or document will be written to the same folder that contains the input file with
_filtered appended to the file name. For example, for an input file
c:\My Documents\file.txt, the filtered file will be written to
These parameters are required when running
Specifies one or more files or documents to process.
These parameters are optional when running
Enables verbose output. Use this option to get more insight into what is happening to assist with troubleshooting.
Specifies the context. If not provided, the default context is retrieved from Philter Studio's settings.
Specifies the filter profile. If not provided, the default filter profile name is retrieved from Philter Studio's settings.
Specifies the Philter host, e.g.
Disables certificate validation errors when communicating with Philter. This is intended only for development and test usage.