Commandline Arguments#

If you start disco on the commandline you can pass arguments to the app.

Available Arguments#

-d, --debug#

Enables debug logging.

--db path#

Custom path to the *.json file for the app database.

--devtools#

Shows Chrome DevTools in App-Window.

--disk-cache-size size#

Maximum disk space to be used by the disk cache, in bytes.

--host-rules rules#

A comma-separated list of rules that control how hostnames are mapped.

For example:

  • MAP * 127.0.0.1 Forces all hostnames to be mapped to 127.0.0.1
  • MAP *.google.com proxy Forces all google.com subdomains to be resolved to "proxy".
  • MAP test.com [::1]:77 Forces "test.com" to resolve to IPv6 loopback. Will also force the port of the resulting socket address to be 77.
  • MAP * baz, EXCLUDE www.google.com Remaps everything to "baz", except for "www.google.com".

These mappings apply to the endpoint host in a net request (the TCP connect and host resolver in a direct connection, and the CONNECT in an HTTP proxy connection, and the endpoint host in a SOCKS proxy connection).

--host-resolver-rules rules#

Like --host-rules but these rules only apply to the host resolver.

-p, --pid-dir path#

Linux, macOS

Custom path to the directory, where the disco.pid will be located.

--plugin-configs path#

Custom path to the *.json file for the plugin configurations.

--plugins-dir path#

Custom path to the directory, where plugins will saved.

--proxy-bypass-list hosts#

Instructs Electron to bypass the proxy server for the given semi-colon-separated list of hosts. This flag has an effect only if used in tandem with --proxy-server.

For example:

  • Will use the proxy server for all hosts except for local addresses (localhost, 127.0.0.1 etc.), google.com subdomains, hosts that contain the suffix foo.com and anything at 1.2.3.4:5678.

--proxy-pac-url url#

Uses the PAC script at the specified url.

--proxy-server address:port#

Use a specified proxy server, which overrides the system setting. This switch only affects requests with HTTP protocol, including HTTPS and WebSocket requests. It is also noteworthy that not all proxy servers support HTTPS and WebSocket requests. The proxy URL does not support username and password authentication per Chromium issue.

--no-proxy-server#

Don't use a proxy server and always make direct connections. Overrides any other proxy server flags that are passed.

-v, --verbose#

Enables logging to the CLI.

Passing arguments#

AppImage on Linux#

To pass arguments on Linux you have prependend -- before.

./<PATH_TO>/<APP_IMAGE> -- <ARGS>

macOS#

To pass arguments on macOS you have prependend --args before.

./<PATH_TO>/disco.app --args <ARGS>
Last update: March 4, 2020