Skip to content

Releases: kiwix/kiwix-js-pwa

Supplementary installation files for Kiwix JS Electron

13 Mar 13:28
Compare
Choose a tag to compare

Kiwix JS Linux/Windows 3.1.1

13 Mar 13:31
Compare
Choose a tag to compare

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, 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).
  • For the Windows Portable builds, 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 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 swi...

WikiMed by Kiwix (Linux/Windows) 3.0.8

09 Mar 10:43
Compare
Choose a tag to compare

Portable and installable builds for Electron and UWP

WikiMed by Kiwix is an offline medical encyclopaedia with content curated by MDwiki and Wikipedia's WikiProject Medicine. Containing more than 67,000 medical and health-related articles, it makes medical knowledge available to people with limited Internet access or anyone who needs quick reference access to in-depth medical information. Other languages can be downloaded within the app.

WikiMed montage

These custom apps are packaged with the 6 Mar 2024 English-language WikiMed archive mdwiki_en_all-app_maxi_2024-03.zim. They will run on 32bit and 64bit editions of Windows or Linux (tested on Ubuntu, Debian, Fedora and OpenSUSE). The Windows builds are not compatible with Windows XP or Windows Vista. If you need an app compatible with those old platforms, get Kiwix JS Windows reader and download the latest WikiMed archive from within the app.

MS Store status: PUBLISHED
Winget status: PUBLISHED

Please choose the correct version:

Installation Instructions - Electron

  • For the Windows Web installer, simply download and launch. It will select the correct architecture automatically and install itself, together with a shortcut in yourshortcut menu. When you want to update the app, 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 Portable build, unzip the contents of the WikiMed-by-Kiwix-3.0.8-E.zip archive to any folder, or to a flash drive / thumb drive, and double click on Start WikiMed by Kiwix or Start WikiMed by Kiwix.bat, or open the kiwix-js-pwa-win32-ia32 folder and double click on WikiMed by Kiwix.exe.
  • 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 WikiMed-by-Kiwix*.AppImage and then ./WikiMed-by-Kiwix*.AppImage.
    • 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: ./WikiMed-by-Kiwix*.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-wikimed*.deb, thensudo apt install ./kiwix-js-wikimed*.deb. To run the app from the command line, rather than from its installed icon, simply type kiwix-js-wikimed 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-wikimed --no-sandbox. When you want to update, just install the new version, and it will install over the old version.
    • For OpenSUSE and Fedora, it may be easiest to extract the files from the AppImage instead of using the Deb package. The executable is kiwix-js-wikimed and on older versions of OpenSUSE you may need to add the commandline switches --use-gl=disabled --disable-gpu-compositing
  • Windows portable version: If you get a Windows Smartscreen notification on first launch, follow instructions to "Run anyway" if you trust this site. If you prefer, use the installable version WikiMed-by-Kiwix-Setup-3.0.8-E.exe which is digitally signed.

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

Release Notes

  • This app is packaged with the 6 Mar 2024 English-language WikiMed archive mdwiki_en_all-app_maxi_2024-03.zim. The packaged archive is located in the archives folder (where this is accessible). See the readme in that folder if you wish to add a different archive as the packaged ZIM;
  • You can download WikiMed in other languages from the Configuration page (see Known Issues below);
  • It supports dark mode, and opening different navigable windows by right-clicking or ctrl-clicking a link (see Configuration);
  • 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;
  • You can open a new browsable window by right-clicking, middle-clicking or ctrl-clicking 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 now support Full-Text searching;
  • 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. I/isaac.*newton for images of Isaac Newton (or in no-namespace ZIMs C/isaac.*newton.*webp).

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).
  • Please see https://github.com/kiwix/kiwix-js-pwa/issues for further known issues. If you find a new issue, please open a new issue on that page.

Instructions for sideloading (UWP)

You can sideload the app easily by typing winget install kiwix.wikimed in a Command Prompt or PowerShell terminal (Windows 10 or 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 KiwixWebAppWikiMed_3.0.8.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.

Supplementary installation files for WikiMed Electron

09 Mar 11:13
Compare
Choose a tag to compare

This contains only the supplementary installation files for the WikiMed Web-based installer. Please go to the main WikiMed release.

Wikivoyage by Kiwix (Linux/Windows) 3.0.6

24 Feb 13:47
Compare
Choose a tag to compare

Discover the world with us

Portable and installable builds for UWP and Electron

Wikiovyage by Kiwix is an offline travel guide featuring more than 32,000 destinations worldwide. It contains the English-language content, including images, of the Wikivoyage online wiki, Wikipedia's official sister site. Other languages can be downloaded within the app.

These custom apps are packaged with the 13 Feb 2024 English-language Wikivoyage archive wikivoyage_en_all_maxi_2024-02. They will run on 32bit and 64bit editions of Windows or Linux (tested on Ubuntu, Debian, Fedora and OpenSUSE). The Windows builds are not compatible with Windows XP or Windows Vista. If you need an app compatible with those old platforms, get Kiwix JS Windows reader and download the latest Wikivoyage archive from within the app.

MS Store status: PUBLISHED
Winget status: PUBLISHED

Please choose the correct version:

Wikiovyage montage trans

Installation Instructions - Electron

  • For the Windows Web installer, simply download and launch. It will select the correct architecture automatically and install itself, together with a shortcut in yourshortcut menu. When you want to update the app, 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 Portable build, unzip the contents of the Wikivoyage-by-Kiwix-3.0.6-E.zip archive to any folder, or to a flash drive / thumb drive, and double click on Start Wikivoyage by Kiwix or Start Wikivoyage by Kiwix.bat, or open the kiwix-js-pwa-win32-ia32 folder and double click on Wikivoyage by Kiwix.exe.
  • 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 Wikivoyage-by-Kiwix*.AppImage and then ./Wikivoyage-by-Kiwix*.AppImage.
    • 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: ./Wikivoyage-by-Kiwix*.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-wikivoyage*.deb, then sudo apt install ./kiwix-js-wikivoyage*.deb. To run the app from the command line, rather than from its installed icon, simply type kiwix-js-wikivoyage 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-wikivoyage --no-sandbox. When you want to update, just install the new version, and it will install over the old version.
    • For OpenSUSE and Fedora, it may be easiest to extract the files from the AppImage instead of using the Deb package. The executable is kiwix-js-wikivoyage and on older versions of OpenSUSE you may need to add the commandline switches --use-gl=disabled --disable-gpu-compositing
  • Windows portable version: If you get a Windows Smartscreen notification on first launch, follow instructions to "Run anyway" if you trust this site. If you prefer, use the installable version Wikivoyage-by-Kiwix-Setup-3.0.6-E.exe which is digitally signed.

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

Release Notes

  • This app is packaged with the 13 Feb 2024 English-language Wikivoyage archive wikivoyage_en_all_maxi_2024-02. The packaged archive is located in the archives folder (where this is accessible). See the readme in that folder if you wish to add a different archive as the packaged ZIM;
  • You can download Wikivoyage in other languages from the Configuration page (see Known Issues below);
  • It supports dark mode, and opening different navigable windows by right-clicking or ctrl-clicking a link (see Configuration);
  • 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;
  • You can open a new browsable window by right-clicking, middle-clicking or ctrl-clicking 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 now support Full-Text searching;
  • 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. I/isaac.*newton for images of Isaac Newton (or in no-namespace ZIMs C/isaac.*newton.*webp).

Known Issues

  • 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).
  • Please see https://github.com/kiwix/kiwix-js-pwa/issues for further known issues. If you find a new issue, please open a new issue on that page.

Instructions for sideloading (UWP)

You can sideload the app easily by typing winget install kiwix.wikivoyage in a Command Prompt or PowerShell terminal (Windows 10 or 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 KiwixWebAppWikivoyage_3.0.6.0_AnyCPU.appxbundle and (for desktop systems) the zipped PowerShell script from Assets below. Then follow the detailed instructions at https://github.com/kiwix/kiwix-js-pwa/tree/main/AppPackages#readme.

Supplementary installation files for Wikivoyage Electron

24 Feb 14:24
Compare
Choose a tag to compare

This contains only the supplementary installation files for the Wikivoyage Web-based installer. Please go to the main Wikivoyage release.

WikiMed by Kiwix (Linux/Windows) 3.0.4

08 Feb 18:36
Compare
Choose a tag to compare

This build is out of date!

Please go to https://kiwix.github.io/kiwix-js-pwa/wikimed/ for the latest release.

Introducing WikiMed by Kiwix 3 0 4

Kiwix JS Linux/Windows 3.0.1

01 Feb 22:54
Compare
Choose a tag to compare

This build is out of date!

Please go to https://kiwix.github.io/kiwix-js-pwa/app for the latest release.

We are proud to announce Kiwix JS PWA version 3!

Version 3 is a big milestone for the PWA and Electron apps. Highlights of this release include:

  • Preliminary support for Zimit v2.0 archive types
  • Provision of new packages for Windows on ARM64 and Linux on ARM64
  • Ability to use built-in DarkReader with all Zimit-style ZIMs
  • Fallback support for reading static content in any archive type (using jQuery mode)

For the full list of new and update features in v3, please see #556.

KiwixLogoVerticalHero_v3

Wikivoyage by Kiwix (Linux/Windows) 2.9.6

16 Jan 11:39
Compare
Choose a tag to compare

This build is out of date!

Please go to https://kiwix.github.io/kiwix-js-pwa/wikivoyage for the latest release.

WikiMed by Kiwix (Linux/Windows) 2.9.4

07 Jan 20:43
Compare
Choose a tag to compare

This build is out of date!

Please go to https://kiwix.github.io/kiwix-js-pwa/wikimed/ for the latest release.