mirror of
https://github.com/iluvcapra/wavinfo.git
synced 2025-12-31 08:50:41 +00:00
65 lines
2.7 KiB
Markdown
65 lines
2.7 KiB
Markdown
[](https://wavinfo.readthedocs.io/en/latest/?badge=latest)   [](https://pypi.org/project/wavinfo/) 
|
|
|
|
|
|
<!--  -->
|
|
|
|
# wavinfo
|
|
|
|
The `wavinfo` package allows you to probe WAVE and [RF64/WAVE files][eburf64] and extract extended metadata, with an emphasis on film, video and professional music production metadata.
|
|
|
|
`wavinfo` reads:
|
|
|
|
* __Broadcast-WAVE__ metadata<sup>[1][ebu]</sup>, including embedded program
|
|
loudness and coding history, if extant. This also includes the SMPTE UMID<sup>[2][smpte_330m2011]</sup>.
|
|
* __iXML__ production recorder metadata<sup>[3][ixml]</sup>, including project, scene, and take tags, recorder notes
|
|
and file family information.
|
|
* Most of the common __RIFF INFO__<sup>[4][info-tags]</sup> metadata fields.
|
|
* The __wav format__ is also parsed, so you can access the basic sample rate and channel count
|
|
information.
|
|
|
|
In progress:
|
|
* ADM metadata consilient with the output of the __Dolby RMU__, perhaps later fully complaint with [ITU BS.2076-2][adm].
|
|
* iXML `STEINBERG` sound library attributes.
|
|
* __NetMix__ library attributes.
|
|
* Pro Tools __embedded regions__.
|
|
|
|
[ebu]:https://tech.ebu.ch/docs/tech/tech3285.pdf
|
|
[adm]:https://www.itu.int/dms_pubrec/itu-r/rec/bs/R-REC-BS.2076-2-201910-I!!PDF-E.pdf
|
|
[smpte_330m2011]:http://standards.smpte.org/content/978-1-61482-678-1/st-330-2011/SEC1.abstract
|
|
[ixml]:http://www.ixml.info
|
|
[eburf64]:https://tech.ebu.ch/docs/tech/tech3306v1_1.pdf
|
|
[info-tags]:https://exiftool.org/TagNames/RIFF.html#Info
|
|
|
|
## Demonstration
|
|
|
|
The entry point for wavinfo is the WavInfoReader class.
|
|
|
|
```python
|
|
from wavinfo import WavInfoReader
|
|
|
|
path = '../tests/test_files/A101_1.WAV'
|
|
|
|
info = WavInfoReader(path)
|
|
```
|
|
|
|
The package also installs a shell command:
|
|
|
|
```sh
|
|
$ wavinfo test_files/A101_1.WAV
|
|
```
|
|
|
|
### Basic WAV Data
|
|
|
|
The length of the file in frames (interleaved samples) and bytes is available, as is the contents of the format chunk.
|
|
|
|
```python
|
|
(info.data.frame_count, info.data.byte_count)
|
|
>>> (240239, 1441434)
|
|
(info.fmt.sample_rate, info.fmt.channel_count, info.fmt.block_align, info.fmt.bits_per_sample)
|
|
>>> (48000, 2, 6, 24)
|
|
```
|
|
|
|
## Other Resources
|
|
|
|
* For other file formats and ID3 decoding, look at [audio-metadata](https://github.com/thebigmunch/audio-metadata).
|