
2026/07/02 23:13
Immich 3.0
RSS: https://news.ycombinator.com/rss
要約▶
Japanese Translation:
Immich v3.0.0 が利用可能で、Breaking API の変更が行われており、Docker Compose を経由してデプロイする前に、管理者が
.env ファイル内の IMMICH_VERSION を v3 に更新する必要があります。これは、多くの修正が API を使用するサードパーティツールのみに影響を与えるためです。このリリースはモバイル体験の向上を優先しており、iOS 上で破壊的ではない編集(切り抜きや回転などを行いつつオリジナルファイルを修飾しない)を可能にし、一方で色付け機能、ライブフォト対応、ローカル資産編集を一時的に削除しています(これらは将来的に復帰予定)。新機能としては、iOS のコントロール問題を解決するカスタム Web ビデオプレーヤー、バッテリー最適化の制限を克服する堅牢な背景バックアップスケジューラー(Android)、そしてモバイルデバイスからの直接アルバムアップロードによる摩擦低減が含まれます。モバイルユーザーは теперь スライドショー全体画面での表示、資産への OCR テキストハイライト機能、Android ギャラリーアプリとしての動作による直接的な写真/ビデオ閲覧、さらに新しい「Explore」(Web)および「Search」(モバイル)ページでアップロード日順にソートされたライブラリコンテンツを探索できるようになりました。開発者向けには、ビジュアルモードまたは JSON モードの自動化ワークフロービルダーへのアクセスに加え、ファイルシステムからデータベース記録の欠落や不一致を検出する整合性チェック機能も提供されています。追加の改善点としては、品質切り替え付きのオンザフライビデオ変換(現在 Web 限定ですがモバイルにも展開予定)および immich.store で販売開始される新しいマーチャンダイズのアナウンスが含まれます。
※注:改善版は、マーチャンダイズ、ソート変更、スライドショー機能、Android ギャラリー統合、OCR トグル、直接アルバムアップロードなどの欠落していたキーポイントを統合し、レガシー資産に対してメタデータ抽出が必要であることも明示的に記載することで、ソースリストとの完全な精度を確保しています。
本文
Immich バージョン 3.0.0 リリースニュース
Immich の主要バージョン v3.0.0 が正式发布されました!🎉
チームメンバーと貢献者の数ヶ月間の努力に感謝いたします。今回のリリースには、モバイルアプリやワークフロー機能など多くの新機能が追加されています。
📥 アップデート方法
アップデート手順は以下の通りです。
-
環境変数の更新
ファイル内の.env
を以下のように変更してください:IMMICH_VERSION# v2 から v3 に切り替え IMMICH_VERSION=v3 -
アップデートの実行 コンテナを再構築して最新バージョンを起動します。
docker compose pull && docker compose up -d
注意: 設定ファイルの互換性について不安な場合は、必ず移行ガイドを確認してください。API を使用しているサードパーティ製ツールは API の変更の影響を受ける可能性があります。
🆕 リリースハイライト (New Features)
今回のリリースにおける主な新機能と改善点は以下の通りです。
- モバイル非破壊編集: 写真の再加工時に原ファイルを変更せず、オリジナルを保ったまま編集できます(クロップや回転など)。
- ワークフロー機能: ドラッグ&ドロップで自動化を構築できます。トリガー・フィルタ・アクションの設定が可能で、共有機能も追加されました。
- バックアップの改善: Android での背景バックアップの信頼性が向上し、iOS でも同期とアップロードが効率化されました。
- 最近追加されたページ: アセットの撮影順ではなく、「Immich に追加された日時」でソートして閲覧できるようになりました。
- 整合性チェック: データベースとファイルシステムの一致を確認するレポート機能が登場しました(未追跡、欠落、チェックサム不一致の検出)。
- モバイルでの新機能: スライドショー再生、OCR テキスト抽出、直接アルバムへのアップロード、共有時の画像サイズ選択が可能になりました。
- ビデオトランスコード: リアルタイムトランスコード機能を試せます(画質変更やコーデック最適化など)。
- UI/UX 改善: ウェブ版で統一された新しいビデオプレイヤー、Android から直接ギャラリーとして開く機能などを追加しました。
🛠️ 技術的変更点 (Technical Details)
今回のリリースではコードベースの基盤強化も進められています。
- 非破壊編集の実装: モバイル側もウェブ側と同じエディターを使用し、作業のやりやすさが向上しました。
- ワークフローエディターの進化: ビジュアルエディターと JSON エディターの切り替えに対応し、トリガーとステップの連続設定が容易になりました。
- Android バックアップ最適化: 周期性タスクの実装により、新撮だけでなくライブラリ全体のバックグラウンドアップロードが可能に。バッテリー消費も最小限に抑えられます。
- リアルタイムトランスコードの試行: オフライン処理を廃止し、要求された瞬間に応じた画質を提供できるようになりました。
⚠️ 互換性を破る変更点 (Breaking Changes)
システムや API を利用されている場合は、以下の重要な変更にご注意ください。
- 依存ライブラリの変更:
をclass-validator
に移行しました。zod - API の廃止・変更:
エンドポイントや旧タイムラインの削除など、多数の API 改修が行われています。getRandom
およびdeviceId
パラメータが削除されました。deviceAssetId
エンドポイントが廃止されました。/api/server/theme
- トークンレスポンス: 使用されていないパラメータが除去されています。
- 非推奨機能の削除: 「Replace Asset」や「My Shared Link DTO」などが削除されました。
🔄 変更履歴の概要 (What's Changed)
🚨 Breaking Changes(互換性のない変更)
のclass-validator
へへのリファクタリング (#26597)zod- 「Replace Asset」機能の削除 (#27022)
- 「My Shared Link DTO」および旧タイムライン関連エンドポイントの削除 (#27023, #27666, #27804 など)
/deviceId
の廃止 (#27818)deviceAssetId- API キースキーマの再命名 (#27828)
- pgvecto.rs サポートの終了 (#28159)
- NumPy 2.4 の必須化 (#28158)
- libopus エンュームの削除 (#28325)
- アセットレスポンスから asset faces の除去 (#27779)
🫥 Deprecated Changes(非推奨化)
- PUT ルートを PATCH への更新に伴う提案の受け入れ (#28859)
🔒 セキュリティ強化
- プロフィール画像のサムネイルパイプラインへの適用 (#27890)
- OAuth の不安全なリクエストをデフォルトで無効化 (#27844)
🚀 新規機能
- モバイル編集機能の実装 (#25397)
- アルバマップマーカーエンドポイントの追加 (#27830)
- バックチャンネルログアウト API の実装 (#26235)
- Android での定期ワークマネージャータスク導入 (#23563)
- カスタムビデオプレイヤーコントロールの実装 (#26183)
- 「最近追加されたアセット」ページの公開 (#28272)
- モバイルスライドショービューの実装 (#28421)
- ワークフローおよびプラグイン機能の正式公開 (#26727)
- HLS とリアルタイムトランスコード機能の実装 (#28230)
🌟 機能強化・UI/UX 改善
- コマンドライン機能の実装 (#27546)
- UI のフルパス検索モード追加 (#26758)
- "Add Tags" マルチ選択オプションの追加 (#26269)
- ユーザーアップロードヒートマップ機能の追加 (#28593)
- 共有時の画像品質オプションの追加 (#28918)
- 人物管理コンポーネントのページ化 (#26971)
- メモリーズから非表示の人物の除外 (#20877)
- その他、多数の詳細な UI/UX 改善とバグ修正
🐛 バグ修正の主な項目
- RTL レイアウトでの画像中央配置修正 (#27678)
- 検索時の人物タイルキー追加 (#27689)
- プレビュー選択のクリア動作修正 (#27702)
- 動画プレビュー取得のキャンセル (Svelte レグレッション回避) (#27713)
- ログアウト時の readonly リダイレクト修正 (#27728)
- iOS 背景タスクフェーズの並列実行改善 (#28293)
- ヘイフォアキーリファレンスの浮遊防止 (#28382)
- インデックス修正 (#28264)
📚 ドキュメント・翻訳
- ローカル UI 使用手順の明記 (#27813)
デフォルト値の明示 (#28279)upgrade-insecure-requests- Tailscale のユーザ/デバイス制限更新 (#28151)
- 複数言語への翻訳対応の継続
🌟 新しい貢献者 (New Contributors)
以下の皆様は今回のリリースに初めてご貢献くださいました。おめでとうございます!
- @OdinOxin, @migpovrap, @StevenMassaro, @timdobras, @santanoce
- @fredfloydd, @sparsh985, @LJspice, @git-akihakune, @shaun0927
- @yosit, @Hakuin123, @pinhao, @AyaanMAG, @DavidTheFighter, @benbeckford
- @bhugh, @SkyDev125, @aigarius, @mws-weekend-projects, @TheBestX11
- @sakshamchawla, @santoshakil, @stfn42, @thowdev, @SuperSandro2000
- @racehd, @inesiscosta, @gnojus, @rdeaton, @agg23, @ollioddi, @Caltsic
- @fabianwimberger, @tvangemert, @BlankCanvasStudio, @pneuly, @timjonez
- @moversity, @nekowinston, @bondeabhijeet, @joojoooo, @pedrovieira
- @yoshovski, @maxinegardenas, @jeevan6996, @rizwanpatel-gif, @olildu
- @MuySup, @aclerici38, @jullanggit, @jameskimmel, @djbravo06
詳細な変更履歴: v2.7.5...v3.0.0 このニュースリリースは、Immich の公式ディスカスから生成されました。