A library providing packing of files into runtime reading optimized archives, across different platforms.
For example can be used to load game resources. (images, shaders, models, levels, etc...)

See the documentation.

• Compressed file pack creation
• Runtime optimized file pack reading
• Automatic file data deduplication
• Maximum ZSTD compression level
• Customisable compression threshold
• C and C++ implementations

void packReaderExampleCPP()
{
    pack::Reader packReader("resources.pack");
    auto itemIndex = packReader.getItemIndex("textures/sky.png");
    std::vector<uint8_t> itemData;
    packReader.readItemData(itemIndex, itemData);
    // use data...
}

void packReaderExampleC()
{
    PackReader packReader = NULL;
    PackResult packResult = createFilePackReader("resources.pack", false, 1, &packReader);
    if (packResult != SUCCESS_PACK_RESULT) abort();

    uint64_t itemIndex = 0;
    bool result = getPackItemIndex(packReader, "textures/sky.png")
    if (!result) abort();

    uint32_t dataSize = getPackItemDataSize(packReader, itemIndex);
    uint8_t* itemData = (uint8_t*)malloc(dataSize);
    if (!itemData) abort();

    packResult = readPackItemData(packReader, itemIndex, itemData, 0)
    if (packResult != SUCCESS_PACK_RESULT) { free(data); abort(); }

    // use data...
    destroyPackReader(packReader);
}

• Windows
• macOS
• Ubuntu (Linux)

• C99 compiler
• C++17 compiler (optional)
• Git 2.30+
• CMake 3.16+

Use building instructions to install all required tools and libraries.

git clone --recursive https://github.com/cfnptr/pack

• Windows: ./scripts/build-release.bat
• macOS / Ubuntu: ./scripts/build-release.sh

Creates compressed data pack from files.

• Usage: packer <pack-path> <file-path-1> <item-path-1>...
• Example: packer resources.pack C:/Users/user/Desktop/sky.png images/sky.png

Extracts compressed data pack files.

• Usage: unpacker <pack-path>
• Example: unpacker resources.pack

Shows pack file information.

• Usage: pack-info <pack-path>
• Example: pack-info resources.pack

• mpio (Apache-2.0 License)
• zstd (BSD License)