整理分類本地影片的工具——Stash

海港黑鷹 · 发表于 2025-3-2 11:02:08

在此向大家推薦一個挺好用的開源工具——Stash
~~（其實是想推坑，那就可以多些人上載資料到社區資料庫~~

似乎正式網站為 https://stashapp.cc/
不過基於其開源性質，都是建議直接到 https://github.com/stashapp/stash 了解詳情？

以下會簡單翻譯一下軟件介紹、安裝方法、快速入門指南、自動獲取短片資料方法、還有個人覺得挺好用的社區插件。

軟件介紹

Stash 是一款用 Go 語言編寫的網頁應用程序，旨在服務和管理您的成人內容收藏。它是自托管的，並根據 AGPL-3.0 許可證發布。目前，Stash 支援 Windows、macOS、Linux、FreeBSD 和 Docker。

Stash 會從互聯網上收集您收藏中視頻的相關信息，並可通過社區開發的插件進行擴展，支緩眾多內容提供商和網站。
Stash 支持多種視頻和圖像格式。
你可以為視頻添加標籤並在之後輕鬆找到它們。
Stash 提供有關表演者、標籤、工作室等的統計數據。
你可以通過文檔中的 README 或 Stash 正式網站進一步了解該軟件。

你可以參考此演示視頻（不含成人內容），以了解其實際運作。

安裝方法

詳細請參考 https://docs.stashapp.cc/installation/

懶人包
你可以到 Release Page（https://github.com/stashapp/stash/releases）揀選適合你平台的文件，或在 https://github.com/stashapp/stash 的 Installing Stash 部直接下載。

Windows

從 GitHub 下載最新的 stash-win.exe 二進制文件。
運行該可執行文件（通常為 stash-win.exe）。
如果一切順利，程序將自動開啓瀏覽器標籤頁，進入 http://localhost:9999 以開始使用。
程序會在您的通知區域顯示一個圖標，您可以從那裡訪問一些快捷鏈接或關閉服務器。

Mac
在 macOS 上，Stash 可以作為打包應用程序（Stash.app）或命令行應用程序（stash-macos）運行。兩者均為通用應用程序，因此能在 Apple Silicon 和基於 Intel 的 Mac 上原生運行。

打包應用程序是大多數用戶的推薦選擇，支援支持桌面通知，顯示菜單欄圖標，且無需從 Terminal 啟動。
然而，由於應用程序限制，它僅支持在 $HOME/.stash 目錄下進行設置。如果您想使用其他文件夾，則需使用命令行應用程序。

從 GitHub 下載最新的 Stash.app.zip 文件。
打開 Stash.app.zip 壓縮包，並將 Stash 應用程序拖到您的「應用程序」文件夾中。
開啓 Stash 應用程序。
如果一切順利，程序將自動開啓瀏覽器標籤頁，進入 http://localhost:9999 以開始使用。

Linux

蛤？
都用Linux了，安裝什麼的都不是問題啦
嗚啦！

快速入門指南

首次運行
在 Windows 或 macOS 上運行應用程序時，可能會出現安全提示，因為二進制文件尚未簽名。

在 Windows 上，點擊「更多信息」，然後選擇「仍要運行」按鈕以繞過提示。
在 macOS 上，按住 Control 鍵點擊應用程序，選擇「打開」，然後再次點擊「打開」。

FFmpeg

Stash 需要 FFmpeg。如果您尚未安裝，Stash 會為您自動下載一份。建議 Linux 用戶從其發行版的管理器安裝 FFmpeg。

開始使用
Stash 是一款基於網頁的應用程序。應用程序啟動後，其界面預設可從 http://localhost:9999 訪問。

首次運行時，Stash 會提示您設定一些配置選項以及需要索引的媒體目錄，這在 Stash 中稱為「Scan（掃描）」。掃描完成後，您的媒體將可用於瀏覽、管理、編輯和標籤（tags）。

自動獲取短片資料
Stash 能通過使用抓取器直接從眾多網站拉取元數據（包括演員、標籤、描述、片商等），這些抓取器可直接整合進 Stash 中。識別整個收藏通常需要結合多個來源：

StashDB（內含NSFW內容，就不擺放連結了，請自行Google）：本項目維護的 StashDB 是一個包含片名、片商和演員的社區資料庫（Crowdsource Database）。將其連接到 Stash 可自動識別大部分典型的收藏。它運行於我們的 stash-box 軟件，主要聚焦於主流片商。相關指南、邀請碼等詳情可參閱《訪問 StashDB 指南》。
社區管理的 stash-box 數據庫：多個社區維護的 stash-box 數據庫也可類似連接到 Stash。每個數據庫服務於略有不同的領域並遵循各自的方法論。有關各 stash-box 的介紹、差異及註冊信息的詳情，請參閱《訪問 Stash-Boxes 指南》。
社區維護的抓取器：許多社區維護的抓取器可從 Stash 內下載、安裝和更新，讓您從廣泛的其他網站和數據庫中提取數據。它們位於設置 -> 元數據提供者 -> 可用抓取器 -> 社區（穩定版）。這些抓取器使用起來可能比 stash-box 稍複雜，因每個抓取器的運作方式略有不同。更多信息請訪問 CommunityScrapers 倉庫。
上述所有抓取數據到 Stash 的方法，在《抓取指南》中也有更詳細的說明。

推薦社區插件
Stash 社區插件可參閱 https://docs.stashapp.cc/plugins/

renamerOnUpdate
https://github.com/stashapp/CommunityScripts/tree/main/archive/renamerOnUpdate
這個可以在更新資料的同時，自動更改影片文件的檔案名稱，還有自動移動至指定的文件夾，不過好像最近變成了deprecated （棄用）狀態。我見列表裡面應該也有其他類似的吧

內置 Tools -> Scene Duplicate Checker
這個原來是內置的，可以根據pHash找出重複的影片檔案