-[](https://ci.appveyor.com/project/scurest/apicula)
-[](https://github.com/Aaronepower/tokei)
+-----
-Convert Nintendo DS models and animations to COLLADA.
-
-The [Nitro file
-formats](https://wiki.vg-resource.com/wiki/Nintendo_DS#NITRO_File_Formats) were
-the formats for Nintendo's SDK for DS game developers and were used by many DS
-games. This tool is for dealing with Nitro models (NSBMD files), viewing them,
-and converting them to COLLADA .dae files. There is also support for loading
-textures (NSBTX) and animations (NSBCA).
-
-
+Many Nintendo DS games used [Nitro
+files](https://wiki.vg-resource.com/wiki/Nintendo_DS#NITRO_File_Formats) for
+assets, like NSBMD files for 3D models. apicula can extract these models and
+their associated textures and animations from a ROM or memory dump, display them
+in its model viewer, and convert them to the common 3D formats COLLADA and glTF
+for importing into content-creation tools like Blender.
* [Tutorial](https://github.com/scurest/apicula/wiki/TUTORIAL)
* [Hallow's tutorial on VG Resource](https://www.vg-resource.com/thread-32332.html)
* [Common Blender issues](https://github.com/scurest/apicula/wiki/BLENDER)
-## Downloads
+### Downloads
Pre-built binaries are provided for Windows:
-* [apicula-latest-x86_64-pc-windows-msvc](https://s3.amazonaws.com/apicula/apicula-latest-x86_64-pc-windows-msvc.zip) (Windows, 64-bit)
-* [apicula-latest-i686-pc-windows-msvc](https://s3.amazonaws.com/apicula/apicula-latest-i686-pc-windows-msvc.zip) (Windows, 32-bit)
+* [apicula for Windows, 64-bit](https://s3.amazonaws.com/apicula/apicula-latest-x86_64-pc-windows-msvc.zip)
+* [apicula for Windows, 32-bit](https://s3.amazonaws.com/apicula/apicula-latest-i686-pc-windows-msvc.zip)
These are built automatically off the latest `master`. You may need one of the Visual Studio
Redistributable packages installed.
-## Building
+### Building
-Building is done in the usual way for Rust projects. See [BUILDING.md](BUILDING.md).
+Make sure [Rust is installed](https://rustup.rs/) and [build the usual way](https://doc.rust-lang.org/cargo/guide/working-on-an-existing-project.html)
+
+ $ git clone https://github.com/scurest/apicula.git
+ $ cd apicula
+ $ cargo b --release
+ $ target/release/apciula -V
-## Usage
+### Usage
-To view a set of models
+To search a ROM or other packed file for Nitro files and extract them
+
+ apicula extract -o