45 lines
1.3 KiB
Markdown
45 lines
1.3 KiB
Markdown
# 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:
|
|
|
|
```sh
|
|
sudo pacman -S rust gtk4 sqlite gvfs gvfs-smb
|
|
```
|
|
|
|
Run the application with:
|
|
|
|
```sh
|
|
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`:
|
|
|
|
```sh
|
|
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.
|