Comicviewer/README.md

1.3 KiB

Comicviewer

Comicviewer is a GTK4 desktop application for browsing and reading comic image archives stored locally or on SMB, FTP, and SFTP servers.

The project is currently in early development. It supports saved local, SMB, FTP, and SFTP locations, complete remote ZIP downloads with an LRU cache, natural sorting, safe on-demand image decoding and prefetching, single-page and two-page viewing, continuous vertical scrolling, reading progress, and XDG-compliant configuration.

Development dependencies

On CachyOS or Arch Linux:

sudo pacman -S rust gtk4 sqlite gvfs gvfs-smb

Run the application with:

cargo run

GVfs provides the FTP and SFTP backends. gvfs-smb adds SMB support. These services must be installed on the host even when Comicviewer is distributed as an AppImage.

Application files are stored below the standard XDG configuration, data, and cache directories. No runtime state is written into the source tree.

AppImage

The AppImage build uses linuxdeploy and linuxdeploy-plugin-gtk:

PATH="/path/to/appimage-tools:$PATH" \
LINUXDEPLOY="/path/to/linuxdeploy-x86_64.AppImage" \
./packaging/build-appimage.sh

The resulting file is written to dist/. Remote locations still require the host system's GVfs services and protocol backends, including gvfs-smb for SMB.