Comicviewer 설치 및 실행 안내

Comicviewer는 CachyOS와 Arch Linux에서 사용할 수 있는 만화 ZIP 뷰어입니다. 로컬 파일뿐 아니라 SMB, FTP, SFTP 서버의 폴더와 ZIP 파일도 열 수 있습니다.

1. 필수 패키지

통합 번들의 설치 스크립트가 다음 필수 패키지 중 누락된 항목을 자동으로 설치합니다. 설치 과정에서 sudo 암호와 pacman 확인을 요청할 수 있습니다.

sudo pacman -S fuse2 gtk4 dav1d gvfs gvfs-smb

fuse2: AppImage 마운트 및 실행
gtk4, dav1d: 화면 표시와 이미지 디코딩
gvfs: FTP와 SFTP 접근
gvfs-smb: SMB 공유 접근

2. 권장 방법: 통합 번들로 설치 또는 업데이트

Release 페이지에서 다음 두 파일을 같은 폴더에 다운로드합니다.

Comicviewer-0.1.4-x86_64.tar.gz
Comicviewer-0.1.4-x86_64.tar.gz.sha256

체크섬을 확인하고 압축을 푼 뒤 설치 스크립트를 실행합니다.

sha256sum -c Comicviewer-0.1.4-x86_64.tar.gz.sha256
tar -xzf Comicviewer-0.1.4-x86_64.tar.gz
cd Comicviewer-0.1.4-x86_64
./install-or-update.sh

스크립트는 AppImage 체크섬을 검증하고 다음 작업을 수행합니다.

AppImage를 ~/.local/opt/comicviewer/Comicviewer.AppImage에 설치
~/.local/bin/comicviewer 실행 링크 생성
애플리케이션 메뉴용 데스크톱 파일과 아이콘 설치
기존 버전이 있으면 검증된 새 AppImage로 원자적으로 교체

이후 재배포된 새 번들을 다운로드해 같은 명령을 실행하면 업데이트됩니다. 사용자 설정, 읽기 기록, 원격 ZIP 캐시는 그대로 유지됩니다.

제거하려면 압축을 푼 번들 폴더에서 다음을 실행합니다.

./install-or-update.sh --uninstall

이 명령은 프로그램과 함께 저장한 위치 및 인증정보, 읽기 기록, 원격 ZIP 캐시를 모두 삭제합니다. 삭제한 데이터는 복구할 수 없으므로 필요한 설정은 제거 전에 별도로 백업합니다.

3. AppImage만 다운로드하는 방법

Release 페이지에서 다음 두 파일을 같은 폴더에 다운로드합니다.

Comicviewer-0.1.4-x86_64.AppImage
Comicviewer-0.1.4-x86_64.AppImage.sha256

다운로드한 폴더에서 체크섬을 검증합니다.

sha256sum -c Comicviewer-0.1.4-x86_64.AppImage.sha256

성공 또는 OK가 표시되어야 합니다. 검증에 실패하면 파일을 실행하지 말고 다시 다운로드합니다.

4. 직접 실행

AppImage에 실행 권한을 부여한 뒤 실행합니다.

chmod +x Comicviewer-0.1.4-x86_64.AppImage
./Comicviewer-0.1.4-x86_64.AppImage

FUSE를 사용할 수 없는 환경에서는 다음과 같이 임시 추출 방식으로 실행할 수 있습니다.

./Comicviewer-0.1.4-x86_64.AppImage --appimage-extract-and-run

5. 선택 사항: 수동으로 사용자 계정에 설치

AppImage를 사용자 전용 프로그램 폴더에 설치하고 명령어로 실행하려면 다음을 사용합니다.

mkdir -p ~/.local/opt/comicviewer ~/.local/bin
install -m 755 Comicviewer-0.1.4-x86_64.AppImage \
  ~/.local/opt/comicviewer/Comicviewer.AppImage
ln -sfn ~/.local/opt/comicviewer/Comicviewer.AppImage ~/.local/bin/comicviewer

이후 새 터미널에서 다음 명령으로 실행할 수 있습니다.

comicviewer

~/.local/bin이 PATH에 없으면 AppImage의 전체 경로로 실행합니다.

데이터 저장 위치

Comicviewer는 XDG 표준 경로를 사용합니다.

설정: ${XDG_CONFIG_HOME:-~/.config}/comicviewer/
읽기 기록과 데이터: ${XDG_DATA_HOME:-~/.local/share}/comicviewer/
원격 ZIP 캐시: ${XDG_CACHE_HOME:-~/.cache}/comicviewer/

저장한 원격 위치의 사용자명과 비밀번호는 설정 파일에 평문으로 기록됩니다. 설정 파일 권한은 0600으로 제한되지만, 설정 파일을 다른 사람에게 전달하거나 공유하지 않아야 합니다.

원격 파일 이용 참고 사항

SMB 접속에는 호스트 시스템의 gvfs-smb가 필요합니다.
FTP와 SFTP 접속에는 호스트 시스템의 GVfs 서비스가 필요합니다.
원격 ZIP은 열기 전에 로컬 캐시로 완전히 다운로드됩니다.
기본 영구 ZIP 캐시 한도는 10GB이며 설정에서 변경할 수 있습니다.

4.3 KiB Raw Blame History