Pythonのimghdrモジュールで画像形式を判定する方法

Python標準ライブラリのimghdrモジュールは、ファイルやバイトストリームに含まれる画像の種類（フォーマット）を判別するためのモジュールです。このモジュールには、画像タイプを判定する関数が1つだけ定義されています。

imghdr.what() 関数の基本構文

imghdr.what(filename, h=None)

この関数は、指定されたファイルに含まれる画像データを検査し、画像の種類を表す文字列を返します。

• filename: 判定対象の画像ファイル名を指定します。
• h： この引数が指定された場合、filenameは無視され、hで渡されたバイトストリームが検査対象となります。

imghdrが認識できる画像形式一覧

imghdrモジュールが判別可能な画像形式は以下のとおりです。

使用例

実際のコード例を見てみましょう。ファイル名を渡すだけで、対応する画像形式が文字列として返されます。

>>> import imghdr
>>> imghdr.what('bass.gif')
'gif'
>>> imghdr.what('polar.png')
'png'
>>> imghdr.what('test.jpg')
'jpeg'

注意点： imghdrは非推奨

imghdrモジュールはPython 3.11で非推奨（Deprecated）となり、Python 3.13で標準ライブラリから削除されました。新しいプロジェクトでは、サードパーティ製のPillowライブラリや、python-magicなどを使って画像形式を判定することを推奨します。

from PIL import Image

with Image.open('bass.gif') as img:
    print(img.format)  # 'GIF'

既存コードでimghdrを使い続ける場合は、対象のPythonバージョンに注意してください。