home gallery

家居

home-gallery.org是一個自託管的開源網絡庫，可瀏覽帶有標籤，移動友好型和AI動力圖像和麵部發現的個人照片和視頻。嘗試演示畫廊或享受食物圖像！

注意：該軟件是一個私人寵物/業餘時間項目，沒有任何保修。在gitter.im或Discord上詢問問題。

你喜歡家裝嗎？它可以解決您的媒體問題嗎？您想幫助嗎？請閱讀貢獻指南，並通過對我的Patreon.com/xemle的任何經常性財務支持或對我的PayPal.me/xemle帳戶進行一次支持。先感謝您。

麻省理工學院許可證

鏈接

• 首頁
• 演示畫廊
• Linux，Mac，Windows Docker Image的最新二進製文件
• 文件
• ChangElog

動機

• 我所有的私人圖像和視頻的來源都存儲在我家裡的NAS上。畫廊應位於源頭的頂部/關閉。
• 雲服務不涵蓋我的隱私問題
• 所有畫廊軟件都缺乏在手機上具有快速的用戶體驗
• 畫廊軟件應有助於瀏覽並從完整的媒體檔案中發現被遺忘的回憶

目標用戶

• 解決自己的問題並加倍努力的計算機仿射用戶
• 在不使用雲服務的情況下提供您的本地數據
• 僅一個用戶 - 所有文件均提供
• 從手機查看自己的照片和視頻
• 從多個媒體源目錄（硬盤驅動器，Camara文件，手機文件等）提供所有圖像）

Quickstart

需要執行以下步驟以使用Homegallery

• 將圖庫軟件作為預先構建的二進製或Docker圖像下載
• 初始化配置~/Pictures類的媒體源
• 在Local主機上啟動服務器：3000

 curl -sL https://dl.home-gallery.org/dist/latest/home-gallery-latest-linux-x64 -o gallery
chmod 755 gallery
./gallery init --source ~/Pictures
./gallery run server

並打開Local主機：瀏覽器中的3000。運行./gallery -h以進一步幫助CLI。

有關進一步的二進製文件，請參見dl.home-gallery.org/dist。例如。 Linux，Mac或Windows的最新二進製文件。

配置gallery.config.yml可以在當前目錄中找到用於微調的目錄。有關更多信息，請參見文檔中的安裝部分。

使用Docker快速啟動

 mkdir -p data
alias gallery="docker run -ti --rm 
  -v $(pwd)/data:/data 
  -v $HOME/Pictures:/data/Pictures 
  -u $(id -u):$(id -g) 
  -p 3000:3000 xemle/home-gallery"
gallery init --source /data/Pictures
gallery run server

並打開Local主機：瀏覽器中的3000。運行gallery -h以進一步幫助CLI。

圖庫配置可在./data/config/gallery.config.yml中找到用於微調。

想使用Docker撰寫嗎？有關更多信息，請參見文檔中的安裝部分。

文件

有關一般文檔，請參見docs.home-gallery.org。

• 安裝
• CLI幫助
• 配置
• 常問問題
• 建築學

特徵

• 通過虛擬滾動無盡的照片流
• 視頻轉編碼
• 反向圖像查找（相似的圖像搜索）。如果您有一個日落圖像，則可以在檔案中輕鬆找到其他日落照片，而無需手動標記
• 面部檢測和通過類似面孔進行搜索
• 帶有和或不操作的表達性查詢語言
• 地理位置反向查找
• 通過PWA支持簡單移動應用
• 標籤，單和多選擇
• 支持僅閱讀和離線媒體來源。一旦生成了預覽文件並將其元數據推出，就不會觸摸原始資源，並且需要更多。因此，來自離線磁盤的媒體只需要提取一次，並且磁盤可以在接下來的運行中脫機
• 媒體由其內容識別。重複的媒體（相同的文件字節字節）僅處理一次。在沒有重新估算預覽等的情況下支持重命名。
• 快速文件更改檢測，例如添加，刪除，重命名或移動
• 靜態網絡畫廊網站導出，例如演示畫廊
• 元數據導出到XMP SideCar文件
• 將照片和視頻流到Chromcast啟用電視設備
• 在這樣的覆盆子pi上運行

極限

完整的“數據庫”已加載到瀏覽器中。我的100.000媒體大約是100 MB Plain JSON和12 MB壓縮JSON。當前的移動設備上的性能非常好。一個用戶報告了一個成功的設置，該設置超過400.000個媒體文件。歡迎進一步的反饋。

二進制下載

Homegallery擁有用於Linux，MacOS和Windows的二進製文件。可以在此處找到進一步的下載選項。

有關使用情況，請參見安裝部分。

外部服務和隱私

Homegallery的目的是盡可能少地使用敏感的私人圖像數據。它試圖使用可以本地部署的服務。但是，設置需要技術知識和技術維護。以下服務稱為：

對於Geo反向查找（Addess的地理坐標），Homegallery從OpenStreetMap查詢Nominatim服務。僅傳輸地理坐標。

對於反向圖像查找（相似的圖像搜索），對象檢測和麵部重組，Homegallery在api.home-gallery.org上使用其自己的公共API。該公共API支持諸如SOC Raspberry Pi之類的低功率設備，並且默認情況下，所有預覽圖像都發送給該公共API。沒有保留圖像或隱私數據。

可以將API配置並在本地或Docker容器中進行配置。有關使用情況，請參見安裝部分。

定制環境

Homegallery在JavaScript運行時Nodejs上運行，該nodejs由Linux（Raspberry PIS），Mac和Windows等各種平台支持。

在大多數情況下，自定義環境應該足夠

• 節點版20 lts（或18個舊LTS）
• Perl（Linux）

設定

 # Clone or download the repo from GitHub
git clone https://github.com/xemle/home-gallery.git
cd home-gallery
# Install required packages
npm install
# Build required modules
npm run build

在某些情況下，您可能還需要必要的構建工具來編譯庫綁定。

• 製作
• G ++
• Python

開發食譜

建造

Homegallery使用具有多軟件包的NPM工作區。常見的NPM腳本是clean ， build ， test 。

要僅運行包裝的子集，您可以使用PNPM的過濾器功能，例如構建模塊export-static和database ：

 npx pnpm -r --filter './*/{export-static,database}' build

單位測試

從特定軟件包（通過PNPM）運行單元測試

 npx pnpm -r --filter './*/{query,events}' test

端到端測試

運行特定的E2E測試（通過儀表）

 git clone https://github.com/xemle/home-gallery-e2e-data.git data
npm run test:e2e -- --tags dev

home-gallery-e2e-data使用GIT LFS包含測試文件。

E2E測試輸出數據存儲在/tmp/gallery-e2e目錄中。最新的測試運行與Homegallery Working目錄中的目錄latest-e2e-test相結合。在每個測試目錄中檢查cli.log和e2e.log （NDJSON格式）。

捆

從功能分支創建本地二進制捆綁包

 node scripts/bundle.js --version=1.3 --snapshot=-feature-test --filter=linux-x64 --no-before --no-run

創建本地本地捆綁包，該捆綁包通過NPM，例如Sharp，ffmpeg和ffprobe。它應僅包含應在任何地方運行的JS代碼。它需要在PATH環境中的外部二進制vipsthumbnail，ffmpeg和ffprobe才能正常工作。

 node scripts/bundle.js --version=1.3 --snapshot=-feature-test --filter=linux-native --no-before --no-run

開發重置

為了重置當前的發展狀態並以任何非常奇怪的錯誤行為開始新鮮，您可能會運行：

 rm -rf package-lock.json node_modules e2e/node_modules packages/*/node_modules
npm install && npm run clean && npm run build