Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 

README.md

libamiibo

amiibo™ parsing library

Usage

libamiibo expects a binary dump. It will not work with XMLs or hexadecimal text files. See the unix program xxd to convert from hexadecimal to binary.

It offers support for encryption/decryption, figurine data, amiibo settings and AppData.

To parse a tag directly from a binary (encrypted) dump, use LibAmiibo.Data.AmiiboTag.FromNtagData().

When using an encrypted binary, the AmiiboSettings and AppData information will not contain any valid information.

Examples

  • Decrypting a NTAG215 dump "mario.bin" with the "retail.bin" keys: Configure the paths for AmiiboKeys and CDNKeys in libamiibo.dll.config to direct to your key files.
byte[] encryptedNtagData = System.IO.File.ReadAllBytes("mario.bin");
LibAmiibo.Data.AmiiboTag amiiboTag = LibAmiibo.Data.AmiiboTag.DecryptWithKeys(encryptedNtagData);
  • Parsing a NTAG215 dump "mario.bin" only for the non-encrypted information:
byte[] encryptedNtagData = System.IO.File.ReadAllBytes("mario.bin");
LibAmiibo.Data.AmiiboTag amiiboTag = LibAmiibo.Data.AmiiboTag.FromNtagData(encryptedNtagData);

Notice

The library is split into two parts: libamiibo and libamiibo.images

You can use both independently:

  • To only use the parsing logic, it's enough to include the small libamiibo.dll and it's dependency BouncyCastle.Crypto.dll in your project and reference libamiibo.dll
  • To also include images for the amiibos (using amiiboTag.Amiibo.AmiiboImage), you need also include libamiibo.images.dll in your project. You don't need to reference it, just make sure the dll is copied

Special Thanks

About

C# library for working with amiibos

Resources

License

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  
You can’t perform that action at this time.