# Comicviewer 설치 및 실행 안내

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

## 1. 필수 패키지

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

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

- `fuse2`: AppImage 마운트 및 실행
- `gtk4`, `dav1d`: 화면 표시와 이미지 디코딩
- `gvfs`: FTP와 SFTP 접근
- `gvfs-smb`: SMB 공유 접근
- `gstreamer`, `gst-plugins-*`, `gst-libav`: MP4 등 동영상 재생

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

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

- [Comicviewer-latest-x86_64.tar.gz](https://burningtuna.cafe24.com/www/Downloads/Comicviewer/Comicviewer-latest-x86_64.tar.gz)
- [Comicviewer-latest-x86_64.tar.gz.sha256](https://burningtuna.cafe24.com/www/Downloads/Comicviewer/Comicviewer-latest-x86_64.tar.gz.sha256)

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

```sh
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
```

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

```sh
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 캐시는 그대로 유지됩니다.

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

```sh
./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·이미지·동영상 열기
- `Home`과 `End`: 폴더의 첫 번째/마지막 파일 열기
- 동영상에서 `←`와 `→`: 5초 뒤/앞으로 이동
- 동영상에서 `↑`와 `↓`: 음량을 5%씩 조절
- `L`: 우측 파일 목록 표시 또는 숨기기
- 파일 목록 상단 검색: 현재 재생 목록을 임시로 필터링하며, 입력을 지우면 전체 목록 복원
- 이미지에서 `+`와 `-`: 현재 화면의 이미지를 임시로 10%씩 확대 또는 축소
- 이미지에서 `Ctrl` + 마우스 휠: 현재 화면의 이미지를 임시로 10%씩 확대 또는 축소
- 전체 화면에서 마우스 클릭: 숨겨진 컨트롤을 5초 동안 표시
- 전체 화면에서 `←`, `→`, `↑`, `↓`: 컨트롤을 즉시 숨기고 해당 키 동작 실행
- 파일 목록의 더블클릭 또는 선택 후 `Enter`: 해당 파일 열기
- 파일 목록의 우클릭: 즐겨찾기 추가·제거 또는 다운로드
- 메인 창이나 뷰어에 로컬 파일 드롭: 부모 폴더를 열고 새 뷰어에서 해당 파일 열기
- 메인 창이나 뷰어에 로컬 폴더 드롭: 메인 창에서 해당 폴더 열기

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