# Options/Files

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

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

- Import
- Files
- Category
- Import Dansguardian

Save

## Files

Retrieval enabled: [1] |

## Cache [2]

Minumum disk space used: [3] |
Maxiumum disk space used: [4] |
Reduce cache to min[5] |
Clear cache[6] |
Info: [7] | cache folder: C:\xowa\file space used: 2.265 MB file count: 339 oldest file: 2016-03-31 20:42:31

## System Applications

ImageMagick - Identify: [8] |
ImageMagick - Convert: [9] |
Inkscape [10] |
Djvu converter [11] |

## Notes

1. ^ Choose one of the following (default is `unchecked`)
   - checked to automatically download images / retrieve images from database
     - ImageMagick and Inkscape must be installed (See Dev/File/Setup)
     - An internet connection must be available, or a local tarball must be set up. (See Archive/Usage/Offline_images)
   - unchecked to leave images unprocessed
2. ^ Although files are saved in the bin.sqlite3 database, they are also cached locally at `C:\xowa\file`. This is done for the following reasons:
   - The HTML browser must display the image: The HTML browser cannot read directly from a sqlite database. The "src" attribute must point to a file resource. (It could take a base64 encoded string, but this has its own complications)
   - Viewer apps must be able to access the image: Similar to the above, when a file is clicked in the commons wiki, XOWA sends it to an external viewer app. These viewer apps will not be able to access files from the sqlite database or from a base64 encoded string
   - Performance: Images will load more quickly if they are already on the file system (as opposed to being continually extracted from the database)
   Some other details worth noting:
   - The cache is stored in `C:\xowa\user\user-anonymous.xowa`
   - This value should not be set any lower than 5 MB (or else all images may not load on a page)
3. ^ Enter a minimum size for the cache to use (in MB) (default is `75`) .
   This is an advanced configuration tweak. When the cache reaches its maximum size, it will delete files to free space. It will continue deleting files until the minimum size is reached.
   For example:
   - If the max is set to 100 MB
   - ... and the current size of all files in the cache is 99.9 MB
   - ... and a 200 KB file is added
   - Then the cache size will be temporarily 100.1 MB
   - ... triggering the delete mechanism
   - ... which will reduce the current size of all files to 75 MB
4. ^ Enter a maximum size for the cache to use (in MB) (default is `100`) .
5. ^ Press to reduce the cache to the minimum now (typically 75 MB).
6. ^ Press to clear the cache (reduces to 0 MB).
7. ^ Miscellaneous information about the cache
8. ^ Queries image for size (needed for online images; not needed for offline databases) . Recommended: ImageMagick
9. ^ Resizes image (needed for online images; not needed for offline databases) . Recommended: ImageMagick
10. ^ Converts svg to png (needed for online images; not needed for offline databases) . Recommended: Inkscape
11. ^ Converts djvu to png (needed for online images; not needed for offline databases) . Recommended: MikTeX

### XOWA

- Main page
- Screenshots
- Download XOWA
- Download wikis

### Getting started

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

### Android

- Setup

### Help

- About
- Contents
- Media
- Feedback

### Blog

- Current

### Links

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

### Donate

- archive.org
- Wikipedia