Immuch360 한국어 설치

Android 휴대폰과 태블릿

  • Google Play: build 40
  • build 41, 2026년 11월 5일부터 검토 중
  • GitHub의 build 42, 2026년 11월 6일
설치 방법
  1. Google Play, 또는 Releases 페이지의 APK: 휴대폰용 Immuch360-v<version>-arm64-v8a-release.apk, 어디서나 동작하는 범용 Immuch360-v<version>-release.apk도 있습니다.
  2. 공식 Immich 앱과 함께 설치할 수 있습니다. GitHub의 APK는 자동으로 업데이트되지 않으므로 Releases 페이지를 계속 확인하세요. 스토어에서 앱을 한 번 설치하면 그 뒤로는 해당 스토어의 업데이트를 받으세요.

iPhone과 iPad

  • App Store: 버전 3.3.2, 2026년 11월 6일부터
설치 방법
  1. App Store: 버전 3.3.2, 2026년 11월 6일 게시. 또는 Mac에서 Xcode로 앱을 직접 빌드하세요. 직접 빌드하기를 참고하세요.
  2. "서버 없이 사용"을 탭하거나, 서버에 로그인하려면 "Immich 서버에 연결"을 탭합니다. build 24부터 둘 다 환영 페이지에 있습니다.

Meta Quest

  • Meta Horizon Store: build 40
  • build 41, 2026년 11월 5일부터 검토 중
  • GitHub의 build 42, 2026년 11월 6일
설치 방법
  1. Horizon Store에서: Meta가 각 제출물을 심사할 때마다 갱신되는 스토어 버전입니다.
  2. 또는 release의 -quest-release.apk 파일을 개발자 모드에서 adb나 SideQuest로 사이드로드합니다: adb install -r Immuch360-v<version>-quest-release.apk, 그런 다음 헤드셋의 라이브러리에서 "Unknown sources"를 엽니다.
  3. 스토어 버전과 GitHub APK는 서로 다른 키로 서명되어 있습니다: 하나에서 다른 것으로 바꾸려면 먼저 앱을 제거해야 하며, 그러면 로그인, 설정, 네트워크 공유 목록이 모두 사라집니다.

Windows

  • GitHub의 build 22, 2026년 11월 6일
설치 방법
  1. desktop 사전 릴리스에서 Immuch360-Desktop-3.3.0-rc.0-desktop.22-windows-x64-setup.exe를 다운로드하고(SHA256SUMS.txt로 확인 가능) 실행합니다. 설치 프로그램과 ZIP은 서명되어 있으며, Windows는 게시자로 APROGSYS를 표시합니다. 이 게시자가 SmartScreen에 아직 낯선 동안에는 한 번 더 물어볼 수 있습니다: "추가 정보"를 선택한 다음 "그래도 실행"을 선택합니다.
  2. "현재 사용자에게만 설치"(관리자 권한 불필요) 또는 "모든 사용자에게 설치"를 선택한 다음, 이미 Windows 언어로 선택되어 있는 설치 프로그램의 언어를 선택합니다.
  3. 시작 메뉴에서 Immuch360 Desktop을 실행합니다. 사진과 동영상은 "연결 프로그램"에 나타나지만(파일을 마우스 오른쪽 버튼으로 클릭한 뒤 연결 프로그램), 기본 프로그램으로는 절대 지정되지 않습니다. 새 build를 처음 실행할 때는 Windows가 파일을 검사하는 동안 1분 정도 걸릴 수 있습니다.
  4. Windows 10 또는 11, 64비트. 업데이트하려면 다음 build의 설치 프로그램을 실행하세요: 로그인, 폴더, 설정은 그대로 유지됩니다. 같은 릴리스의 ZIP은 폴더 형태의 같은 프로그램이므로, 원하는 곳에 압축을 풀고 그 안의 immuch360.exe를 실행하면 됩니다. desktop build 4부터 8까지가 시작 시 "duplicate column name: group_date"에서 멈췄던 컴퓨터에서도 build 9는 그 데이터베이스를 열고 데이터를 그대로 유지합니다.

macOS

  • GitHub의 build 22, 2026년 11월 6일
설치 방법

Immuch360-Desktop-3.3.0-rc.0-desktop.22-macos.dmg를 desktop 사전 릴리스에서 받아 열고 앱을 Applications로 드래그합니다(Apple 실리콘과 Intel, macOS 12 이상). 서명되지 않아 macOS가 한 번 확인을 요청합니다. macOS 14 이하에서는 Control 키를 누른 채 클릭한 뒤 "열기"를 선택하고, macOS 15 이상에서는 "시스템 설정"의 "개인정보 보호 및 보안"에서 "무조건 열기"를 선택하세요. 다른 Mac과 다른 macOS 버전에서의 제보를 환영합니다.

Linux

  • GitHub의 build 22, 2026년 11월 6일
설치 방법

Ubuntu 22.04 이상과 Debian 12 이상에서는: sudo apt install ./Immuch360-Desktop-3.3.0-rc.0-desktop.22-linux-amd64.deb; Fedora 40 이상에서는: sudo dnf install ./Immuch360-Desktop-3.3.0-rc.0-desktop.22-linux-x86_64.rpm. 두 파일 모두 desktop 사전 릴리스에 있습니다. 그런 다음 애플리케이션 목록에서 Immuch360 Desktop을 실행합니다. 미리보기 단계로, 컴퓨터의 폴더, 사진과 구체로 보는 360° 사진, 그리고 패키지가 설치하는 시스템의 libmpv로 재생하는 평면 동영상을 지원합니다(360°, 3D, 원본 동영상은 안내 메시지와 함께 평면으로 재생). SMB 공유는 Ubuntu 22.04와 Debian 12부터 동작합니다. Fedora에서는 카메라 동영상에 RPM Fusion의 FFmpeg가 필요합니다. GNOME Keyring이나 KWallet이 없으면 비밀번호는 세션 동안만 보관되며, 앱 설정에서 그 사실을 알려줍니다.

Android TV와 Google TV

  • GitHub의 build 42, 2026년 11월 6일
  • Google Play의 TV 등록 정보는 검토 중
설치 방법
  1. Google Play가 TV용 앱을 제공하기 전까지는 Releases 페이지의 범용 Immuch360-v<version>-release.apk를 사용하세요.
  2. TV에서 개발자 옵션과 USB 디버깅을 켭니다(Google TV에서는: 설정, 시스템, 정보에서 "Android TV OS build"를 일곱 번 선택한 다음, 설정, 시스템, 개발자 옵션. 이름은 TV마다 다릅니다).
  3. 같은 네트워크의 컴퓨터에서 adb(Android SDK Platform Tools)로: adb connect <address of the TV>, TV에 나오는 확인 창을 수락한 다음 adb install -r Immuch360-v<version>-release.apk.
  4. 앱이 배너와 함께 TV의 앱 목록에 나타납니다. 다음 릴리스도 같은 방법으로 설치하세요: -r이 로그인과 설정을 유지합니다.

LG TV(webOS)

  • 버전 1.0.0, 2026년 10월 24일부터 LG 검토 중
  • GitHub의 버전 1.0.1
설치 방법
  1. 버전 1.0.0은 LG 심사 중입니다. LG Content Store에 올라오기 전까지는 Developer Mode로 설치합니다: webOS 5.0 이상의 LG TV, 같은 네트워크에 있는 컴퓨터, 무료 LG 개발자 계정이 필요합니다. TV에서 LG Content Store로 Developer Mode 앱을 설치하고 로그인한 뒤, Dev Mode Status를 켜고 TV가 다시 시작되도록 둡니다. TV의 IP 주소와 앱에 표시되는 passphrase를 적어 두세요.
  2. 컴퓨터에 webOS CLI를 설치합니다(Node.js 18 이상): npm install -g @webos-tools/cli. 그런 다음 ares-setup-device로 TV를 등록하고(IP 주소, 포트 9922, 사용자 prisoner), passphrase를 묻는 ares-novacom --device <name> --getkey를 실행합니다.
  3. webOS 1.0.1 사전 릴리스에서 UHD TV라면 Immuch360-webOS-1.0.1.ipk를, LG가 1280x720 앱을 제공하는 Full HD TV라면 Immuch360-webOS-1.0.1-1280x720.ipk를 다운로드합니다. SHA256SUMS.txt로 확인한 다음 ares-install --device <name> Immuch360-webOS-1.0.1.ipk를 실행합니다. webosbrew의 webOS Dev Manager를 쓰면 명령줄 없이 같은 작업을 할 수 있습니다.
  4. Developer Mode 세션은 1000시간 동안 유지되며 Developer Mode 앱의 EXTEND 버튼으로 연장할 수 있습니다. 세션이 만료되면 TV가 이렇게 설치한 앱을 삭제합니다. 자세한 내용은 webos/README.md에 있습니다.
  5. 앱이 LG Content Store에 올라오면 Developer Mode로 설치한 사본을 제거하고 스토어에서 설치하세요.

Samsung TV(Tizen)

  • 테스트 build, 직접 서명하고 설치합니다. Samsung 스토어에는 없습니다
  • GitHub의 버전 0.2.0
설치 방법
  1. 테스트 build 0.2.0은 Samsung 스토어에 없으므로 직접 설치합니다. Tizen 5.5 이상의 Samsung TV(2020년 이후 모델), 같은 네트워크에 있는 컴퓨터, Samsung 계정이 필요합니다. TV에서 Apps, App Settings로 가서 12345를 입력하고, Developer mode를 켠 뒤 컴퓨터의 IP 주소를 입력하고 TV를 다시 시작합니다.
  2. Tizen 사전 릴리스에서 Immuch360-Tizen-0.2.0.wgt를 다운로드하고 SHA256SUMS.txt로 확인합니다. Samsung TV는 해당 TV용으로 서명된 앱만 설치하므로, TV의 DUID가 등록된 Samsung 인증서로 패키지를 다시 서명해야 합니다: 커뮤니티 도구인 Apps2Samsung이 DUID를 읽고, Samsung 계정으로 패키지를 서명해 설치까지 해 주며, Samsung Certificate Extension이 있는 Tizen Studio로 같은 작업을 직접 할 수도 있습니다.
  3. 앱을 열고 서버 주소를 입력한 다음 이메일과 비밀번호 또는 API 키를 입력해 로그인합니다. "이 TV 정보"에는 TV가 지원하는 기능이 텍스트와 QR 코드로 표시됩니다: 작동하지 않는 점과 함께 이 텍스트를 Issues나 Discussions에 올려 주시면 가장 큰 도움이 됩니다.