# Comicviewer 설치 및 실행 안내

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

## 1. 필수 패키지 설치

AppImage 실행과 원격 파일 접근에 필요한 패키지를 설치합니다.

```sh
sudo pacman -S fuse2 gvfs gvfs-smb
```

- `fuse2`: AppImage 마운트 및 실행
- `gvfs`: FTP와 SFTP 접근
- `gvfs-smb`: SMB 공유 접근

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

Release 페이지에서 `Comicviewer-0.1.0-x86_64.tar.gz`와 같은 최신 버전의
통합 번들을 다운로드합니다. 압축을 풀고 설치 스크립트를 실행합니다.

```sh
tar -xzf Comicviewer-0.1.0-x86_64.tar.gz
cd Comicviewer-0.1.0-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 캐시를
모두 삭제합니다. 삭제한 데이터는 복구할 수 없으므로 필요한 설정은 제거 전에
별도로 백업합니다.

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

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

- `Comicviewer-0.1.0-x86_64.AppImage`
- `Comicviewer-0.1.0-x86_64.AppImage.sha256`

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

```sh
sha256sum -c Comicviewer-0.1.0-x86_64.AppImage.sha256
```

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

## 4. 직접 실행

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

```sh
chmod +x Comicviewer-0.1.0-x86_64.AppImage
./Comicviewer-0.1.0-x86_64.AppImage
```

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

```sh
./Comicviewer-0.1.0-x86_64.AppImage --appimage-extract-and-run
```

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

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

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

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

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