PhotosExport — Apple Photosライブラリを丸ごと書き出すCLIツール

ToolmacOSSwiftPhotos

rcarmo/PhotosExport

★ 307

GitHub →

概要

PhotosExportは、Apple Photosのライブラリに入っている全ての資産をファイルシステム上へエクスポートするための、シンプルで意図のはっきりしたmacOSコマンドラインツールです。作者はShortcutsやAppleScriptベースの既存ソリューションの不足・不安定さを理由に本ツールを作成しています。デフォルトでは「現行カレンダー年」の資産を一括抽出し、利用可能な全リソース（オリジナル、編集済み、Live Photoのムービーなど）とメタデータを一緒に出力する設計が特徴です。小規模かつ実用重視のツールで、Swiftで実装されています。

GitHub

リポジトリの統計情報

  • スター数: 24
  • フォーク数: 0
  • ウォッチャー数: 24
  • コミット数: 11
  • ファイル数: 8
  • メインの言語: Swift

主な特徴

  • 年単位（デフォルトは現在の年）でライブラリ資産を一括エクスポートする設計
  • 各資産について、利用可能なすべてのリソース（オリジナル、編集済みバージョン、Live Photoのムービーなど）を取得
  • メタデータや識別子を含むサイドカーファイルを出力し、後処理や再インポートを想定
  • コマンドラインツールとして簡単にビルド・実行でき、スクリプト運用に適する

技術的なポイント

PhotosExportはSwiftで実装されたコマンドラインアプリケーションで、Package.swiftが含まれているためSwift Package Managerでのビルドが前提になっています。macOS上のPhotosライブラリにアクセスしてアセットを列挙・取得するため、AppleのPhotos系API（PhotoKitや内部のPHAクラス群）を利用している設計と見受けられます。典型的な実装パターンとしては、ライブラリ内のPHAsset相当オブジェクトをフィルタリング（年単位）して順に処理し、各アセットから利用可能なリソースを個別にダウンロード／書き出す流れです。

出力では元ファイルの形式（JPEG/HEIC/RAW/MP4など）を保持し、編集済みの派生ファイルやLive Photoのムービー部分といった複数リソースを個別ファイルとして保存します。さらに、Exifやタイムスタンプ、UUID、キーワードやレーティングといったメタデータをJSONなどのサイドカーファイルにまとめて書き出すことで、後続の整理・検索・再インポート作業に有用な構造にしています。

並列処理やI/O効率にも配慮している可能性が高く、Swiftの非同期API（Dispatchやasync/await）やバッファリングを利用して大量の資産を扱う際の速度と安定性を確保している設計が想定されます。また、コマンドライン向けの典型的な拡張として、年指定や出力先指定、ドライランモードなどのオプションを備えていることが期待されます。Makefileが含まれているため、ビルドや配布用の簡易コマンドが用意されている点も運用面で便利です。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .gitignore: file
  • LICENSE: file
  • Makefile: file
  • Package.swift: file
  • README.md: file

…他 3 ファイル

（補足）Swiftパッケージとしての最小構成が揃っており、リポジトリサイズは小さく、実験的／ユーティリティ用途のツールであることがわかります。

まとめ

PhotosExportはシンプルで実用的、Photosライブラリの一括エクスポートに最適なCLIツールです。

リポジトリ情報：

READMEの抜粋：

PhotosExport

Why I wrote this

PhotosExport is a small macOS command-line tool that exports Apple Photos library assets to the filesystem, and that I developed out of frustration with Shortcuts’ limited (i.e., non-existent) Photos export capabilities and the brokenness of AppleScript-based solutions.

It is intentionally opinionated:

  • Exports assets from a complete calendar year (current year by default).
  • For each asset, exports **all available `PHA…

関連記事

Tool

Notchy — ノッチに表示する軽量ターミナル（macOS）

NotchyはmacOS用のメニューバーアプリで、MacBookのノッチ部分に小さな浮動ターミナルパネルを表示します。ノッチにホバーするかメニューバーアイコンをクリックすると、埋め込みセッションを持つ端末パネルが現れ、開いているXcodeプロジェクトを自動検出してそのプロジェクトフォルダへ移動（cd）します。シンプルに開発ワークフローにアクセスできることを狙ったツールです。（約300字）

macOSSwift開発ツール
Tool

ContextD — 画面活動を継続的にキャプチャしてローカルで要約するmacOSツール

ContextDは、macOS上で2秒ごとにスクリーンショットを取得し、前回との差分を抽出して変化領域だけをOCRし、抽出したテキストをローカルに蓄積・要約（LLMを利用）して他のローカルツールから利用できるようにする効率的なアプリです。差分ベースの処理で計算負荷とストレージを抑えつつ、継続的にユーザーの画面文脈を構築します。

macOSSwiftProductivity
Tool

AnsiSaver — macOS向けANSIアート・スクリーンセーバー

AnsiSaverは、BBS時代のANSIアートをmacOSのスクリーンセーバーとして復活させるプロジェクトです。16colo.rsに蓄積されたBBS用パックを直接取得して画面上にスクロール表示し、CP437文字セットや当時のカラーパレットを再現します。Swiftで実装され、Xcodeプロジェクトとブリッジングヘッダを含み、外部のANSIレンダリング実装（サブモジュール）と連携して高速かつ忠実な描画を行います。（約300字）

macOSSwiftScreensaver
Tool

Poof — macOS テキストスニペット展開ツール

PoofはmacOS向けの軽量テキストスニペット展開ツールです。ユーザーが定義したトリガーを入力すると、あらかじめ設定した置換テキストに自動で展開します。設定はTOML形式のファイルで管理でき、任意のディレクトリ（dotfilesに含めることも想定）を指定して読み込めます。展開モードは区切り文字で確定する方式と、トリガーを完全に入力した段階で即時展開する方式の二種類をサポートします。Swiftで実装され、シンプルな設定とグローバルな入力監視が特徴です。

macOSSnippetSwift
Tool

FileTypeGuard — ファイルタイプ関連付けの保護ツール

軽量なmacOSユーティリティ「FileTypeGuard」は、ユーザーが設定したファイルの関連付け（デフォルトで開くアプリ）を監視して保護し、サードパーティ製アプリが無断で上書きしてしまった場合に自動で元に戻すことを目的とします。インストールやアップデート時に生じる関連付けの乗っ取りを防ぎ、使い慣れたアプリでファイルを開き続けられるようにします（Swiftで実装、Swift Packageとして構成）。300字程度の簡潔な説明です。

macOSSwiftUtility
Tool

Weather Wallpaper — macOS用ライブ3D地球壁紙

MapboxGL、Swift、WebKitを組み合わせて作られたmacOSアプリ。デスクトップの壁紙をライブな3D地球に置き換え、リアルタイムの天気レーダー、飛行機のライブトラッキング、花粉情報、昼夜サイクルを表示します。RainViewerによる降水レーダーはAPIキー不要で利用でき、Mapboxのスタイルを3D球体に描画して滑らかなビジュアルを実現します（約300字）。

macOSMapboxSwift