Immuch360 繁體中文 安裝
客廳電視上的山景全景

在大螢幕上用遙控器看照片。

在電視上。

Android TV 和 Google TV、LG 電視,以及以測試 build 形式提供的 Samsung 電視。

你需要:

Android TV 和 Google TV LG 電視(webOS) Samsung 電視(Tizen) Android 手機和平板

在大螢幕上用遙控器看照片。所有電視應用程式的操作方式都一樣:方向鍵移動選框,OK 鍵開啟,返回鍵返回,在 360° 照片中則用方向鍵環顧四周。電視本身沒有照片,因此它顯示的是你的 Immich 伺服器,在 Android TV 和 LG 電視上還包括你的網路共用、Plex 伺服器和攝影機。

在 Android TV 和 Google TV 上

同一個 Android 應用程式,第一次啟動就是深色主題,遙控器是唯一的輸入方式。在檢視器中,左右鍵可切換到上一個或下一個照片或影片,即使影片正在播放也可以;在 360° 照片或影片中,則用方向鍵環顧四周。

  1. 用 adb 安裝 APK,見安裝。在歡迎頁面上,選擇「新增網路共用或媒體伺服器」可新增共用、Plex 伺服器或攝影機,也可以選擇「不連線伺服器使用」或「連線到 Immich 伺服器」,用手機掃描該頁面上的 QR code 即可登入電視(見用手機登入)。
  2. 在檢視器中,遙控器的播放和暫停、倒轉、快轉、上一個和下一個按鍵都能使用。播放影片時按 OK 鍵會顯示控制項,並已選取播放和暫停,再按一次 OK 鍵即可暫停;後面接著 -10 s 和 +10 s 按鈕,影片有多種音訊或字幕時,還有音訊和字幕按鈕。從 build 29 起,在播放按鈕上按下鍵即可到達進度列:左右鍵每按一次移動 10 s,按住時更快,OK 鍵用來播放或暫停。控制項和日期會在最後一次按鍵 5 s 後隱藏,此時左右鍵會切換到上一個或下一個檔案;在共用中,該檔案會在獨立的頁面開啟,並附有控制它的控制項。電視上的影片不再循環播放,除非你開啟設定、項目檢視器、影片、循環播放。
  3. 按 Menu 鍵、Info 鍵或長按 OK 鍵,會開啟照片或影片的詳細資訊(唯讀):日期、地點、相機、編碼格式、尺寸和位元率。電視無法解碼的影片會直接說明,並列出其編碼格式、尺寸以及電視解碼器的上限,而不是一直載入;超出解碼器能力的 360° 影片會在開啟 360° 播放器之前先詢問,原因會記錄在個人資料選單的「紀錄」頁面中。
  4. 用遙控器搜尋:在結果中按 Back 會回到「搜尋」,焦點在搜尋列;在「日期」中,「自訂範圍」會先選擇開始和結束年份,再選擇月和日。在「相簿」中,「清空」位於搜尋列旁邊。這些是 Michael Cloutier(mlc70)的成果,並保留了他的 commit。
  5. 照片的控制項顯示時,會在左下角顯示日期和時間(「顯示照片日期與時間」,位於「設定」、「項目檢視器」中)。在影片的進度列上,快速連按 Left 或 Right 每按一下會跳 10 s,接著 30 s,再接著 60 s,每一下都會計入。相簿會從第一張照片開啟,頂端列顯示相簿名稱。
用手機登入電視、頭戴裝置或電腦

掃描。登入。觀看。 用電視遙控器或在頭戴裝置中輸入伺服器位址、電子郵件和密碼,得花上好幾分鐘。只要你手機上的 Immuch360 已登入你的 Immich 伺服器,電視、Meta Quest 或電腦幾秒內就能登入:大螢幕顯示一個 QR code,手機掃描它,你確認後,螢幕就會開啟你的媒體庫。使用手機應用程式時,你的密碼始終留在手機上。Immich 應用程式沒有類似的功能。

  1. 在大螢幕上(Android TV 和 Google TV、Meta Quest 視窗、Windows、Linux 或 macOS),選擇「連線到 Immich 伺服器」:登入頁面會在伺服器表單旁顯示「用手機登入」、一個 QR code 和一組 10 個字元的代碼。
  2. 在已登入你伺服器的手機上:設定、「連接電視或電腦」,然後點一下「掃描代碼」。在 Meta Quest 中,手機無法掃描其螢幕,請選擇「改為輸入代碼」,再輸入頭戴裝置顯示的代碼。
  3. 手機會詢問「要登入(該螢幕)嗎?」並顯示一組六位數字:確認螢幕上顯示的是同一組數字,然後點一下「登入」。螢幕隨即開啟你的時間軸。
在 LG 電視上(webOS)

Immich 自己的應用程式無法安裝在 LG 電視上。Immuch360 為搭載 webOS 5.0 或更新版本的 LG 電視(2020 年起的電視)提供了一個獨立的電視應用程式,可用遙控器和 Magic Remote 操作:它會顯示你的 Immich 伺服器、網路共用、Plex 伺服器和 Tapo 攝影機,並把你的 360° 照片呈現在一個可用方向鍵轉動的球形上。它是以 Seeky91 的 immich-tv-webos 為基礎建置,該專案帶來了時間軸、相簿、人物、地點、搜尋、投影片播放以及用手機登入;感謝 Seeky91。版本 1.0.0 已於 10 月 24 日提交至 LG Content Store,並在 LG Cloud Test Lab 的 webOS 25 電視上執行過;在 LG 核准之前,它需在 Developer Mode 下安裝,在 Issues 中的每一份回報都很有幫助。

  1. 在處於 Developer Mode 的電視上安裝,請見安裝。它有自己的應用程式 ID,因此可以和 Seeky91 的 Immich TV 並存安裝。
  2. 用手機登入(掃描 QR code),或使用電子郵件和密碼,或使用 API 金鑰登入。
  3. 用方向鍵和 OK 鍵瀏覽。在檢視器中,左右鍵可切換到上一個或下一個照片或影片,影片播放時也可以;控制項會在最後一次按鍵 5 s 後隱藏;Info 鍵開啟詳細資訊;頻道鍵用來縮放;Magic Remote 的指標和滾輪都能使用。從 GitHub 上的版本 1.0.1 起,上鍵可立即放大照片,接著用方向鍵移動,返回鍵縮小;照片仍在載入時會顯示 Loading 提示。
  4. 360° 照片會在球形上開啟:每按一次方向鍵轉動一步,按住則持續轉動。「以 360° 檢視」適用於伺服器未標記的 2:1 照片;VR180 照片會顯示在半球上,3D 照片則以單眼顯示。黃色鍵和藍色鍵可旋轉平面照片。
  5. 登入後,在應用程式側邊欄的「網路共用」中:新增 SMB、WebDAV 或 DLNA 共用、Plex 伺服器(在 plex.tv/link 上用代碼登入)或 Tapo 攝影機。它們的照片會在同一個檢視器中開啟,360° 照片則顯示在球形上。
在 Samsung 電視上(Tizen)

搭載 Tizen 5.5 或更新版本的 Samsung 電視(2020 年起的電視)以測試 build 0.2.0 的形式取得同一個電視應用程式,這個版本不在 Samsung 的商店中:手動輸入登入、時間軸、相簿、檢視器和投影片播放、球形上的 360° 照片和一鍵旋轉照片。

  1. 為你的電視簽署套件,並在 Developer mode 下安裝,見安裝。
  2. 輸入伺服器位址,然後輸入電子郵件和密碼或 API 金鑰登入。
  3. 用方向鍵和 OK 鍵瀏覽。360° 照片會在球形上開啟。
  4. 超出電視解碼器能力的影片會直接說明,並列出電視能播放的尺寸和檔案的尺寸,而不是一直載入。卡住的影片會顯示一則提示,列出其位元率和解決方法:讓 Immich 轉碼較大的檔案,或使用更快的連線。「關於這台電視」會列出電視的影片上限。
應用程式的真實截圖,使用 CC0 素材

適用的螢幕

適用的螢幕手機與平板電腦Meta Quest電視
用手機登入(QR code) 是是是是

安裝到你的各個螢幕上。

Google Play

Android
Google Play:build 40

Google Play

App Store

iPhone · iPad
App Store:版本 3.3.2,自 2026年11月6日 起

App Store

Meta Horizon Store

Meta Quest
Meta Horizon Store:build 40

Meta Horizon Store

GitHub

Windows · macOS · Linux · Android TV · LG · Samsung · APK
GitHub 上的 build 42,2026年11月6日 · 桌面版 build 22,2026年11月6日

GitHub 如何安裝