# 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이며 설정에서 변경할 수 있습니다.