# tidoly stow 도움말

이 글은 앱 안 도움말(`internal/web/static/pages.html` 의 "help")의 원본이다. 앱은 같은 내용을 그 PC 의 실제 주소 · 폴더 · 운영체제에 맞춰 보여 준다 — 아래의 `<…>` 자리와 운영체제별 문장이 그것이다. 둘을 고칠 때는 함께 고친다. 화면만 봐도 알 수 있는 것은 쓰지 않는다 — 화면에 없는 것과 막혔을 때 필요한 것만 둔다. 그림은 `internal/web/static/help/` 에 있다(`[그림: …]` 자리).

---

tidoly stow는 내 PC에서 실행되는 독립적인 사진 서버입니다. 휴대폰에서는 호환되는 Immich 앱으로 tidoly stow에 연결해 사진을 보고 백업할 수 있습니다. tidoly stow와 Immich는 별개의 프로그램입니다.

관리자는 처음 설정한 화면을 언제든 다시 볼 수 있습니다 — 도움말 맨 위의 **첫 설정 다시 보기**.

## 1. 휴대폰 연결과 백업

1. App Store · Google Play에서 **Immich** 앱을 설치합니다.
2. 앱의 서버 주소에 `<서버 주소>`(예: `http://192.168.0.10:30891`)를 넣습니다. **폰 연결 · 상태**의 QR을 휴대폰 카메라로 찍어도 됩니다.
   [그림: `status` 폰 연결 · 상태 — QR 과 주소 · `app-server` Immich 앱 — 서버 주소]
3. 이 서버의 로그인 주소와 비밀번호로 로그인합니다.
4. 앱에서 백업을 켭니다 — 위쪽의 구름 아이콘을 누르고, 백업할 앨범의 **선택**에서 Camera 같은 앨범을 고른 뒤 **백업 활성화**를 켭니다. 사진을 한 장 찍고 tidoly stow에 보이면 백업이 되고 있는 것입니다.
   [그림: `app-cloud` ① 구름 아이콘 · `app-backup` ② 앨범 선택 · 백업 활성화 · `app-albums` ③ 백업할 앨범 고르기]

이 주소로 붙으려면 휴대폰이 이 PC와 같은 와이파이에 있어야 합니다. internet(tidoly 터널)을 켜 두었다면 주소가 둘 보입니다 — **어디서나** `https://<이름>.stow.tidoly.app`(Login with tidoly)과 **집 안에서만** 서버 주소(비밀번호). QR과 안내는 어디서나 주소로 만들어집니다.

가족에게는 "가족 안내 복사"로 안내 글을 보내세요.

## 2. 집 밖에서 접속

관리 → **연결 설정**에서 고릅니다.

- **internet** (tidoly 터널 방식, 베타) — 관리 → 연결 설정 → internet → **연결하기**를 누르고, tidoly에서 구글 계정으로 로그인해 주소(`<이름>.stow.tidoly.app`)를 고릅니다. 휴대폰 앱에는 `https://<이름>.stow.tidoly.app`을 넣고 **Login with tidoly**로 로그인합니다. 가족은 tidoly에서 그 주소에 구글 메일을 더하면 들어옵니다.
  [그림: `connected` 연결 설정 — internet 연결됨 · `app-tidoly` Immich 앱 — Login with tidoly]
- **VPN** (WireGuard) — 공유기에서 포트를 열 수 있으면 tidoly 없이 직접 잇습니다. 아래 가이드를 보세요.

### VPN (WireGuard) 가이드

tidoly 터널 없이 휴대폰과 이 PC를 VPN으로 직접 잇습니다. 이어지면 밖에서도 집 안과 똑같이 이 서버의 로그인 주소와 비밀번호로 씁니다. 공유기에서 포트 하나를 열 수 있어야 합니다.

1. 이 PC에서 관리 → 연결 설정 → VPN의 **켜기**를 누릅니다.
2. **바깥 주소**가 채워졌는지 봅니다. 집의 인터넷 주소가 자주 바뀌면 DDNS 이름(예: myhome.example.com)을 적으세요.
3. 공유기에서 **UDP 30891**을 이 PC로 포트 포워딩합니다. 공유기마다 메뉴 이름이 다릅니다.
4. **기기 더하기**로 휴대폰을 더하고, 휴대폰의 **WireGuard** 앱(App Store · Google Play)으로 그 기기의 QR을 찍습니다.
5. WireGuard 연결을 켠 채 Immich 앱의 서버 주소에 `http://10.30.0.1:30891`을 넣고 로그인합니다.

## 3. 사진 정리

- **인물** — 얼굴 인식 결과를 이용해 같은 사람의 사진을 모아 볼 수 있습니다. 사진 원본은 이 PC에 보관됩니다. 외부 접속 시에는 네트워크를 통해 사진을 조회할 수 있습니다. (인텔 맥에서는 얼굴 인식을 쓸 수 없습니다.)
- **기존 사진 폴더** — 관리 → 기존 사진 폴더에서 이 PC의 폴더를 등록하면 옮기지 않고 그 자리에서 읽습니다. 폴더 등록을 해제해도 원본 사진은 삭제되지 않습니다. 폴더 안의 파일을 이동하거나 이름을 바꾸기 전에는 먼저 등록을 해제하세요. 다시 쓸 폴더라면 "잠시 끄기"로 읽어 둔 정보를 남겨 둘 수 있습니다.
- **쿠폰** — 관리 → 자동 앨범에서 켜면 바코드가 있는 그림을 "쿠폰" 앨범에 모읍니다. 쿠폰이 아닌 것은 앨범에서 빼면 다시 들어오지 않습니다.
- **휴지통** — 지운 사진은 30일 동안 휴지통에 있어 복원할 수 있습니다. 휴대폰 앱에서 지워도 같습니다.

## 4. 비밀번호를 잊었을 때

- **가족** — 관리자가 관리 → 사용자에서 그 사람 줄의 "비밀번호 새로 정하기"로 정해 줍니다.
- **관리자** — 사진이 있는 PC에서 메뉴 막대(윈도: 트레이) 아이콘 → **관리자 비밀번호 변경**을 누릅니다(리눅스 서버: `sudo tidoly-stow password` 로 터미널에서 새 비밀번호를 넣습니다). tidoly에 연결해 두었다면 밖 주소에서 tidoly로 로그인해 관리 → 사용자에서 바꿔도 됩니다.

## 5. 사진 보관과 옮기기

사진은 설치할 때 고른 폴더(`<사진 폴더>`)에 있습니다. tidoly stow는 따로 백업하지 않으니, 이 폴더 전체(숨김 폴더 `.stow` 포함)를 다른 디스크에 복사해 두세요.

다시 설치하거나 다른 PC로 옮길 때는 tidoly stow를 끄고 이 폴더를 통째로 옮긴 뒤, 설치 화면에서 그 폴더를 고르면 계정 · 앨범 · 설정이 그대로 돌아옵니다.

## 6. 앱 아이콘

맥은 화면 맨 위 메뉴 막대, 윈도는 작업 표시줄 오른쪽 트레이의 tidoly stow 아이콘에서 다음을 합니다. 창을 닫아도 사진 서버는 계속 돕니다. (리눅스는 서비스로 돕니다 — `sudo systemctl stop tidoly-stow` · `start`.)

- **열기** · **브라우저에서 열기**
- **관리자 비밀번호 변경**
- **끝내기** — 사진 서버까지 끕니다. 그동안 휴대폰 백업이 멈춥니다.

[그림: 맥 `tray-mac` 메뉴 막대의 아이콘과 메뉴 · 윈도 `tray-win-icon` 트레이의 아이콘 · `tray-win-menu` 아이콘의 메뉴]

## 7. 연결이 안 될 때

1. 휴대폰과 이 PC가 같은 와이파이에 있는지, tidoly stow가 켜져 있는지 봅니다. 밖이라면 [2. 집 밖에서 접속](#2-집-밖에서-접속).
2. 휴대폰 앱이 어느 주소로 붙어 있는지는 앱 설정의 **연결**에서 봅니다. [그림: `app-connection` Immich 앱 — 연결]
3. 처음 실행할 때 방화벽이 물었다면 허용해야 합니다 — 맥: "들어오는 연결" · "로컬 네트워크" (시스템 설정 → 네트워크 → 방화벽), 윈도: Windows 방화벽, 리눅스: 30891 포트.
4. 그래도 안 되면 아이콘 → 끝내기, 그리고 앱을 다시 엽니다.

## 8. 문의

도움말의 **tidoly에 문의하기**가 tidoly 사이트의 [문의하기](https://www.tidoly.com/contact)를 엽니다. 무엇을 하다가 어떤 화면에서 생겼는지와 버전(도움말의 **버전 복사**)을 적어 주세요. 비밀번호와 사진은 보내지 마세요.