YACReader · luisangelsm · Aug 8, 2026 · Jul 10, 2026 · Jul 10, 2026 · Jul 12, 2026
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
@@ -75,7 +75,7 @@ jobs:
 
   # Linux Qt6 build
   linux-qt6:
-    name: Linux (Qt6)
+    name: Linux (Qt6 + libarchive)
     runs-on: ubuntu-24.04
     needs: [initialization, code-format-validation]
     steps:
@@ -84,7 +84,7 @@ jobs:
       - name: Install dependencies
         run: |
           sudo apt-get update
-          sudo apt-get install -y libunarr-dev libgl-dev libgles2-mesa-dev \
+          sudo apt-get install -y libarchive-dev libgl-dev libgles2-mesa-dev \
             libfontconfig1-dev libfreetype-dev libxkbcommon-dev libpoppler-qt6-dev \
             libspeechd-dev
 
@@ -98,7 +98,6 @@ jobs:
       - name: Build
         run: |
           cmake -B build \
-            -DDECOMPRESSION_BACKEND=unarr \
             -DPDF_BACKEND=poppler \
             -DBUILD_NUMBER="${{ needs.initialization.outputs.build_number }}" \
             -DCMAKE_BUILD_TYPE=Release
@@ -212,7 +211,7 @@ jobs:
           pip install -U pip
           pip install aqtinstall
           mkdir C:\Qt
-          python -m aqt install-qt windows desktop 6.9.3 win64_msvc2022_64 -O c:\Qt -m qt5compat qtmultimedia qtimageformats qtshadertools qtspeech
+          python -m aqt install-qt windows desktop 6.9.3 win64_msvc2022_64 -O c:\Qt -m qt5compat qtmultimedia qtimageformats qtshadertools qtspeech || exit /b 1
           dir C:\Qt\6.9.3\msvc2022_64\bin
           curl.exe -L --retry 5 --retry-delay 5 --retry-all-errors "https://aka.ms/vs/17/release/vc_redist.x64.exe" -o "%GITHUB_WORKSPACE%\vc_redist.x64.exe"
           where iscc
@@ -356,8 +355,8 @@ jobs:
         run: |
           pip install aqtinstall
           mkdir C:\Qt
-          python -m aqt install-qt windows desktop 6.9.3 win64_msvc2022_64 -O c:\Qt -m qt5compat qtmultimedia qtimageformats qtshadertools qtspeech
-          python -m aqt install-qt windows desktop 6.9.3 win64_msvc2022_arm64_cross_compiled -O c:\Qt -m qt5compat qtmultimedia qtimageformats qtshadertools qtspeech
+          python -m aqt install-qt windows desktop 6.9.3 win64_msvc2022_64 -O c:\Qt -m qt5compat qtmultimedia qtimageformats qtshadertools qtspeech || exit /b 1
+          python -m aqt install-qt windows desktop 6.9.3 win64_msvc2022_arm64_cross_compiled -O c:\Qt -m qt5compat qtmultimedia qtimageformats qtshadertools qtspeech || exit /b 1
           dir C:\Qt\6.9.3\msvc2022_arm64\bin
           curl.exe -L --retry 5 --retry-delay 5 --retry-all-errors "https://aka.ms/vs/17/release/vc_redist.arm64.exe" -o "%GITHUB_WORKSPACE%\vc_redist.arm64.exe"
           where iscc

diff --git a/AGENTS.md b/AGENTS.md
@@ -12,7 +12,7 @@ cmake --build build --parallel
 ```
 
 Build options:
-- `DECOMPRESSION_BACKEND`: `unarr` | `7zip` | `libarchive` (default: 7zip on Windows/macOS/Linux)
+- `DECOMPRESSION_BACKEND`: `unarr` | `7zip` | `libarchive` (default: 7zip on Windows/macOS, libarchive on Linux)
 - `PDF_BACKEND`: `pdfium` | `poppler` | `pdfkit` | `no_pdf` (default: pdfium on Windows, pdfkit on macOS, poppler on Linux)
 - `BUILD_SERVER_STANDALONE=ON`: builds only `YACReaderLibraryServer` (headless), requires only Qt 6.4+
 - `BUILD_TESTS=ON` (default): enables the test suite

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,49 @@
 
 Version counting is based on semantic versioning (Major.Feature.Patch)
 
+## 10.2.0
+
+### YACReader
+* Change default shortcuts for modifying the magnifying glass size to avoid conflicts with the page zoom shortcuts, `[`, `]`.
+* Add an optional circular magnifying glass, with an optional ring drawn around it. The configured size is kept as a rectangle, so switching back and forth doesn't lose it.
+* Add optional edge easing for the magnifying glass. The magnified region is pushed toward the edges of the view, so content near the border can be inspected without pushing the cursor all the way into the corner.
+* Require a full wheel notch before the magnifying glass changes size or zoom, so a light trackpad gesture no longer resizes it.
+* Fix showing the go to flow bar asking for permission to control the computer on macOS. Moving the cursor into the bar now works without granting any accessibility permission, where before it was silently doing nothing.
+* Add a setting to control what the Escape key does. It can keep quitting the reader, as before, or instead cancel the topmost active mode: magnifying glass, dictionary, go to flow and then fullscreen.
+* Fix crash caused by changing reading direction while quickly turning pages.
+* Use pinch and ctrl+wheel mouse to change the zoom level.
+
+### YACReaderLibrary
+* Add a library repair function to restore missing covers and rescan files that previously failed to be added.
+* Add actions to create and restore library database backups.
+* Automatically create and retain database backups in `.yacreaderlibrary/backups`.
+* When database corruption is detected, offer to attempt a repair or restore a backup. Damaged originals are preserved in `.yacreaderlibrary/recovery`.
+* Fix comics info export/import and covers package import/export error handling.
+* Fix grid comic cells info height so the title doesn't overlap the other fields.
+* Add a function to open the library root location.
+* Add a help dialog for the search engine. Use the drop down menu in the search field.
+* Add quick search presets. Use the drop down menu in the search field.
+* Fix `open containing folder` asking for permission to control Finder on macOS.
+* Improve the server dialog UI a bit and add the option to open the Web UI from it.
+
+### YACReaderLibraryServer
+* Add the `repair-library` command to restore missing covers and rescan files that previously failed to be added.
+* Add the `backup-library`, `list-backups`, and `restore-library` commands.
+* Automatically create and retain database backups in `.yacreaderlibrary/backups`.
+* Add the `repair-library-db` command to attempt to repair a damaged database. Damaged originals are preserved in `.yacreaderlibrary/recovery`.
+
+### WebUI
+* Add a very basic web reader.
+* Add rescan xml functionality to the webui.
+* Add more metadata fields to the detail view.
+
+### All GUI apps
+* New settings dialogs.
+
+### All apps
+* Unify comics sorting to use the string based universal number everywhere.
+* Experimental support for image based comics in epub format.
+
 ## 10.1.0
 
 ### YACReader

diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -55,7 +55,7 @@ set(YACREADER_PDF_BACKENDS pdfium poppler pdfkit no_pdf)
 
 # --- Platform defaults ---
 if(UNIX AND NOT APPLE)
-    set(_default_decompression_backend "7zip")
+    set(_default_decompression_backend "libarchive")
     set(_default_pdf_backend "poppler")
 elseif(APPLE)
     set(_default_decompression_backend "7zip")

diff --git a/INSTALL.md b/INSTALL.md
@@ -41,7 +41,7 @@ required qml modules (Quick, QuickControls2) are missing.
 ### Decompression
 
 YACReader currently supports three decompression backends: 7zip, (lib)unarr, and libarchive. YACReader
-defaults to 7zip for Windows, macOS, Linux, and other OSes, but you can
+defaults to 7zip for Windows and macOS, and libarchive for Linux and other OSes, but you can
 override this using the `DECOMPRESSION_BACKEND` option:
 
 ```
@@ -52,7 +52,7 @@ cmake -B build -DDECOMPRESSION_BACKEND=libarchive
 
 #### 7zip
 
-[7zip](https://www.7-zip.org/) is the default decompression backend.
+[7zip](https://www.7-zip.org/) is the default decompression backend for Windows and macOS.
 
 It is recommended for most builds, as it currently has better support for 7z
 files and supports the RAR5 format.
@@ -63,16 +63,20 @@ FetchContent. No manual setup is needed.
 As this backend is not 100% GPL compatible (unrar license restriction), it is not
 recommended for installations where the license is an issue.
 
+#### libarchive
+
+[libarchive](https://github.com/libarchive/libarchive) is a portable, efficient decompression backend, and the default decompression backend for Linux.
+
+libarchive supports a wide variety of archive formats, and supports the RAR5 format (with some limitations) without using non-free software.
+
+The libarchive backend is recommended for packaging, and installations where GPL compatibility is required.
+
 #### unarr
 
 [(lib)unarr](https://github.com/selmf/unarr) is a lightweight decompression backend.
 
 As of version 1.0.1, it supports less formats than 7zip, notably missing RAR5 support and only having
-limited support for 7z on git versions. However, this is rarely an issue in practice as the vast majority
-of comic books use either zip or RAR4 compression, which is handled nicely by this backend.
-
-The unarr backend is recommended for packaging, lightweight installations and generally for all users requiring
-more stability than the 7zip backend can offer.
+limited support for 7z on git versions. It is recommended that packagers switch to the libarchive backend.
 
 The recommended way to use this on Linux or other *NIX is to install it as a package, but you can also do an embedded build.
 For more information, please consult the [README](compressed_archive/unarr/README.txt)

diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-10.1.0
+10.2.0