# Options/Apps

From XOWA: the free, open-source, offline wiki application

Apps (basic) | Apps (advanced) | Wiki | HTML | External apps | Modules | Extensions | Misc

- Content apps
- Firefox addon
- HTTP server

Save

## 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

### XOWA

- Main page
- Screenshots
- Video
- Download XOWA
- Download wikis

### Getting started

- Requirements
- Installation
- Simple Wikipedia
- English Wikipedia
- Other Wikipedias

### Android

- Setup
- Video

### Help

- About
- Contents
- Media
- Feedback

### Blog

- Current

### Links

- Wikimedia dumps
- XOWA @ archive.org
- English Wikipedia

### Donate

- archive.org
- Wikipedia