kiwix-js-pwa/AppPackages

Installation Instructions (Windows 10 Mobile or PC required)

The easiest way to install Kiwix JS Windows is from the Microsoft Store:

https://www.microsoft.com/en-gb/store/p/kiwix-js/9p8slz4j979j

If you prefer not to use the Microsoft Store or wish to test a different build, please follow the instructions below. Uninstall any previous installation of Kiwix JS Windows before you follow this procedure:

Windows 10 Mobile

Download the .appx or .appxbundle under AppPackages/KiwixWebApp_0.x.x.x_[AnyCPU]_Test/ and save it in your downloads folder, or other accessible folder, on the phone. Instead of one of the packages above, you may prefer to use an .appxbundle from https://github.com/kiwix/kiwix-js-windows/releases (they are the same). Enable Developer mode on your device (Settings / Updates and security / For developers). Open the File Explorer on the phone, navigate to the downloads folder and tap the KiwixWebApp bundle. You will be asked if you wish to install, but it then installs silently in the background. Be patient: it can take a minute or so for the Kiwix icon to appear in the All Apps list. You will also need to download a ZIM file to use with the app (see below).

Windows 10 Tablet / PC

You may be able to use the built-in App Installer. If the build is signed (builds intended for the Microsoft Store) and you have Windows 10 Fall Creators Update, then download the .appx or .appxbundle under AppPackages/KiwixWebApp_0.x.x.x_[AnyCPU]_Test/ and save it in your downloads folder, or other accessible folder. Instead of one of the packages above, you may prefer to use an .appxbundle from https://github.com/kiwix/kiwix-js-windows/releases (they are the same). Open the folder, right-click the file and select "Open". The installer should load and allow you to install the app.

If the above procedure fails, or for unsigned builds, then you will need to sideload with the PowerShell script. First turn on Developer mode: Settings / Update and security / For developers. Download the full AppPackages/KiwixWebApp_0.x.x.x[_AnyCPU]_Test/ folder that you wish to test to your PC (you can use https://minhaskamal.github.io/DownGit to do this). Open the folder in File Explorer, Right-click the Add-AppDevPackage.ps1 inside the folder and choose to run with PowerShell. You may be prompted to install the developer's certificate.

Download a ZIM archive (all platforms)

You will need a ZIM file to work with this app. For testing, it comes packaged with the Ray Charles ZIM. You can download other ZIM archives from the setup page in the app (the download completes in the browser). Place the file in an accessible location on your device, and use the Rescan Storage button in the app to display buttons that let you pick the file or the file's folder.

Alternatively, you can download files from http://wiki.kiwix.org/wiki/Content_in_all_languages on a regular PC. The single non-indexed ZIM files work best. However, if you plan to store your ZIM file on an SD card formatted as FAT32, you will only be able to use the split files (.zimaa, .zimab, etc.) in the pre-indexed archives. If your SD card is formatted as exFAT or NTFS, you can use either, but single file is easiest.