Wox-launcher/Wox · error · SystemExit

assets/app.png must be square

Error message

assets/app.png must be square

What it means

Error "assets/app.png must be square" thrown in Wox-launcher/Wox.

Source

Thrown at assets/generate_app_icons.sh:303

                        clamp_byte(blue / alpha),
                        clamp_byte(alpha * 255),
                    )
                )
            output_offset += 4

    return output


def write_file(path, data):
    os.makedirs(os.path.dirname(path), exist_ok=True)
    with open(path, "wb") as handle:
        handle.write(data)
    log(f"wrote {rel(path)}")


source_width, source_height, source_rgba = decode_png(source_png)
if source_width != source_height:
    raise SystemExit("assets/app.png must be square")

png_cache = {}


def app_icon_png(size):
    if size not in png_cache:
        log(f"resize {source_width}x{source_height} -> {size}x{size}")
        png_cache[size] = encode_png(size, size, resize_rgba(source_rgba, source_width, source_height, size, size))
    return png_cache[size]


def save_png(path, size):
    write_file(path, app_icon_png(size))


def save_ico(path, sizes):
    # Store PNG frames inside the ICO so Windows can choose the nearest native size.
    frames = [(size, app_icon_png(size)) for size in sizes]

View on GitHub (pinned to 1659730fcb)

When it happens

Trigger: Thrown at assets/generate_app_icons.sh:303 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/c42d91aaf39e77cd. Report an issue: GitHub.