Comicviewer 설치 및 실행 안내

Comicviewer는 CachyOS와 Arch Linux에서 사용할 수 있는 만화·미디어 뷰어입니다. 로컬 및 SMB, FTP, SFTP 위치의 ZIP, 이미지, 동영상 파일을 열 수 있습니다.

1. 필수 패키지

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

sudo pacman -S fuse2 gtk4 dav1d gvfs gvfs-smb gstreamer curl \
  gst-plugins-base gst-plugins-good gst-plugins-bad gst-libav

fuse2: AppImage 마운트 및 실행
gtk4 4.12 이상, dav1d: 화면 표시와 이미지 디코딩
gvfs: FTP와 SFTP 접근
gvfs-smb: SMB 공유 접근
gstreamer, gst-plugins-*, gst-libav: MP4 등 동영상 재생
curl: About 창에서 최신 업데이트 다운로드

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

다음 두 파일을 같은 폴더에 다운로드합니다.

터미널에서 직접 다운로드할 수도 있습니다.

curl -fLO https://burningtuna.cafe24.com/www/Downloads/Comicviewer/Comicviewer-latest-x86_64.tar.gz
curl -fLO https://burningtuna.cafe24.com/www/Downloads/Comicviewer/Comicviewer-latest-x86_64.tar.gz.sha256

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

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

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

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

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

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

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

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

데이터 저장 위치

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이며 오래된 파일부터 자동으로 삭제됩니다.
메인 창의 캐시 비우기 버튼으로 현재 열려 있지 않은 ZIP 캐시를 직접 삭제할 수 있습니다.
캐시 한도는 설정 파일의 cache_quota_gb로 변경하며, 0은 영구 캐시를 사용하지 않는 값입니다.
메인 창 검색은 현재 표시 중인 폴더의 파일명을 필터링하며, 입력을 지우면 전체 목록을 복원합니다.
위치 목록의 최근 열어본 파일은 성공적으로 연 ZIP·이미지·동영상을 최신순으로 최대 100개 보관합니다.
최근 파일 기록에는 원격 위치 재접속 정보가 함께 저장되며 최근 기록 비우기로 전체 기록만 삭제할 수 있습니다.

뷰어 조작

[와 ]: 폴더의 이전/다음 ZIP·이미지·동영상 열기
Home과 End: 폴더의 첫 번째/마지막 파일 열기
동영상에서 ←와 →: 5초 뒤/앞으로 이동
동영상에서 ↑와 ↓: 음량을 5%씩 조절
이미지에서 1, 2, 3, 4: 폭 맞춤, 높이 맞춤, 2페이지, 100%로 전환 (3은 ZIP 뷰어에서 사용)
창보다 크게 표시된 이미지에서 ←, →, ↑, ↓: 해당 방향으로 최대 100px 이동
L: 우측 파일 목록 표시 또는 숨기기
파일 목록 상단 검색: 현재 재생 목록을 임시로 필터링하며, 입력을 지우면 전체 목록 복원
About 창의 업데이트: Cafe24에서 최신 번들을 내려받아 검증 후 사용자 영역에 설치
이미지에서 +/=와 -: 현재 화면의 이미지를 임시로 10%씩 확대 또는 축소
이미지에서 Ctrl + 마우스 휠: 현재 화면의 이미지를 임시로 10%씩 확대 또는 축소
2페이지의 좌→우/우→좌 방향은 마지막 선택을 저장해 다음 뷰어에서 복원
전체 화면에서 마우스 클릭: 숨겨진 컨트롤을 5초 동안 표시
전체 화면에서 ←, →, ↑, ↓: 컨트롤을 즉시 숨기고 해당 키 동작 실행
파일 목록의 더블클릭 또는 선택 후 Enter: 해당 파일 열기
파일 목록의 우클릭: 즐겨찾기 추가·제거 또는 다운로드
메인 창이나 뷰어에 로컬 파일 드롭: 부모 폴더를 열고 새 뷰어에서 해당 파일 열기
메인 창이나 뷰어에 로컬 폴더 드롭: 메인 창에서 해당 폴더 열기

애니메이션 GIF와 WebP는 standalone 이미지와 ZIP 내부 이미지에서 재생됩니다.

5.9 KiB Raw Blame History