Skip to content

Kiwix JS Linux/Windows 3.4.1
Compare
Choose a tag to compare
@Jaifroid Jaifroid released this 14 Aug 13:50
· 43 commits to main since this release
v3.4.1
51455bd

Portable and installable builds for UWP, PWA, Electron and NWJS

Kiwix is an offline browser of archival content from Wikipedia, Project Gutenberg, TED Talks, Wikivoyage, Stackexchange, and many other sources. It makes knowledge available to people with limited or no Internet access. The software as well as the content is free for anyone to use. It requires at least one offline ZIM archive (which can be downloaded in the app).

Kiwix JS Seven Wonders Montage trans

To use this app, download your choice of free content in-app from the Download Library on the Configuration page. For what's new, see the changes listed in the CHANGELOG. Builds are provided for 32bit and 64bit editions of Windows and Linux (tested on Ubuntu, Debian, Fedora and OpenSUSE).

MS Store status: PUBLISHED
Winget status: PUBLISHED

Please choose the correct version (those marked [AUTO] will self-update automatically when there is a new version):

Kiwix-Zimit-montage

Installation Instructions - Electron/NWJS

  • For the Windows Web installer for Windows 10/11, simply download and launch. It will select the correct architecture automatically and install itself, together with a shortcut in your shortcut menu. It auto-updates, but if you want to update it manually, then just install a new version over it (it will uninstall the old one for you). Please note that the Web installer needs Web access during the installation. If this is a problem, then use the standalone installer.
  • For the Windows 10/11 Portable builds (64bit only), the executable version (ending .exe) can just be run, but it may be a bit slow to start up. For a faster experience, use one of the zipped versions: unzip the contents of the package to any folder, or to a thumb drive, and double click on Start Kiwix JS [Electron/Windows] or Start Kiwix JS [Electron/Windows].bat.
  • For Windows 7/8/8.1, due to the deprecation of Chromium on these platforms, we now only provide one option: a standalone installer built with the last version of Electron that supported Chrome on Windows 7+. This is also a 32bit package (but will run on 64bit).
  • For the Linux portable builds, download and save the correct AppImage file anywhere (e.g. your Desktop), and double-click it. If it doesn’t work, open a terminal and run chmod a+x Kiwix-JS-Electron*.AppImage and then ./Kiwix-JS-Electron*.AppImage. This version will auto-update.
    • On Debian, if you have issues running the AppImage on older versions of the OS, you can try adding the --no-sandbox switch to the command (see electron/electron#17972 (comment)). This is not necessary on recent versions.
    • On OpenSUSE, you may need to install Chrome in order to get the dependencies necessary to run the AppImage (because Electron apps run Chrome internally). With older versions of OpenSUSE, you may additionally need to use these commandline switches: ./Kiwix-JS-Electron*.AppImage --use-gl=disabled --disable-gpu-compositing,¹ but this is no longer necessary in recent versions.
  • For the Linux installable builds:
    • Debian/Ubuntu: download the correct .deb package. Open a terminal, cd to the directory containing the package, and type sudo apt-get update followed by chmod a+x ./kiwix-js-electron*.deb, then sudo apt install ./kiwix-js-electron*.deb. To run the app from the command line, rather than from its installed icon, simply type kiwix-js-electron in terminal. On Debian, if you receive the error libgbm.so.1: cannot open shared object file, please run sudo apt install libgbm-dev. On older versions of Debian, you may have to add --no-sandbox to the command line when running the app, i.e. kiwix-js-electron --no-sandbox. When you want to update, just install the new version, and it will install over the old version.
    • Fedora: download the correct .rpm package. You should be able to install it by opening the File manager, locating the package, and double-clicking it. Alternatively, open a terminal and cd to the directory with the package, and then type sudo rpm --install ./kiwix-js-electron-*.rpm (you may need to do chmod a+x kiwix-js-electron-*.rpm first). After install, you should find Kiwix JS Electron in your app list, and you can launch it from there. To upgrade, locate the newly downloaded package in terminal and type sudo rpm --upgrade ./kiwix.js.electron-*.rpm (ensure you specify the correct package number in place of * if you have more than one). If you find the app is stuck looking for an old sample package after upgrade, please just press the Reset button next to the version number at the top of Configuration.
    • OpenSUSE: download the correct .rpm package. You may get a better installation experience if you first install Chrome or another Chromium browser, as the Electron app has the same dependencies as Chrome. Then open a Terminal with superuser privileges, navigate to the directory containing the .rpm package, and type zypper install kiwix-js-electron-*.rpm (you may need to do chmod a+x kiwix-js-electron-*.rpm first). If you are informed about missing dependencies, try "Solution 2: break kiwix-js-electron... by ignoring some of its dependencies'. You will also be warned that the app is not signed. You can ignore this, if you trust this repository. See above for commandline switches in older versions of OpenSUSE.
  • Windows (zipped apps): If you get a Windows Smartscreen notification on first launch of the zipped portable apps, follow instructions to "Run anyway" if you trust this site. If you prefer, use one of the executable versions (ending .exe) which are digitally signed.

¹ With many thanks to Jay Midura for documenting the switches needed for OpenSUSE.

Release Notes

  • You can download many different archives in multiple languages from the Configuration page.
  • For a seamless experience in the PWA, try out the Origin Private File System: you won't have to answer permission prompts. On Android, this is also much, much faster. There is no advantage to using the OPFS in the Electron app, however.
  • There is full support for reading Zimit classic (and preliminary support for Zimit 2) archives in the PWA and Electron apps (also modern NWJS app, but see Known Issues below), and legacy support in the older UWP app. If your browser cannot use the full support, it will fall back to legacy support and/or very limited support in Restricted mode.
  • The app natively supports dark mode for Wikimedia, Gutenberg and Stack Exchange ZIMs (see Configuration). For Zimit archives in particular, we recommend you try the new DarkReader plugin (you can enable this from Configuration in ServiceWorker mode only).
  • You can print by pressing Ctrl-P or using the print icon. If local printers are not available (after clicking on More options...) then print to PDF and use another app to print. Printing works best with Wikimedia ZIMs.
  • You can open a new browsable window by middle-clicking, ctrl-clicking or long-pressing an article link (not available in every mode, see option in Configuration).
  • There is support for Full-Screen mode in most browsers and frameworks, and orientation locking in some mobile browsers (e.g. Android).
  • Electron versions of the app (and the PWA) now support Full-Text searching.
  • You can open the ZIM's article index by typing a space in the search box. Sometimes you may need to search the URL index instead: to open this, type space / (a space followed by a forward slash) in the search box. In older ZIMs, you will find articles under the A/ namespace and images under the I/ namespace, but in newer ZIMs almost all content is under the C/ namesapce.
  • In title search, you can use wildcards .* or .+ (this works best if you start the search with a normal alphanumeric string). You can include a more complex regular expression by enclosing it within (?:my_regular_expression). See Configuration -> About for more details and limitations.
  • You can search for any file in a ZIM by prefixing the namespace, e.g. C/isaac.*newton.*webp in recent ZIMs where all content is in the C namespace, or I/isaac.*newton in older ZIMs where images are in the I namespace and articles in the A namespace.

Known Issues

  • The Electron app may need to be restarted TWICE to update fully to the latest code.
  • Printing: In Electron apps, no preview is available prior to printing: we recommend you print to PDF first and then print the PDF, or use the PWA instead for printing (which has print preview). Before printing, ensure all sections you want to print are open (if you closed them). It is not possible to print Zimit-based articles in Firefox.
  • There are various issues with the NWJS app - we recommend you use the Electron app instead (except on Windowx XP):
    • PDFs in Zimit-based archives are blocked from viewing in the NWJS app.
    • If you download an archive from within the NWJS app (from Configuration), you will be able to pick a download directory, and the download will start, but then there will be no further indication that a download is in progress. You will need to check the chosen download directory to see if the download has completed.
    • The NWJS app for Windows 7/8/10/11 will occasionally crash and exit when running in ServiceWorker mode. For now, it is recommended to use this app only in Restricted mode until this issue is resolved.
    • In the NWJS app only, YouTube-based videos in Zimit archives do not play with sound (this does not affect other archives such as TED Talks or Khan Academy).
    • Image manipulation (e.g. saving image to disk) does not currently work with the NWJS app.
  • On the XP build with some recent ZIMs there is a CSS error in rendering image-heavy landing pages, due to the age of the Chromium build included in the runtime package. However, you can access all articles by pressing a space in the search box.
  • Please see https://github.com/kiwix/kiwix-js-pwa/issues for further known issues. If you find a problem not reported there, please open a new issue on that page.

Instructions for sideloading (UWP)

You can sideload the UWP app easily by typing winget install kiwix.kiwixjs in a Command Prompt or PowerShell terminal (Windows 10/11). This will download and install the Electron-based appx. If you want to install the legacy UWP appxbundle based on EdgeHTML, then simply download the appxbundle (see below) and double click it. The app installer should launch and will let you install it.

For Windows Mobile or for sideloading manually, please download KiwixWebApp_3.4.1.0_AnyCPU.appxbundle and the zipped PowerShell script from Assets below. Then follow the detailed instructions at https://github.com/kiwix/kiwix-js-pwa/tree/main/AppPackages#readme.

Assets 23
Loading