Skip to content

Latest commit

 

History

History
182 lines (143 loc) · 5.72 KB

README.md

File metadata and controls

182 lines (143 loc) · 5.72 KB

Web archives

A web archives reader offering the ability to browse offline millions of articles from large community projects such as Wikipedia or Wikisource.

Goals / Reasons

  • Availability : offline, anytime, anywhere
  • Confidentiality : no need to trust network's protocols or server's policy
  • Shareability : disseminate knowledge

Disclaimer

This software, despite its defects, bugs and instability, can be useful for anyone who needs to browse important websites such as Wikipedia or Wikisource without any Internet connection.

No guarantee regarding the update of internal databases until the release of a stable version.

As long as it has not been improved, it is recommended to use it wisely. Also, it only allows reading ZIM files for the moment.

Screenshot

Application home page

Features

  • List recently opened web archives
  • List available local web archives
  • List of web archives available to download
  • Print a page
  • Night mode (Darkreader)
  • Zoom controls
  • Search in page
  • History
  • Bookmarks
  • Search a page
  • Keyboard shortcuts
  • Multi-windows
  • Multi-tabs
  • Random page
  • Sandboxed pages (Pages are isolated from the web)
  • Ask for confirmation when opening an external link
  • Handle the opening of zim files from external applications (Nautilus...)
  • Fullscreen mode
  • Table of contents
  • Responsive (Mobile ready)
  • Global search (Search through all archives available on device)
  • Search provider (Depends on previous feature)
  • Inter web archives linking (Links from A pointing to B, can be directly opened in the corresponding archive)

Enhancements (Unconfirmed)

  • Immersive mode (See what is done on Android)
  • External links handling (Open Wikipedia link from GNOME Maps for example)
  • Hint mode (Open links quickly using keyboard)
  • Nearby pages (Pages referencing nearby points of interest)
  • Link preview popup (Preview the targeted page on mouseover or tap)
  • Speech synthesis
  • Stream a local archive to nearby app instances (Useful in a classroom)
  • Show a list of archives where the subject of the page can also be found
  • Option to block javascript
  • Options to control save strategy for items such as searches or history
  • Save images, video, audio on right click
  • Gallery of the media present on a page (Useful to browse images)

Installation

WebArchives was developed and tested under GNU/Linux, with GNOME in sight. However, it can be used under other desktop environments.

No method is provided to install this application on other platforms, such as Windows or macOS. This is a desktop application so it's not compatible with mobile platforms such as Android or iOS.

From Flathub

$ flatpak install com.github.birros.WebArchives

From sources

$ flatpak install -y \
    org.gnome.Platform//45 \
    org.gnome.Sdk//45 \
    org.flatpak.Builder
$ flatpak run --command=flatpak-builder-lint org.flatpak.Builder \
    --exceptions \
    manifest build-aux/flatpak/com.github.birros.WebArchives.yml
$ flatpak-builder \
    --ccache \
    --force-clean \
    --repo=.flatpak-repo \
    .flatpak-builddir build-aux/flatpak/com.github.birros.WebArchives.yml
$ flatpak remote-add --no-gpg-verify webarchives-repo .flatpak-repo
$ flatpak install -y webarchives-repo com.github.birros.WebArchives

Dev

$ flatpak-builder \
    --ccache \
    --force-clean \
    --stop-at=web-archives \
    .flatpak-builddir build-aux/flatpak/com.github.birros.WebArchives.yml
$ flatpak-builder \
    --run \
    .flatpak-builddir \
    build-aux/flatpak/com.github.birros.WebArchives.yml \
    bash

$ meson setup --libdir=lib --prefix=$(pwd)/app build
$ meson compile -C build
$ meson install -C build

$ export LC_ALL=fr_FR.UTF-8
$ export GSETTINGS_SCHEMA_DIR=$(pwd)/app/share/glib-2.0/schemas
$ ./app/bin/web-archives

Tracker

Some problems may occur when running the application, especially if your desktop environment does not use GTK+, such as Kde.

The installation of tracker service is then required on the system side to solve these problems, requiring the execution of one of these commands depending on your distribution :

Debian & Ubuntu:

$ apt install tracker

Fedora:

$ dnf install tracker

Other installation methods

The implementation of a common installation method for existing distributions is in preparation, with Debian and Ubuntu as priorities.

Alternatives

This application is directly inspired by the Kiwix application. In this way WebArchives as well as Kiwix can read the Web archives in ZIM format. Kiwix is available for Windows, GNU/Linux, iOS and Android.

Useful links