Pythonのsndhdrモジュールでサウンドファイルの種類を判別する方法

Pythonの標準ライブラリに含まれるsndhdrモジュールは、ファイル内に格納されたサウンドデータの種類を読み取るためのユーティリティ関数を提供します。これらの関数は、以下の5つの属性を持つnamedtuple()オブジェクトを返します。

sndhdrモジュールの主な関数

sndhdr.what()

この関数は、内部でwhathdr()を呼び出すことで、指定したファイルfilenameに格納されたサウンドデータの種類を判別します。判別に成功した場合は前述のnamedtupleを返し、失敗した場合はNoneを返します。

sndhdr.whathdr()

この関数は、ファイルヘッダーの情報をもとに、そのファイルに格納されたサウンドデータの種類を判別します。成功した場合は前述のnamedtupleを返し、失敗した場合はNoneを返します。

使用例

実際にWAV、AIFF、AU形式のファイルに対してwhathdr()を実行すると、以下のように各属性の値を確認できます。

>>> import sndhdr
>>> sndhdr.whathdr("sample.wav")
SndHeaders(filetype='wav', framerate=44100, nchannels=1, nframes=99999, sampwidth=16)
>>> sndhdr.whathdr("sample.aiff")
SndHeaders(filetype='aiff', framerate=8000, nchannels=1, nframes=271200, sampwidth=16)
>>> sndhdr.whathdr("sample.au")
SndHeaders(filetype='au', framerate=8000, nchannels=1, nframes=103397.0, sampwidth='U')

注意点：非推奨化について

sndhdrモジュールはPython 3.11で非推奨（Deprecated）となり、Python 3.13では標準ライブラリから削除されました。最新のPython環境で同様の処理を行いたい場合は、python-magicやfiletypeなどの外部ライブラリを利用するか、ファイルシグネチャ（マジックナンバー）を直接読み取って判別する方法を検討してください。