# App/Xtn/Android

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

XOWA is also available as an Android application.

## Overview

The XOWA Android application is in an alpha state. Please note the following details:

- The apk works on the following devices: [1]
  - Samsung Galaxy S (Froyo)
  - Samsung Galaxy Note 2 (KitKat)
  - Samsung Galaxy Tab 4 (KitKat)
  - Samsung Galaxy S4 Mini (GT-I9195) dual core (v4.2.2 Jelly Bean) (by Anselm)
  - Andy - (Android Version 4.2.2; GT-P5200) ** (by Anselm on emulator)
  - blue stack - (Android Version 4.4.2; Model GT-N7100) ** (by Anselm on emulator)
  - Genymotion - Google Nexus 10 - 5.1.0 - API 22 - 2560x1600 ** (by Anselm on emulator)
  - Genymotion - Google Nexus 4 - 4.1.1 - API 16 - 768x1280 ** (by Anselm on emulator)
  - Genymotion - Google Nexus 4 - 4.4.4 - API 19 - 768x1280 ** (by Anselm on emulator)
  - Genymotion - Google Nexus 7 2013 - 4.4.4 - API 19 - 1200x1920 ** (by Anselm on emulator)
  - Genymotion - HTC Evo - 4.3 - API 18 - 720x1280 ** (by Anselm on emulator)
  - Genymotion - HTC One XL - 4.1.1 - API 16 - 720x1280 ** (by Anselm on emulator)
  - Genymotion - LG Optimus L3 II - 4.1.1 - API 16 - 240x320 ** (by Anselm on emulator)
  - Genymotion - Motorola Droid Razr - 4.1.1 - API 16 - 540x960 ** (by Anselm on emulator)
  - Genymotion - Motorola Moto X - 4.2.2 - API 17 - 720x1280 ** (by Anselm on emulator)
  - Genymotion - Samsung Galaxy Note 2 - 4.3 - API 18 - 720x1280 ** (by Anselm on emulator)
  - Genymotion - Samsung Galaxy Note 3 - 4.4.4 - API 19 - 1080x1920 ** (by Anselm on emulator)
  - Genymotion - Samsung Galaxy S4 - 4.4.4 - API 19 - 1080x1920 ** (by Anselm on emulator)
  - Genymotion - Sony Xperia Tablet Z - 4.1.1 - API 16 - 1920x1200 ** (by Anselm on emulator)
  - Genymotion - Sony Xperia Z - 4.3 - API 18 - 1080x1920 ** (by Anselm on emulator)
- The apk works after shutting down and starting the virtual device
  - Genymotion - Google Nexus 9 - 5.1.0 - API 22 - 2048x1536 (by Anselm on emulator)
- The apk hangs on these devices
  - Genymotion - Google Nexus 4 - 5.0.0 - API 21 - 768x1280 (by Anselm on emulator)
  - Genymotion - Google Nexus 5 - 5.1.0 - API 22 - 1080x1920 (by Anselm on emulator)
  - Genymotion - Google Nexus 7 - 5.1.0 - API 22 - 800x1280 (by Anselm on emulator)
  - Genymotion - HTC Evo - 4.1.1 - API 16 - 720x1280 (by Anselm on emulator)
  - Genymotion - HTC Evo - 4.2.2 - API 17 - 720x1280 (by Anselm on emulator)
  - Genymotion - Motorola Moto X - 4.4.4 - API 19 - 720x1280 (by Anselm on emulator)
- The apk does not work on these devices:
  - Genymotion - Motorola Moto X - 4.3 - API 18 - 720x1280 (by Anselm on emulator)
- Currently, only the following wikis are available:
  - Simple Wikipedia (text and images)
  - English Wikipedia (text)
- Functionality is limited to browsing pages in the Main namespace only

## Requirements

- Android 2.2 (Froyo) and up
- External microSD card
  - Simple Wikipedia (text and images): 3 GB of space
  - English Wikipedia (text): 28 GB

## Installation

### Set up Simple Wikipedia on your microSD card

- Create a folder on your microsSD card called `Z:\xowa\wiki\simple.wikipedia.org`. Substitute "Z:" with whatever letter your microSD card is.
- Download the simple wikibundle from https://archive.org/details/Xowa_simplewiki_latest
- Copy simple.wikipedia.org-file.xowa to the simple.wikipedia.org folder on your card.
- Download and copy the following files from http://sourceforge.net/projects/xowa/files/support/alphas/
  - simple.wikipedia.org-text.xowa
  - simple.wikipedia.org-html.xowa

### Install XOWA.apk

- Download the apk from https://github.com/gnosygnu/xowa/releases/download/v0.1/xowa_v0.1.apk
- Copy it on your microSD card. For example, place it at `Z:\xowa_v0.apk`
- Navigate to it using the "My Files" application, or any similar "File explorer" application
- Select it and install it
  - Note that it requests two permissions
    - Read to External Storage (android.permission.READ_EXTERNAL_STORAGE)
    - Write to External Storage (android.permission.WRITE_EXTERNAL_STORAGE)

### Import Simple Wikipedia

- XOWA opens up to its own file browser
- Navigate to the folder for simple.wikipedia.org
- Check the box for simple.wikipedia.org-text.xowa
- Click the "import" link in the upper-right hand corner. You may have to scroll to the right to find the link.
- Click the "simple.wikipedia.org" link. It will take you to the Earth page.

### Set up English Wikipedia on your microSD card

- Create a folder on your microsSD card called `Z:\xowa\wiki\en.wikipedia.org`. Substitute "Z:" with whatever letter your microSD card is.
- Download the English Wikipedia HTML databases from https://archive.org/details/Xowa_enwiki_latest . You'll need 30 GB of space
  - https://archive.org/download/Xowa_enwiki_latest/Xowa_enwiki_2015-06-02_wiki_core.7z
  - https://archive.org/download/Xowa_enwiki_latest/Xowa_enwiki_2015-06-02_wiki_html_ns-000_part-1.7z
  - https://archive.org/download/Xowa_enwiki_latest/Xowa_enwiki_2015-06-02_wiki_html_ns-000_part-2.7z
  - https://archive.org/download/Xowa_enwiki_latest/Xowa_enwiki_2015-06-02_wiki_html_ns-000_part-3.7z
- Download the English Wikipedia files from https://archive.org/details/Xowa_enwiki_latest . You'll need another 70 GB of space.
  - https://archive.org/download/Xowa_enwiki_latest/Xowa_enwiki_2015-06-02_file_v2b_core.7z
  - https://archive.org/download/Xowa_enwiki_latest/Xowa_enwiki_2015-06-02_file_v2b_ns-000_part-1.7z
  - https://archive.org/download/Xowa_enwiki_latest/Xowa_enwiki_2015-06-02_file_v2b_ns-000_part-2.7z
  - https://archive.org/download/Xowa_enwiki_latest/Xowa_enwiki_2015-06-02_file_v2b_ns-000_part-3.7z
  - https://archive.org/download/Xowa_enwiki_latest/Xowa_enwiki_2015-06-02_file_v2b_ns-000_part-4.7z
  - https://archive.org/download/Xowa_enwiki_latest/Xowa_enwiki_2015-06-02_file_v2b_ns-000_part-5.7z
  - https://archive.org/download/Xowa_enwiki_latest/Xowa_enwiki_2015-06-02_file_v2b_ns-000_part-6.7z
  - https://archive.org/download/Xowa_enwiki_latest/Xowa_enwiki_2015-06-02_file_v2b_ns-000_part-7.7z
  - https://archive.org/download/Xowa_enwiki_latest/Xowa_enwiki_2015-06-02_file_v2b_ns-000_part-8.7z
  - https://archive.org/download/Xowa_enwiki_latest/Xowa_enwiki_2015-06-02_file_v2b_ns-100.7z

### Requested feedback

If you want to help out, please post any of the following to https://github.com/gnosygnu/xowa/wiki/Android

- What device are you using?
- How much space is on your SD card?
- How fast / slow is navigation between pages?
- Do images load?
- What essential features do you think are missing?

## Features

- Shows all mainspace articles with HTML.
- Displays images from the XOWA database.
- Renders Math formulas through MathJax.
- Shows missing links as regular text (black color, not red color)
- Uses a CSS similar to the Mobile Wikipedia version

## To-do list

- HTML databases for English Wikipedia and other wikis
- Page history
- Bookmarks
- Multiple wiki support
- Find word
- Search
- Switch to desktop CSS

1. ^ See: https://sourceforge.net/p/xowa/discussion/general/thread/cd3d55ee/

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