App Bundle Format

“Apps” on Pocketbyte are very similar to “app bundles” on macOS. Each Pocketbyte application is simply a folder with a few related files—no special formats are used.

Bundle Structure

info.json

image.bin

program.bin

<author>.<title> is the grouping folder named after the unique ID of the application.
info.json is a manifest file that contains all of app’s metadata, such as author, version, genre, and more.
image.bin is the 64x64 icon image, formatted in RGB565. It’s good practice to include the raw PNG image too, just so that you can view it on your computer.
program.bin is the app’s executable.

Info JSON

The format for info.json is very simple.

{
    "id": "<author>.<title>",
    "title": "Title",
    "description": "Description",
    "genre": "Genre",
    "version": "Major.Minor.Patch",
    "author": "Author",
    "date": "YYYY-MM-DD",
    "binary": "program.bin",
    "image": "image.bin"
}

Example

bobthecoder.cool-platformer

CoolPlatformer.png

info.json

image.bin

program.bin

{
    "id": "bobthecoder.cool-platformer",
    "title": "Cool Platformer",
    "description": "The coolest platformer game you will ever play!",
    "genre": "Action",
    "version": "1.0.2",
    "author": "bobthecoder",
    "date": "2026-07-01",
    "binary": "program.bin",
    "image": "image.bin"
}

Get Started

Packaging Apps

Misc

Help

Bundle Structure

Info JSON

Example

​Bundle Structure

​Info JSON

​Example

Bundle Structure

Info JSON

Example