2021-04-03 00:50:28 +00:00
|
|
|
# Lofty
|
2021-04-23 13:27:16 +00:00
|
|
|
[](https://github.com/Serial-ATA/lofty-rs/actions/workflows/ci.yml)
|
2021-04-23 22:12:55 +00:00
|
|
|
[](https://crates.io/crates/lofty)
|
|
|
|
|
[](https://crates.io/crates/lofty)
|
2021-04-23 02:11:04 +00:00
|
|
|
[](https://docs.rs/lofty/)
|
2020-10-25 16:29:14 +00:00
|
|
|
|
2021-04-04 03:11:35 +00:00
|
|
|
This is a fork of [Audiotags](https://github.com/TianyiShi2001/audiotags), adding support for more file types and (optionally) duration.
|
2020-10-27 02:08:05 +00:00
|
|
|
|
2021-04-04 03:11:35 +00:00
|
|
|
Parse, convert, and write metadata to audio files of different file types.
|
2020-10-27 02:08:05 +00:00
|
|
|
|
2021-04-04 03:11:35 +00:00
|
|
|
**Lofty** aims to provide a unified trait for parsers and writers of different audio file formats.
|
|
|
|
|
Without this crate, you would otherwise need to learn the different APIs in **id3**, **mp4ameta**, etc.
|
|
|
|
|
in order to parse metadata in different file formats.
|
2020-10-27 02:08:05 +00:00
|
|
|
|
2021-04-04 03:15:06 +00:00
|
|
|
## Supported Formats
|
2020-10-25 21:39:38 +00:00
|
|
|
|
2021-05-16 04:44:05 +00:00
|
|
|
| File Format | Extensions | Read | Write | Duration | Metadata Format(s) |
|
|
|
|
|
|-------------|-------------------------------------------|------|-------|----------|----------------------|
|
|
|
|
|
| Ape | `ape` |**X** |**X** | | `APEv2` |
|
|
|
|
|
| AIFF | `aiff`, `aif` |**X** |**X** | | `ID3v2` |
|
|
|
|
|
| FLAC | `flac` |**X** |**X** | | `Vorbis Comments` |
|
|
|
|
|
| MP3 | `mp3` |**X** |**X** |**X** | `ID3v2` |
|
|
|
|
|
| MP4 | `mp4`, `m4a`, `m4b`, `m4p`, `m4v`, `isom` |**X** |**X** | | `Vorbis Comments` |
|
|
|
|
|
| Opus | `opus` |**X** |**X** | | `Vorbis Comments` |
|
|
|
|
|
| Ogg | `ogg`, `oga` |**X** |**X** | | `Vorbis Comments` |
|
|
|
|
|
| WAV | `wav`, `wave` |**X** |**X** | | `RIFF INFO`, `ID3v2` |
|
2020-10-25 21:39:38 +00:00
|
|
|
|
2021-04-04 03:15:06 +00:00
|
|
|
## Documentation
|
2021-04-21 18:48:45 +00:00
|
|
|
|
2021-04-04 03:15:06 +00:00
|
|
|
Available [here](https://docs.rs/lofty)
|
|
|
|
|
|
2021-04-21 18:48:45 +00:00
|
|
|
## Thanks
|
|
|
|
|
|
|
|
|
|
All these great projects helped make this crate possible. (*Sorted alphabetically*)
|
|
|
|
|
|
|
|
|
|
* [**ape**](https://github.com/rossnomann/rust-ape)
|
|
|
|
|
* [**id3**](https://github.com/polyfloyd/rust-id3)
|
|
|
|
|
* [**lewton**](https://github.com/RustAudio/lewton)
|
|
|
|
|
* [**metaflac**](https://github.com/jameshurst/rust-metaflac)
|
|
|
|
|
* [**mp4ameta**](https://github.com/Saecki/rust-mp4ameta)
|
|
|
|
|
* [**ogg**](https://github.com/RustAudio/ogg)
|
|
|
|
|
* [**opus_headers**](https://github.com/zaethan/opus_headers)
|
|
|
|
|
* [**riff**](https://github.com/frabert/riff)
|
|
|
|
|
|
2021-04-04 03:11:35 +00:00
|
|
|
## License
|
|
|
|
|
|
|
|
|
|
Licensed under either of
|
|
|
|
|
|
|
|
|
|
* Apache License, Version 2.0
|
|
|
|
|
([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
|
|
|
|
|
* MIT license
|
|
|
|
|
([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
|
|
|
|
|
|
|
|
|
|
at your option.
|
|
|
|
|
|
|
|
|
|
## Contribution
|
2020-10-25 16:29:14 +00:00
|
|
|
|
2021-04-04 03:11:35 +00:00
|
|
|
Unless you explicitly state otherwise, any contribution intentionally submitted
|
|
|
|
|
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
|
|
|
|
|
dual licensed as above, without any additional terms or conditions.
|
