Options/Apps

Instructions

• App path: Enter a path to program. Note that "..." will allow you to choose a file from your system.^[1]
• App args: Enter args for program. ^[2]

Apps

Web browser: [3]	...
Media player: [4]	...
Image viewer: [5]	...
PDF viewer: [6]	...
DjVu viewer: [7]	...

Notes

1. ^ For app path, enter one of the following
   • An absolute path. Note that you must enter quotes if your path has spaces. For example:

   On Linux / Mac OS X: /usr/bin/vlc

   On Windows: "C:\Program Files\VLC\vlc"

   • An XOWA relative path. For example:

   On Linux / Mac OS X: ~{<>bin_plat_dir<>}vlc/vlc

   This will expand to /xowa/bin/linux/vlc/vlc

   On Windows: ~{<>bin_plat_dir<>}vlc\vlc

   This will expand to C:\xowa\bin\windows\vlc\vlc

   Note that relative paths display their expanded form (/xowa/bin/linux/), not their literal form (~{<>bin_plat_dir<>})

   i.e.: if you enter ~{<>bin_plat_dir<>} and press save, the text box will show /xowa/bin/linux/, even though the value is saved as ~{<>bin_plat_dir<>}

   • A binary name, if the binary's directory is defined in your PATH

   EX: On a Windows system with a PATH including "C:\Program Files\VLC", a value of vlc is sufficient.

   Note regarding default values:
   • For Linux / Mac OS X systems, the default values may not apply. Please change as necessary on your system
   • For Windows systems, the default path is defined as cmd and the arg is /c start "~{file}". This attempts to launch the file with the default application defined for the file.

   If this does not work properly, please specify the app path

2. ^ For app args, note the following
   • A web browser takes one argument of ~{url} which expands to the url in the external link

   EX: For https://sourceforge.net/projects/xowa/files/ the ~{url} will be https://sourceforge.net/projects/xowa/files/

   • Other content applications take one argument of ~{file} which expands to the local path for the file

   EX: The image [[File:A.png]] will produce a ~{file} of /xowa/file/en.wikipedia.org/orig/7/0/1/c/A.png

   • Customized arguments can be passed depending on the application

   EX: VLC takes an argument --no-loop which explicitly instructs VLC not to automatically replay the file. (Clicking on a pronunciation example would cause the short 1 second word to be repeated over and over again).

   To pass this argument, change the args to --no-loop "~{file}"

3. ^ Launches when clicking on external links . Recommended: Mozilla Firefox
4. ^ Launches when clicking on video or audio links . Recommended: VLC
5. ^ Launches when clicking on images in Wikimedia Commons . Recommended: GIMP
6. ^ Launches when clicking on pdf files . Recommended: Evince
7. ^ Launches when clicking on djvu files . Recommended: DjVuLibre