@suterma/nskeyedunarchiver-liveplayback

node-nskeyedunarchiver-liveplayback

A simple NSKeyedUnarchiver in Javascript, to unarchive iOS property lists. It is implemented and tested only to work with data from the LivePlayback iOS App.

Installation

    $ npm i @suterma/nskeyedunarchiver-liveplayback

Usage

This unarchiver processes property lists as provided e.g. by this bplist-parser

    import NSKeyedUnarchiver from "nskeyedunarchiver-liveplayback";
    const inputPropertyList ...; //as provided e.g. by bplist-parser
    var unarchivedObject = new NSKeyedUnarchiver().unarchive(inputPropertyList);
    console.log(unarchivedObject);

See demo.ts for a working example

Remarks / Limitations

This implementation has been specifically created for the above task, and is in no way a complete solution. Feel free to fork or suggest improvements.

• No support for circular references.
• The UID type is not implemented, the number type is used instead.
• Only some of the NS-types are implemented at this time, and some specific classes for the task at hand are additionally provided.

Credits

• This work is heavily based on a similar project for python. The limitations as stated here apply to the current state of this project.
• Ideas are also taken from the blog entry by https://digitalinvestigation.wordpress.com/2012/04/04/geek-post-nskeyedarchiver-files-what-are-they-and-how-can-i-use-them/
• See also the documentation from Apple: https://developer.apple.com/documentation/foundation/nskeyedunarchiver