GEOFRAME

撮った写真を、手元で整えて、見せる準備まで。

GEOFRAME(ジオフレーム)は、自宅に置くセルフホスト型の写真管理基盤です。ローカルフォルダや Google Drive の写真を 1 つのカタログにまとめ、撮影地を地図で整え、表示用の画像を用意します。写真を画面に映すのは、別プロジェクトの Miharashi です。

紹介ページ(LP): https://ysogabe.github.io/geoframe/

何ができるか

• 写真をひとつのカタログに: ローカルフォルダと Google Drive の写真を、原本を変えずに索引します。HEIC にも対応します。
• 表示用の画像を作る: 向きを直した長辺 2560px の JPEG を別に作ります。位置情報を含む EXIF は残しません。
• 良いカットを選ぶ: 鮮明さや露出を調べ、似た写真の中から勧める 1 枚を決めます。お気に入りはそれより優先します。
• 撮影地を地図で整える: 位置の無い写真は前後の写真から撮影地を推定し、地名を付けます。管理画面の地図で直した位置は、そのあとの自動の推定で上書きしません。
• 旅の記録を下書きする: 旅程と写真を照合して日別の旅行ブログの下書きを作り、EXIF を除いた画像つきの静的 HTML に書き出せます。
• 言葉で写真を探す(任意): 言葉による検索や、同じ場面の写真の整理を、LAN 内のモデルかクラウドの AI で行えます。設定するまで動きません。
• 表示側へ写真を渡す: 写真の一覧と表示用画像を HTTP で配り(写真フィードの契約)、Miharashi がそれを読んで映します。

1 つのファイルで動くサーバーで、データは SQLite のファイル 1 つ(catalog.db)にまとまります。ブラウザで管理画面（状況・写真・設定の 3 タブ。設定は読み取り専用）を開いて使います。

[!IMPORTANT] GEOFRAME には利用者認証がありません。信頼できるローカルネットワークで使うか、認証付きのリバースプロキシの内側に置いてください。インターネットへ直接公開しないでください。

地図・地名の補完・Google Drive・クラウドの AI を使うと、座標や縮小した写真が外部のサービスへ送られます(クラウドの AI は課金されます)。詳しくは使い方を見てください。

いまの状態

作者の自宅で毎日動かしながら、少しずつ手を入れています。2026 年 10 月に、写真を映す機能を Miharashi へ移し(ADR 0008)、サーバーを Rust の単一バイナリに作り直しました。

動作を確かめているのは x86_64 の Linux だけです。

使う・開発する

ビルドと起動、外部との通信、設定とデータの扱い、試験の回し方は 使い方、本番の配布(systemd・更新・バックアップ)は デプロイガイド、環境変数の一覧は 設定リファレンス にまとめています。設計や判断の記録は Docs、紹介ページの更新と公開の手順は LP の管理 を参照してください。

変更を送るときは コントリビューションガイド を、脆弱性の報告は公開 Issue ではなく セキュリティ方針 に従ってください。

ライセンス

MIT License です。同梱するサードパーティの資産(MapLibre GL JS、Share Tech Mono)のライセンスは web/vendor/ にあります。