predeftool

Work-in-progress tool for bulk extracting preinstalled content from Nokia firmware packages.

This collection of scripts is used to create predefrepo (MEGA mirror), a repository of preinstalled games, apps, and themes found on various Nokia phones.

Status

• Most GSM S40 (DCT4 and BB5) phones should be supported. BB5 support is experimental.
• S40v1 phones use a custom filesystem (PPM), which is not supported right now, but it seems to be relatively simple.
• DCT4.5 (TIKU) phones like the 6230 use a different image format (but the underlying file system is standard FAT16), so they shouldn't be too difficult to support.
• See the spreadsheet of supported models.

Usage

As the tool is primarily developed on Linux, support for other operating systems is untested and unlikely.

Prerequisites

• Python 3
• Wine
• IsXunpack
• unshield

Steps

1. Clone the repository.
2. Download Universal Extractor. Make sure to pick the binary archive. Note that there is a newer project called UniExtract2 which will not work for this use case.
3. Extract the UniExtract archive and copy IsXunpack.exe from the bin folder to the predeftool root folder.
4. Download firmware package EXEs (see Useful links below) and put them in the packages folder.
5. To extract content from the installer EXEs, run ./main.sh. Content is placed into the content folder.
6. To create an index of all apps, games, and themes, run python index.py content index.json.
7. To create a sorted archive of all apps, games, and themes listed in the index, run python sort.py index.json. The sorted content is placed into the sorted folder.

Advanced usage

• ./main.sh clean - deletes all temporary files used for extraction, but keeps packages and extracted content
• ./main.sh mount /path/to/image.img - mounts a file system image in the same way that the tool does
• ./main.sh unmount - unmounts any temporary file systems used by the tool, useful in the case of an error, or when using the mount command
• python extract.py /path/to/image - converts a Nokia image file into a FAT16 filesystem image, outputs to /path/to/image.img

Known issues

• When extracting, you will get a "no such file or directory" warning about a "ucp" or "image" folder, this is normal.
• "we got fault packet with status 0x1c010003" is a normal warning message produced by Wine and does not affect extraction.

Useful links

• PhoneTones, an existing repository of ringtones
• Nokia DCT4 firmware packages
• Nokia BB5 firmware packages

Thanks

I would like to thank the following people for helping with this project:

• laissez6 for finding a way to extract newer DotNetInstaller firmware packages
• The ROMphonix project for hosting predefrepo