Skip to content

Commit

Permalink
Add info about installing on Chrome OS
Browse files Browse the repository at this point in the history
  • Loading branch information
Jaifroid committed Oct 27, 2024
1 parent 2354c2e commit 9de6212
Showing 1 changed file with 1 addition and 0 deletions.
1 change: 1 addition & 0 deletions scripts/Kiwix_JS_Windows_Release_Body.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,7 @@ Please choose the correct version (those marked [**AUTO**] will self-update auto
* **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 https://github.com/electron/electron/issues/17972#issuecomment-516957971). 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.
+ On **_ChromeOS_**, you need to run the AppImage in the Debian-based VM (Crostini). Download the appropriate AppImage for your Chromebook (the standard AppImage if it uses an Intel Celeron, or the ARM64 version if it has an ARM chip). Move this file to you Linux Files. Do `chmod +x` on the file. Then run with `./Kiwix-JS-Electron-x.x.x-E.AppImage`. If you get errors about missing fuse and libnss3, simply install these manually: `sudo apt-get install fuse` and `sudo apt-get install libnss3`.
* **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.
Expand Down

0 comments on commit 9de6212

Please sign in to comment.