npkPy is an unpacker tool for MikroTiks custom npk container format


Keywords
mikrotik, npk, unpacker
License
AGPL-3.0
Install
pip install npkPy==2021.10.22.15.58

Documentation

Actions Status codecov

npkPy

The npkPy package module is an unpacking tool for MikroTiks custom NPK container format. The tool is capable to display the content of any NPK package and to export all container.

"NPK stands for MikroTik RouterOS upgrade package" and since there is no solid unpacking tool for the format available, I want to share my approach of it. The format, in general, is used by MikroTik to install and update the software on MikroTiks routerOs systems.

NPK packages can be found here: MikroTik Archive

The code covers the ability to modify the container payload. Yet, this ability won't be available for cli. Please be aware, that you can't create or modify valid packages since they are signed.

All recent packages are signed with EC-KCDSA signature, 
and there's no way to create a valid npk file unless you know a secret key.

Installation

pip install npkPy

Usage

$ npkPy is an unpacking tool for MikroTiks custom NPK container format

optional arguments:
  -h, --help            show this help message and exit

input:
  --files FILES         Select one or more files to process
  --srcFolder SRCFOLDER
                        Process all NPK files found recursively in given source folder.
  --glob GLOB           Simple glob. Filter files from --srcFolder which match the given string.

output:
  --dstFolder DSTFOLDER
                        Extract container into given folder

actions:
  --showContainer       List all container from selected NPK files
  --exportAll           Export all container from selected NPK files
  --exportSquashFs      Export all SquashFs container from selected NPK files
  --exportZlib          Export all Zlib compressed container from selected NPK files

Common understanding: A file represents an NPK package with multiple containers. Each container 'contains' payloads like descriptions, SquashFs images or Zlib compressed data.

Other unpacking tools

If npkPy does not work for you, check out older approaches of NPK unpacking tools: