Wox-launcher/Wox · error · SystemExit

PNG header is missing

Error message

PNG header is missing

What it means

Error "PNG header is missing" thrown in Wox-launcher/Wox.

Source

Thrown at assets/generate_app_icons.sh:108

        offset += 4

        if kind == b"IHDR":
            width, height, bit_depth, color_type, compression, filter_method, interlace = struct.unpack(">IIBBBBB", payload)
            if bit_depth != 8:
                raise SystemExit("Only 8-bit PNG files are supported")
            if compression != 0 or filter_method != 0 or interlace != 0:
                raise SystemExit("Only non-interlaced standard PNG files are supported")
        elif kind == b"PLTE":
            palette = [tuple(payload[index : index + 3]) for index in range(0, len(payload), 3)]
        elif kind == b"tRNS":
            transparency = payload
        elif kind == b"IDAT":
            idat.extend(payload)
        elif kind == b"IEND":
            break

    if width is None or height is None or color_type is None:
        raise SystemExit("PNG header is missing")

    channels_by_type = {0: 1, 2: 3, 3: 1, 4: 2, 6: 4}
    if color_type not in channels_by_type:
        raise SystemExit(f"Unsupported PNG color type: {color_type}")
    if color_type == 3 and palette is None:
        raise SystemExit("Palette PNG is missing PLTE chunk")

    channels = channels_by_type[color_type]
    row_bytes = width * channels
    raw = zlib.decompress(bytes(idat))
    rgba = bytearray(width * height * 4)
    previous = bytearray(row_bytes)
    source_offset = 0
    target_offset = 0

    for _ in range(height):
        filter_type = raw[source_offset]
        source_offset += 1

View on GitHub (pinned to 1659730fcb)

When it happens

Trigger: Thrown at assets/generate_app_icons.sh:108 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Wox-launcher/Wox@1659730fcb (2026-08-15). Data as JSON: /api/errors/530b5b0157628c9f. Report an issue: GitHub.