[[PageOutline]]

== This is a wiki page and it is being improved constantly, please link to the page not a revision of it! ==

Please make sure you don't link to old versions of this page. If you came here via a link check if there is a revision number in the address bar. If so, go to the [http://dev.openaos.org/wiki/aos-tools current version of this page]

== General Info ==
This is a suite of tools to deal with firmware update files for the gen6, gen7, gen8 ,gen9 and gen10 family of product. It will allow you to verify, decrypt, unpack and then put back together .aos containers. Additionally, it will deal with (verify and parse) various files often found inside these .aos containers, like segments of flash memory and cramfs files.
Original aos-tools can be found https://code.google.com/p/aos-tools/ this only supports until gen7. Since it is not longer maintained there is an uptodate git available at github https://github.com/trevd/aos-tools from trevd on xda see http://forum.xda-developers.com/showpost.php?p=34631348&postcount=6

== Building aos-tools from github ==


{{{
sudo apt-get install libssl-dev   #(if you have not already done it)
sudo apt-get install subversion   #(if you have not already done it)

git clone https://github.com/trevd/aos-tools.git aos-tools
cd aos-tools/libaos
make
cd ../tools
make
sudo cp aos-unpack /usr/local/bin/
}}}

== Unpacking the firmware ==

{{{
aos-unpack /<path to firmware file>/<firmware name>.aos
}}}

For example:


{{{
aos-unpack ~/Downloads/firmware_archos_android_gen8.aos
}}}

A new directory with the firmware name (in our example firmware_archos_android_gen8) is created in the directory in which you run the command from. In this directory are the extracted files.