As comics are called strips in Dutch, and follow a flow, Wolf is the reverse of flow.

A cross-platform comic book reader built with Avalonia UI that supports offline reading and Komga integration.

Features

• Local Comic Reading: Read CBZ, CBR, CB7, CBT, PDF, and EPUB files stored on your device
• PDF Support: Import PDF files - they are automatically converted to CBZ format for optimal viewing
• EPUB Support: On supported platforms you can import EPUB files either by converting them to CBZ on import or by converting pages on demand while you read
• Extended Format Support: Read CB7 (7-Zip) and CBT (TAR) archives natively, while solid RAR archives are automatically converted to CBZ for reliable reading
• ComicInfo.xml Support: Automatically extracts and displays metadata from ComicInfo.xml files embedded in comic archives
• Komga Integration: Connect to your Komga server to browse and download comics
• Welcome Experience: First-run guided tour that introduces library, Komga, activity, and settings capabilities
• Multiple Reading Modes:
  • Normal: Standard full-page reading
  • Zoomed: Split view with page overview and magnified area
  • Guided: Automatic panel detection for scene-by-scene navigation (available on limited platforms and still in development)
• Handedness Options: Choose between left-handed and right-handed layouts for Zoomed and Guided modes
• Offline Reading: Download comics from Komga for offline access
• Reading Progress: Automatically tracks your reading progress
• Cross-Platform: Works on Windows, Linux, macOS, and Android
• Semantic Versioning: Powered by GitVersion for clear version tracking

Support

If you like the project, you can support me:

• Ko-fi: Support on Ko-fi
• PayPal: Donate with PayPal

Supported Formats

Format	Extension	Support
CBZ (ZIP)	.cbz	✅ Native
CBR (RAR)	.cbr	✅ Native (converted if solid)
CB7 (7-Zip)	.cb7	✅ Native
CBT (TAR)	.cbt	✅ Native
PDF	.pdf	✅ Converted to CBZ
EPUB	.epub	✅ Supported on android (convert on import or convert while reading)

Supported Image Formats

Comics can contain images in the following formats:

• JPEG (.jpg, .jpeg)
• PNG (.png)
• GIF (.gif)
• WebP (.webp)
• BMP (.bmp)
• TIFF (.tiff, .tif)
• AVIF (.avif)

Supported Platforms

• Windows
• Android (APK)
• Linux (still needs testing)
• macOS (still needs testing)

Installation

Android APK

Download the latest APK from the Releases page:

1. Download StripWolf-Android.apk from the latest release
2. On your Android device, enable "Install from unknown sources" in Settings > Security
3. Open the downloaded APK file and follow the installation prompts
4. The app is now ready to use

Note: If you are trying to build the APK yourself or run from Visual Studio, the app is signed with a development key for sideloading. This will conflict with the packages build officially, and you will lose your local comics and information.

Windows

Download StripWolf-Windows-x64-Setup.exe from the Releases page and run it. It installs StripWolf for your user (no administrator rights needed) and registers it for comic books (CBZ, CBR, CB7, CBT), so they open with a double-click. For PDF files StripWolf is added to "Open with". If Windows asks which app to use, or another app is already the default, pick StripWolf in Settings > Apps > Default apps > StripWolf.

There is also a portable StripWolf-Windows-x64.zip, extract it to your preferred location. The portable version doesn't register any file types.

Linux

Download the StripWolf-Linux-x64.tar.gz from the Releases page:

mkdir -p ~/StripWolf
tar -xzvf StripWolf-Linux-x64.tar.gz -C ~/StripWolf
~/StripWolf/install.sh

install.sh adds StripWolf to the application menu and makes it the default application for comic books, so they open with a double-click (PDF files can be opened with "Open With"). Run it again after moving the folder, install.sh --uninstall removes the registration.

macOS

Brew:

• brew tap dapplo/tap
• brew install --cask stripwolf

Manuall installation:

Download the appropriate archive from the Releases page:

• Intel Macs: StripWolf-macOS-x64.tar.gz
• Apple Silicon (M1/M2/M3): StripWolf-macOS-arm64.tar.gz

Extract the archive:

tar -xzvf StripWolf-macOS-*.tar.gz -C ~/Applications

StripWolf registers itself for comic books (CBZ, CBR, CB7, CBT) when macOS sees the app, they open with a double-click. For PDF files it is available in "Open With".

Gatekeeper Notice: Because the application is ad-hoc signed, macOS will block it on first run with a security warning. To easily bypass this:

• Using Finder: Right-click (or Control-click) StripWolf.app in your ~/Applications folder, select Open, and then click Open in the dialog. You only need to do this once; macOS will approve the app and all its nested library files.
• Using Terminal: Alternatively, clear the download quarantine flag recursively on the extracted bundle:

  xattr -d com.apple.quarantine ~/Applications/StripWolf.app

Requirements

• .NET 10.0 SDK

Building

Desktop (Windows/Linux/macOS)

cd src/StripWolf
dotnet build StripWolf.Desktop/StripWolf.Desktop.csproj -c Release

Android APK

cd src/StripWolf
dotnet build StripWolf.Android/StripWolf.Android.csproj -c Release

Project Structure

src/StripWolf/
├── StripWolf/               # Core library (shared code)
│   ├── Data/             # Database service for local storage
│   ├── Models/           # Data models (Comic, KomgaServer, etc.)
│   │   └── Komga/        # Komga API models
│   ├── Services/         # Business logic services
│   │   ├── ComicReaderService.cs       # CBZ/CBR reading
│   │   ├── PdfToCbzConverterService.cs # PDF to CBZ conversion
│   │   ├── KomgaApiService.cs          # Komga API client
│   │   └── LibraryService.cs           # Library management
│   ├── ViewModels/       # MVVM view models
│   └── Views/            # Avalonia XAML views
├── StripWolf.Desktop/       # Desktop launcher (Windows/Linux/macOS)
└── StripWolf.Android/       # Android launcher

Komga API

This app connects to Komga, a media server for comics/mangas/BDs. Configure your server URL and credentials in the Settings page to:

• Browse libraries and series
• Download books for offline reading
• Sync reading progress

Technology Stack

• .NET: Current version 10
• UI Framework: Avalonia UI 12.x (cross-platform)
• MVVM: CommunityToolkit.Mvvm
• Storage: SQLite via sqlite-net-pcl
• CB(R/T/Z/7) Support: SharpCompress
• PDF Support: PDFiumCore for PDF rendering, SixLabors.ImageSharp for image processing
• EPUB support: VerseOne.EPub rendered in a WebView, currently only working on Windows (but not the package one) and Android
• Development is supported by AI, using Gemini and Copilot.

License

GPLv3, see LICENSE file for details.