exif

exif は画像を変更せずにメタデータを読み取ります。グループ化した EXIF、簡易概要、GPS 座標、JSON、存在する場合は埋め込みサムネイルを扱えます。

データバージョン 1.2.4安定版
lil-terminal

概要

exif は画像メタデータ専用の読み取りツールです。EXIF のセクション表示、概要、GPS 座標、埋め込みサムネイル、またはファイルへリダイレクトして後処理できる整形 JSON を出力します。

メタデータは存在しないこともある

カメラや画像処理によって EXIF、GPS、サムネイルが記録されていなかったり削除されていたりします。項目がないこと自体は正常で、GPS は画像共有時に位置情報を明かす可能性もあります。

構文

lil-terminal
exif <file> [options]

リファレンス

exif <file> [options]

Inspect photo metadata, GPS and embedded thumbnails without modifying the source image.

コマンド一覧

exif <file> [options]

exif <file>

EXIF メタデータを表示する

exif <file> -t [dst] [-f]

埋め込みサムネイルを抽出する；-f は置換を許可

-f

サムネイル抽出時の置換を許可する

-i

ファイル・画像・カメラの簡潔な概要を表示する

-g

GPS 座標と地図リンクを表示する

-json

完全な EXIF データを整形済み JSON で表示する

使い方

exif images/photo.jpg -i は短い概要を表示します。GPS があれば -g は座標と地図リンクを、-json は利用可能な全項目を表示します。-t [dst] は既存の埋め込みサムネイルを抽出し、-f は -t と同時に指定したときだけ上書きを許可します。

制限と安全性

PHP EXIF 拡張が必要です。すべての写真に GPS やサムネイルがあるわけではなく、-t は存在しないサムネイルを作れません。JSON を公開する前に位置情報を確認してください。画像の変換には img を使用します。

インタラクティブな sandbox プレビュー

用意された例をページ上でそのまま実行できます。結果は事前に生成されてブラウザに表示され、サーバーではターミナルコマンドを実行しません。

画像を調べてメタデータを出力する

インストールと管理

現在の互換バージョンをインストールします。全機能は Base、縮小版は Minimum を選び、すでに導入済みのモジュール更新には upgrade を使います。

Base と Minimum は同じ現在のモジュールリリースの二つのパッケージです。

Base パッケージ

ローカル参照と公開済みの全モードを含む完全パッケージをインストールします。

install exif
Minimum パッケージ

縮小パッケージをインストールします。ローカルリファレンスは含まれず、help <cmd> -i で現在のサーバーリファレンスを開きます。

install exif -m
正確な公開版

この公開済みバージョンを正確に指定してインストールします。

install exif -v 1.2.4
確認または更新

upgrade が互換性を確認し、必要な場合だけブロックを置換します。

upgrade exif
モジュールを削除

コアや他のモジュールに触れず拡張ブロックを削除します。

install exif -u

例

例はコピーできますが、サイトは実行しません。実プロジェクトではパス、権限、破壊的オプションを確認してください。

画像を調べてメタデータを出力する
exif images/photo.jpg -i
File         sandbox/images/photo.jpg
Size         885 B
MIME         image/jpeg
Dimensions   40x30
Camera       Example Camera Sandbox 1
Date         2026:11:01 12:00:00
Orientation  1
GPS          12.0541667, -77.0750000
Thumbnail    -
GPS 座標と地図リンクを表示する
exif images/photo.jpg -g
Latitude   12.0541667
Longitude  -77.0750000
Map        https://maps.google.com/?q=12.0541667,-77.0750000
EXIF メタデータを表示する
exif images/photo.jpg
[FILE]             
FileName           photo.jpg
FileDateTime       1793563170
FileSize           885
FileType           2
MimeType           image/jpeg
SectionsFound      ANY_TAG, IFD0, GPS
                   
[COMPUTED]         
html               width="40" height="30"
Height             30
Width              40
IsColor            1
ByteOrderMotorola  1
                   
[IFD0]             
Make               Example Camera
Model              Sandbox 1
Orientation        1
DateTime           2026:11:01 12:00:00
GPS_IFD_Pointer    120
                   
[GPS]              
GPSLatitudeRef     N
GPSLatitude        ["12/1","3/1","15/1"]
GPSLongitudeRef    W
GPSLongitude       ["77/1","4/1","30/1"]
完全な EXIF データを整形済み JSON で表示する
exif images/photo.jpg -json
{
    "FILE": {
        "FileName": "photo.jpg",
        "FileDateTime": 1793563170,
        "FileSize": 885,
        "FileType": 2,
        "MimeType": "image/jpeg",
        "SectionsFound": "ANY_TAG, IFD0, GPS"
    },
    "COMPUTED": {
        "html": "width=\"40\" height=\"30\"",
        "Height": 30,
        "Width": 40,
        "IsColor": 1,
        "ByteOrderMotorola": 1
    },
    "IFD0": {
        "Make": "Example Camera",
        "Model": "Sandbox 1",
        "Orientation": 1,
        "DateTime": "2026:11:01 12:00:00",
        "GPS_IFD_Pointer": 120
    },
    "GPS": {
        "GPSLatitudeRef": "N",
        "GPSLatitude": [
            "12/1",
            "3/1",
            "15/1"
        ],
        "GPSLongitudeRef": "W",
        "GPSLongitude": [
            "77/1",
            "4/1",
            "30/1"
        ]
    }
}
存在しない画像を扱う
exif images/photo.jpg -t
Embedded thumbnail not found
埋め込みサムネイルを抽出する；-f は置換を許可
exif images/photo.jpg -t tmp/preview.jpg -f
Embedded thumbnail not found
サムネイル抽出時の置換を許可する
exif images/photo.jpg -f
-f requires -t
GPS 座標と地図リンクを表示する
exif images/photo.jpg -i -g
Choose one EXIF output mode
ファイル・画像・カメラの簡潔な概要を表示する
exif images/plain.jpg -i
File        sandbox/images/plain.jpg
Size        631 B
MIME        image/jpeg
Dimensions  12x8
Thumbnail   -
GPS 座標と地図リンクを表示する
exif images/plain.jpg -g
GPS data not found
EXIF メタデータを表示する
exif config/app.xml
Not an image file
EXIF メタデータを表示する
exif images/missing.jpg
Image file not found
EXIF メタデータを表示する
exif images/photo.jpg -unknown
?

この例で使うファイル: sandbox/images/photo.jpg

例では、保護されたドキュメント用 /sandbox/ ワークスペースのファイルまたはディレクトリを使います。

[binary file: photo.jpg]

関連ドキュメント

モジュールをインストールするには？ →「command not found」と表示されるのはなぜですか？ →

現在の公開版

v1.2.42026-10-31

画像と GPS の検証

画像ではないファイルを明示的に拒否します。GPS の方位と範囲を確認し、サムネイルで元画像を上書きしません。

# バージョン履歴