URL overrides

Android · Linux · macOS · Windows
View Markdown

A URL override adds an extra entry under every item URL that matches its regular expression. The entry opens a rewritten URL, or runs a command on your device.

Add a URL override

  1. In Settings > Other > URL overrides, select Add.
  2. Fill in the fields listed in Fields.
  3. Select OK. Items with a matching URL show the override under that URL.

To run a cmd:// override, open the entry’s menu and select Execute.

Fields

FieldValue
NameThe label of the override’s entry on the item
Regular expressionThe override applies to URLs that this expression matches. It must match the whole URL.
CommandThe new URL, usually built with Placeholders. A command that starts with cmd:// runs the rest as a shell command.
EnabledOn by default. Turn it off to keep the override without applying it.

A cmd:// command runs in the platform’s shell:

PlatformShell
Androidsh
Linux, macOSbash
Windowscmd

Examples

This override adds an HTTPS version of every http:// URL. Where you can, change the item’s URL to https:// instead.

Regular expression: ^http://.*
Command:            https://{url:rmvscm}

Add this URL to the item:

ftp://{username}:{password}@example.com

If your FTP client registers itself for ftp:// links, the URL works as is. Otherwise, add this override on Linux. It starts FileZilla with your credentials filled in.

Regular expression: ^ftp://.*
Command:            cmd://filezilla {url}

Limitations

BuildLimitation
Flatpakcmd:// commands run inside the Flatpak sandbox, so they can’t start programs installed on the host.