픽나루 사용 도움말

픽나루 1.0 기준 · 2026년 9월 30일 수정

운영자: 블루메이커(Bluemaker)
문의: [email protected]

픽나루가 하는 일

본인의 Immich 서버가 있어야 사용할 수 있습니다. 휴대폰에서 Immich로 백업한 새 사진과 동영상을 Mac 사진 앱으로 가져옵니다.

휴대폰의 Immich 백업 → 본인의 Immich 서버 → 픽나루 → Mac 사진 앱 → 설정에 따른 iCloud 사진 동기화

픽나루를 쓰려면 Mac과 별도의 Immich 서버가 필요합니다. 서버 설치·운영이나 iCloud 저장 공간이 포함된 서비스는 아닙니다. Apple 계정 암호를 픽나루에 입력할 필요도 없습니다.

픽나루의 ‘추가’는 Mac 사진 보관함에 넣었다는 뜻입니다. 이후 iCloud 업로드는 Apple 사진 앱이 담당하며, 픽나루가 완료를 확인하지는 않습니다.

시작하기: 작은 사진 한 장으로 먼저 확인하세요

1. Immich 서버에 로그인하기

Mac의 웹브라우저에서 본인이 사용하는 Immich 서버를 열고 로그인합니다. 휴대폰으로 찍은 사진이 서버 웹 화면에도 보이는지 확인해 주세요. 휴대폰에서 서버로의 백업 설정은 Immich에서 해야 합니다.

픽나루의 기본 서버 주소 http://127.0.0.1:2283은 이 Mac에서 실행 중인 서버를 뜻합니다. NAS·다른 컴퓨터·클라우드의 서버라면 그 서버의 주소로 바꿔야 합니다. 기본값이 입력되어 있다고 연결되거나 전송이 시작되지는 않습니다.

외부 서버는 HTTPS를 사용하세요. 로컬 HTTP도 통신 내용을 암호화하지 않습니다. 앱은 허용된 로컬 주소에만 별도 동의를 받아 HTTP를 사용하며, 외부 공개 HTTP 주소는 거부합니다.

2. 픽나루용 API 키 만들기

Immich 웹 화면 오른쪽 위 사용자 아이콘에서 Account Settings → API Keys를 찾습니다. 서버 버전에 따라 번역과 버튼 위치가 다를 수 있습니다. Immich 사용자 설정 안내

새 키를 만들 때 다음 세 권한을 이름 그대로 찾아 선택하세요.

관리자 계정이나 전체 권한 all, 업로드·삭제 권한은 필요하지 않습니다. 오류가 난다고 권한을 모두 켜지 마세요. 발급된 키는 비밀번호처럼 다루고 채팅·이메일·스크린샷으로 보내지 않습니다.

키를 잃어버렸다면 본인의 Immich에서 새 키를 만들 수 있습니다. 어떤 앱에서 사용하는 키인지 확인하고, 더 이상 쓰지 않는 키만 서버에서 폐기하세요.

3. 서버 주소와 키 연결하기

픽나루의 1. 사진 서버 연결에서 주소와 API 키를 넣습니다. 저장된 연결을 바꿀 때는 먼저 자동 전송을 끄고 주소 또는 API 키 변경을 누릅니다.

입력칸 옆 붙여넣기 버튼을 사용할 수 있습니다. API 키는 입력해도 화면에서 가려집니다. 연결 확인하고 이 Mac에 보관을 누르면 계정을 확인하고 이 Mac의 키체인에 키를 보관합니다. 붙여넣기만으로 저장하거나 자동 전송을 켜지는 않습니다. 편집을 그만두려면 변경 취소를 누르세요.

연결 확인 성공만으로 실제 원본 다운로드까지 검증된 것은 아닙니다. 아래 첫 전송으로 함께 확인합니다.

4. Mac 사진 추가 허용하기

2. Mac 사진 접근 → 사진 추가 허용하기를 누르고 macOS 안내를 읽은 뒤 허용합니다. 픽나루에는 사진 추가 전용 권한이 필요합니다. 기존 보관함 전체를 읽거나 사진을 삭제하는 권한을 요구하는 기능이 아닙니다.

iCloud에도 보이게 하려면 Mac 사진 앱의 설정 → 일반에서 시스템 사진 보관함을 확인하고 iCloud → iCloud 사진을 켜 두어야 합니다. 이미 사용하는 보관함을 임의로 바꾸지는 마세요. Mac·iCloud 저장 공간과 인터넷 연결도 필요합니다. Apple 시스템 사진 보관함 안내

5. 자동 전송을 직접 켜기

자동 전송 켜기… 버튼에서 사진·동영상의 범위와 조건을 읽고 동의하고 켜기를 누릅니다. 백그라운드 승인이 필요하면 백그라운드 허용 설정 열기에서 허용한 뒤 상태 새로 확인을 누르세요. 보안 설정 전체를 끄거나 권한 데이터베이스를 초기화할 필요는 없습니다.

맨 위에 자동 전송 켜짐 · 다음 확인 대기가 보이는지 확인합니다. ‘백그라운드 시작 확인 필요’나 오류가 남아 있다면 아직 성공으로 보지 말고 그 안내를 확인하세요.

6. 켠 뒤 새 사진과 짧은 동영상 올리기

처음 시험할 사진은 자동 전송을 켠 다음 본인 Immich 계정에 업로드합니다. 서버에서 업로드 완료를 확인하고, Mac을 켜 둔 채 다음 확인을 기다리세요. 약 15분 간격으로 확인하도록 설정되어 있지만 잠자기·macOS 예약·파일 크기에 따라 더 걸릴 수 있습니다.

픽나루의 최근 처리 기록과 Mac 사진 앱에서 도착을 확인합니다. 보관함은 촬영 날짜 위치에 나타날 수 있으니 오늘 추가했더라도 예전 촬영 날짜나 최근 저장·가져온 항목도 살펴보세요. 사진 한 장이 확인되면 작은 동영상도 올리고, 재생과 소리를 따로 확인해 주세요.

상태 새로 확인은 앱 표시를 갱신하는 버튼이며 즉시 전송 버튼이 아닙니다. 같은 사진을 기존 중계기와 픽나루가 동시에 보내지 않도록 하세요.

어떤 시점부터 가져오나요?

저장된 연결에서 처음 자동 전송을 시작한 기준 이후 서버에 업로드된 본인 미디어가 대상입니다. 촬영 날짜가 아닙니다. 오래전에 찍은 사진도 나중에 업로드했다면 대상일 수 있습니다. 처음 켜기 전에 이미 서버에 있던 사진과 동영상은 가져오지 않습니다.

같은 연결에서 끄고 다시 켜면 최초 기준·진행 위치·미완료 목록을 유지합니다. 꺼 둔 사이 업로드한 파일도 그 기준 이후라면 이어서 확인합니다.

이전에 사진만 동의했다면 업데이트만으로 동영상까지 동의가 확대되지 않습니다. 끈 뒤 동영상 포함 안내에 다시 동의해야 합니다. 그 경우에도 연결의 최초 기준 이후가 대상이며, 새 동의 이전에 업로드된 해당 범위의 동영상이 포함될 수 있습니다.

앱 종료와 자동 전송 끄기는 다릅니다

자동 전송은 Mac이 켜져 있고 사용자가 로그인한 상태에서 동작합니다. 재부팅 후 로그인과 서버 재기동이 필요하며, 잠자기나 전원 꺼짐 중 전송을 보장하지 않습니다.

상태 표시 읽기

붙여넣기가 안 될 때

입력칸 옆 붙여넣기 버튼을 먼저 사용해 보세요. 여러 줄, 제어 문자, 너무 긴 문자열은 거부합니다. 앞뒤 공백은 정리하지만 키 내부의 잘못된 공백을 임의로 고쳐 주지는 않습니다.

원격접속 중이라면 같은 Mac의 메모장에 비밀이 아닌 짧은 문장을 복사해 붙여넣기가 되는지 확인해 보세요. 이것도 안 되면 원격접속 프로그램의 클립보드 공유나 현재 로그인 계정 문제일 수 있습니다. 실제 API 키로 클립보드 시험을 하거나 키를 채팅에 보내지 마세요. 앱의 붙여넣기 버튼이 원격 클립보드 동기화 자체를 고치는 것은 아닙니다.

사진·동영상이 안 보일 때

1. Immich 웹 화면에서 업로드가 끝났는지 확인합니다.
2. 연결한 계정의 파일이며 최초 전송 기준 이후 업로드인지 확인합니다.
3. 픽나루의 켜짐 상태·최근 확인 시각·오류를 확인합니다.
4. Mac이 깨어 있고 로그인되어 있으며, 서버에 연결되는지 확인합니다.
5. Mac 사진 권한과 여유 공간을 확인합니다. 보관함에서는 촬영 날짜 위치도 살펴보세요.
6. Mac에는 있고 다른 기기에만 없다면 iCloud 사진 설정·용량·동기화 상태를 확인합니다. 키를 다시 발급하는 것부터 시작할 필요는 없습니다.

지원 파일과 한도

코덱 이름을 고정 목록과 대조해 허용하는 방식이 아닙니다. 원본을 바꾸지 않고 영상·음성을 끝까지 읽는지 검사합니다. macOS 디코더와 사진 앱이 지원하는 범위가 다를 수도 있어, 검사를 통과한 모든 파일의 사진 앱 추가까지 보장하지는 않습니다. 자동 변환은 하지 않습니다.

RAW, Live Photo 쌍의 움직임·효과 복원, 스트리밍용 분할 MP4, 외부 파일 참조와 암호화 영상은 지원하지 않습니다. 아직 검사하지 못하는 내부 구조나 손상된 파일도 중단될 수 있습니다. 서버가 Live Photo 구성 영상을 별도 항목으로 반환하면 지원 조건에 맞는 경우 일반 동영상으로 추가될 수 있지만 쌍으로 복원하지는 않습니다.

총 전송 개수나 사용 기간에는 제한이 없습니다. 한 회차 최대 50개 항목을 처리하며 이미 처리한 항목의 건너뛰기도 이 수에 포함됩니다. 남은 목록은 다음 회차로 이어집니다. 서버 조회와 저장소에도 안전 한도가 있어 ‘무제한·무중단’ 기능은 아닙니다.

‘지원하지 않는 동영상’으로 멈췄다면

MP4라는 이름만으로 모든 영상의 내부 형식이 같지는 않습니다. 원본을 지우거나 확장자만 바꾸지 마세요. 파일 크기·재생 길이·macOS에서 재생되는지부터 확인해 주세요.

해당 항목을 자동 전송하지 않기로 결정했다면, OFF 상태에서 이 항목만 자동 전송에서 제외… → 이 항목 제외를 사용할 수 있습니다. 서버나 사진 앱의 원본을 삭제하는 기능은 아닙니다. 다만 현재 앱 안에서 제외를 되돌릴 수 없고, 필요한 파일은 별도로 옮겨야 합니다. 제외 후에도 계속하려면 직접 다시 켭니다.

‘이전 결과 확인 필요’가 떠요

중단 직전에 사진 추가가 끝났는지 확실하지 않을 때 중복을 줄이기 위해 멈춘 상태입니다.

1. 이전 결과 확인하기… 버튼에서 안내와 총건수를 읽고 실제 사진 보관함을 확인합니다. 작업 중이거나 상태를 읽지 못한다면 확인을 보류합니다.
2. 확인했으며 자동 재전송하지 않기는 불확실한 항목을 성공으로 바꾸거나 다시 보내는 버튼이 아닙니다. 확인한 항목은 자동 재전송하지 않으며, 보관함에 없다면 직접 옮겨야 합니다. 화면에 일부만 표시되어도 안내된 전체 대상에 적용될 수 있으므로 총건수를 확인하세요.
3. 확인 후에도 자동 전송은 꺼짐입니다. 계속하려면 직접 다시 켭니다. 원래 기준과 미완료 목록은 유지합니다.

동일한 원본이 서버에서 새 ID로 다시 발견되면 다시 멈출 수 있습니다. 새 중복 전송이 일어났다는 뜻은 아닙니다. 먼저 보관함을 확인하고 필요하면 현재 항목만 별도로 제외하세요. 기록 폴더를 지우거나 앱을 초기화해서 해결하지 마세요.

이 Mac에 저장되는 정보

이 정보는 운영자에게 전송되지 않습니다. 지우는 방법은 아래 두 절을 참고하세요. 자세한 개인정보 처리 내용은 개인정보 처리방침에 있습니다.

연결과 API 키를 삭제하려면

1. 자동 전송을 끄고 진행 중 작업·미확인 결과가 없는지 확인합니다.
2. 연결 삭제… → 이 Mac에서 연결 삭제를 누릅니다. 성공하면 현재 연결의 Mac 키를 지우지만 중복 방지 기록은 남깁니다. 오류가 나오면 삭제 완료로 보지 마세요.
3. 서버 접근 권한 자체도 없애려면 Immich에서 해당 키를 별도로 폐기합니다. 다른 앱이 같은 키를 쓰는지 먼저 확인하세요.

앱 삭제나 연결 삭제가 모든 과거 키·전송 기록·백업 사본의 전체 삭제를 의미하지는 않습니다. 사진 앱에 이미 들어간 파일은 별도로 관리해야 합니다. 개인정보 처리방침

사용을 그만두고 이 Mac의 자료를 모두 지우려면

1. 자동 전송 끄기를 누르고 꺼짐을 확인합니다.
2. 1. 사진 서버 연결 상자 아래의 이 Mac의 픽나루 자료 모두 삭제… 버튼을 누르고 안내를 읽은 뒤 모두 삭제를 누릅니다.
3. 이 Mac에 저장된 모든 연결의 API 키, 최초 기준·진행 위치, 중복 방지·제외·확인 기록이 삭제됩니다. 되돌릴 수 없습니다.
4. 서버 접근 권한도 없애려면 Immich에서 픽나루용 키를 별도로 폐기합니다.

다시 연결해 자동 전송을 켜면 그 시각부터 새로 시작합니다. 그 전에 업로드된 항목은 아직 옮기지 못한 것이라도 자동으로 옮겨지지 않습니다. 사진 보관함의 사진·동영상, 서버의 API 키·원본, Time Machine 등 백업 사본, macOS 진단 기록은 이 기능으로 지워지지 않습니다. 백그라운드 등록 해제를 확인하지 못했다는 안내가 나오면 시스템 설정 → 일반 → 로그인 항목에서 픽나루를 끌 수 있습니다.

이 기능은 문제 해결용이 아닙니다. 전송이 멈췄을 때는 위의 복구 절차를 먼저 따라 주세요.

문의하기

[email protected]으로 다음 정보를 알려주시면 문제 구간을 파악하는 데 도움이 됩니다. 문의 메일은 Google(Gmail)을 통해 국외 서버에 보관될 수 있습니다. 자세한 내용은 개인정보 처리방침을 확인해 주세요.

• 픽나루·macOS·Immich 버전, 문제가 생긴 대략적인 시각
• 비밀정보를 가린 오류 문구와 Mac 사진 앱까지 들어왔는지 여부
• 동영상 문제라면 확장자·대략적인 크기·재생 길이·확인 가능한 코덱

API 키, 로그인 암호, 개인 사진·동영상 원본, 전체 진단 파일은 보내지 마세요. 운영자는 블루메이커(Bluemaker)입니다.