z440.atl.core 3.0.0

Fully managed, portable and easy-to-use C# library to read and edit audio data and metadata (tags) from various audio formats, playlists and CUE sheets

There is a newer version of this package available.
See the version list below for details.
Install-Package z440.atl.core -Version 3.0.0
dotnet add package z440.atl.core --version 3.0.0
<PackageReference Include="z440.atl.core" Version="3.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add z440.atl.core --version 3.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: z440.atl.core, 3.0.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install z440.atl.core as a Cake Addin
#addin nuget:?package=z440.atl.core&version=3.0.0

// Install z440.atl.core as a Cake Tool
#tool nuget:?package=z440.atl.core&version=3.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

v3.00 (2020/02/16)

PLEASE NOTE THAT .NET FRAMEWORK 3.0 SUPPORT IS DROPPED.

ATL NOW DEPENDS ON .NET FRAMEWORK 4.5

New

  • ATL can now send feedback about writing progress through IProgress. See sample code for more information.
  • New ATL.Version.getVersion method to get ATL's current version programmatically
  • ID3v2 : New Settings.ID3v2_forceAPICEncodingToLatin1 to control the format of picture descriptions. It defaults to true because Latin-1 which is a pre-requisite for Windows to display images as covers.
  • ID3v2 : New Settings.ID3v2_forceUnsynchronization to force unsynchronization when writing ID3v2 tags (default : off)
  • MP4/M4A : Support for unsynchronized lyrics
  • MP4/M4A : Support for non-interleaved Quicktime chapters
    • New setting MP4_createNeroChapters to force writing Nero chapters to MP4/M4A files
    • New setting MP4_createQuicktimeChapters to force writing Quicktime chapters to MP4/M4A files
    • New setting MP4_keepExistingChapters to force keep existing chapters in MP4/M4A files, regardless of the other chapter creation options

Fixes

  • General : Saving a Track after calling Track.Chapters.Clear does clear all chapters
  • General : Calling Track.EmbeddedPictures after setting values doesn't reset these values anymore
  • ID3v2 : Embedded pictures now appear as icons when viewing the file in Windows explorer
  • MP4/M4A : Artist field is now saved with the proper field code and is readable by 3rd part software
  • MP4/M4A : Prevents file corruption when writing data in certains scenarios
  • MP4/M4A : It is now possible to create metadata from scratch when the file does not have any meta atom
  • MP4/M4A : It is now possible to create Nero chapters from scratch when the file does not have any chpl atom
  • MP4/M4A : Nero Chapters timestamps > 10 minutes are now written properly

! Breaking changes to interface !

  • Obsolete MetaDataIO.PictureStreamHandler field has been completely removed
  • Obsolete Track.Rating field has been completely removed
  • Obsolete IPlaylistReader and PlaylistReaderFactory classes have been completely removed
  • PictureInfo constructors do not take any ImageFormat argument anymore. Use new PictureInfo.fromBinaryData static constructor to directly load binary data and auto-detect image format

For instance, instead of doing this

PictureInfo newPicture = new PictureInfo(Commons.ImageFormat.Gif, PictureInfo.PIC_TYPE.CD);
newPicture.PictureData = System.IO.File.ReadAllBytes("E:/temp/_Images/pic1.gif");

you should now do this

byte[] data = System.IO.File.ReadAllBytes("E:/temp/_Images/pic1.gif");
PictureInfo newPicture = PictureInfo.fromBinaryData(data, PictureInfo.PIC_TYPE.CD);

v3.00 (2020/02/16)

PLEASE NOTE THAT .NET FRAMEWORK 3.0 SUPPORT IS DROPPED.

ATL NOW DEPENDS ON .NET FRAMEWORK 4.5

New

  • ATL can now send feedback about writing progress through IProgress. See sample code for more information.
  • New ATL.Version.getVersion method to get ATL's current version programmatically
  • ID3v2 : New Settings.ID3v2_forceAPICEncodingToLatin1 to control the format of picture descriptions. It defaults to true because Latin-1 which is a pre-requisite for Windows to display images as covers.
  • ID3v2 : New Settings.ID3v2_forceUnsynchronization to force unsynchronization when writing ID3v2 tags (default : off)
  • MP4/M4A : Support for unsynchronized lyrics
  • MP4/M4A : Support for non-interleaved Quicktime chapters
    • New setting MP4_createNeroChapters to force writing Nero chapters to MP4/M4A files
    • New setting MP4_createQuicktimeChapters to force writing Quicktime chapters to MP4/M4A files
    • New setting MP4_keepExistingChapters to force keep existing chapters in MP4/M4A files, regardless of the other chapter creation options

Fixes

  • General : Saving a Track after calling Track.Chapters.Clear does clear all chapters
  • General : Calling Track.EmbeddedPictures after setting values doesn't reset these values anymore
  • ID3v2 : Embedded pictures now appear as icons when viewing the file in Windows explorer
  • MP4/M4A : Artist field is now saved with the proper field code and is readable by 3rd part software
  • MP4/M4A : Prevents file corruption when writing data in certains scenarios
  • MP4/M4A : It is now possible to create metadata from scratch when the file does not have any meta atom
  • MP4/M4A : It is now possible to create Nero chapters from scratch when the file does not have any chpl atom
  • MP4/M4A : Nero Chapters timestamps > 10 minutes are now written properly

! Breaking changes to interface !

  • Obsolete MetaDataIO.PictureStreamHandler field has been completely removed
  • Obsolete Track.Rating field has been completely removed
  • Obsolete IPlaylistReader and PlaylistReaderFactory classes have been completely removed
  • PictureInfo constructors do not take any ImageFormat argument anymore. Use new PictureInfo.fromBinaryData static constructor to directly load binary data and auto-detect image format

For instance, instead of doing this

PictureInfo newPicture = new PictureInfo(Commons.ImageFormat.Gif, PictureInfo.PIC_TYPE.CD);
newPicture.PictureData = System.IO.File.ReadAllBytes("E:/temp/_Images/pic1.gif");

you should now do this

byte[] data = System.IO.File.ReadAllBytes("E:/temp/_Images/pic1.gif");
PictureInfo newPicture = PictureInfo.fromBinaryData(data, PictureInfo.PIC_TYPE.CD);

Release Notes

__v3.00 (2020/02/16)__

_**PLEASE NOTE THAT .NET FRAMEWORK 3.0 SUPPORT IS DROPPED.**_

_**ATL NOW DEPENDS ON .NET FRAMEWORK 4.5**_

_New_
- ATL can now send feedback about writing progress through `IProgress`. See [sample code](https://github.com/Zeugma440/atldotnet/wiki/3.-Usage-_-Code-snippets#progress) for more information.
- New `ATL.Version.getVersion` method to get ATL's current version programmatically
- ID3v2 : New `Settings.ID3v2_forceAPICEncodingToLatin1` to control the format of picture descriptions. It defaults to `true` because Latin-1 which is a pre-requisite for Windows to display images as covers.
- ID3v2 : New `Settings.ID3v2_forceUnsynchronization` to force unsynchronization when writing ID3v2 tags (default : off)
- MP4/M4A : Support for unsynchronized lyrics
- MP4/M4A : Support for non-interleaved Quicktime chapters
 - New setting `MP4_createNeroChapters` to force writing Nero chapters to MP4/M4A files
 - New setting `MP4_createQuicktimeChapters` to force writing Quicktime chapters to MP4/M4A files
 - New setting `MP4_keepExistingChapters` to force keep existing chapters in MP4/M4A files, regardless of the other chapter creation options

_Fixes_
- General : Saving a `Track` after calling `Track.Chapters.Clear` does clear all chapters
- General : Calling `Track.EmbeddedPictures` after setting values doesn't reset these values anymore
- ID3v2 : Embedded pictures now appear as icons when viewing the file in Windows explorer
- MP4/M4A : Artist field is now saved with the proper field code and is readable by 3rd part software
- MP4/M4A : Prevents file corruption when writing data in certains scenarios
- MP4/M4A : It is now possible to create metadata from scratch when the file does not have any `meta` atom
- MP4/M4A : It is now possible to create Nero chapters from scratch when the file does not have any `chpl` atom
- MP4/M4A : Nero Chapters timestamps > 10 minutes are now written properly

_**! Breaking changes to interface !**_
* Obsolete `MetaDataIO.PictureStreamHandler` field has been completely removed
* Obsolete `Track.Rating` field has been completely removed
* Obsolete `IPlaylistReader` and `PlaylistReaderFactory` classes have been completely removed
* `PictureInfo` constructors do not take any `ImageFormat` argument anymore. Use new `PictureInfo.fromBinaryData` static constructor to directly load binary data and auto-detect image format

For instance, instead of doing this

```csharp
PictureInfo newPicture = new PictureInfo(Commons.ImageFormat.Gif, PictureInfo.PIC_TYPE.CD);
newPicture.PictureData = System.IO.File.ReadAllBytes("E:/temp/_Images/pic1.gif");
```

you should now do this

```csharp
byte[] data = System.IO.File.ReadAllBytes("E:/temp/_Images/pic1.gif");
PictureInfo newPicture = PictureInfo.fromBinaryData(data, PictureInfo.PIC_TYPE.CD);
```

  • .NETCoreApp 2.0

    • No dependencies.
  • .NETFramework 4.5

    • No dependencies.
  • .NETStandard 2.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on z440.atl.core:

Package Downloads
FRESHMusicPlayer.Core
Package Description

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on z440.atl.core:

Repository Stars
audiamus/AaxAudioConverter
Convert Audible aax files to mp3 and m4a/m4b

Version History

Version Downloads Last updated
3.22.0 307 5/27/2021
3.21.0 76 5/26/2021
3.20.0 728 4/12/2021
3.19.0 355 4/5/2021
3.18.0 1,348 2/8/2021
3.17.0 418 1/27/2021
3.16.0 132 1/14/2021
3.15.0 676 12/4/2020
3.14.0 318 11/22/2020
3.13.0 418 10/27/2020
3.12.0 272 10/19/2020
3.11.0 1,059 9/19/2020
3.10.0 493 9/12/2020
3.9.0 371 9/6/2020
3.8.0 291 8/31/2020
3.7.0 664 8/10/2020
3.6.0 1,282 6/28/2020
3.5.0 439 5/22/2020
3.4.1 406 5/5/2020
3.4.0 197 5/5/2020
3.3.0 897 3/29/2020
3.2.0 280 3/19/2020
3.1.0 462 2/17/2020
3.0.0 302 2/16/2020
2.16.0 1,341 1/10/2020
2.15.0 289 12/18/2019
2.14.0 424 11/24/2019
2.13.0 593 9/23/2019
2.12.0 548 7/26/2019
2.11.0 464 6/10/2019
2.10.0 331 5/22/2019
2.9.0 507 4/30/2019
2.8.0 341 4/4/2019
2.7.0 307 3/21/2019
2.6.0 310 3/10/2019
2.5.0 802 9/2/2018
2.4.2 736 6/23/2018
2.4.1 537 6/18/2018
2.4.0 504 6/15/2018
2.3.0 730 1/7/2018
2.2.1 718 11/18/2017
2.2.0 729 11/18/2017
2.1.0 763 10/22/2017
2.0.1 529 9/24/2017
Show less