Portable Pixmap MIME Type

What does image/ppm mean?

image/ppm is used by some software for a Portable Pixmap, or PPM, file. Pygame, for example, defines its SCRAP_PPM clipboard type as image/ppm for PPM-encoded image data.¹ PPM is the full-color member of the Netpbm family. It stores a rectangular grid of red, green, and blue samples with no transparency and no compression. Its simplicity makes it useful as an intermediate format, a test fixture, or the output of a small graphics program. It is usually a poor delivery format because the files are large and carry almost no descriptive metadata.²

The important caveat is that image/ppm is not registered with IANA. Netpbm documents image/x-portable-pixmap as the conventional media type, while image/x-portable-anymap can describe the broader PNM family.² The current IANA image registry has no ppm entry.³

The usual extension is .ppm. A generic .pnm filename can also contain PPM data, but it may instead contain PBM or PGM data, so the header is the reliable way to distinguish them.²⁴

How a PPM file is structured

A PPM image starts with an ASCII magic identifier:

After the identifier come the width, height, and a maximum sample value greater than zero and below 65,536. Comments can begin with # in the header. In raw P6, each pixel is an RGB triplet. Samples use one byte when the maximum value is below 256 and two big-endian bytes otherwise. In plain P3, the same values are written as decimal ASCII separated by whitespace.²

A tiny plain PPM can therefore be written without an image library:

P3
# two pixels: red, then blue
2 1
255
255 0 0   0 0 255

PPM permits more than one image in a stream. Older software may read only the first because the format allowed only one image before July 2000. Software written before April 2000 may also assume that raw samples are always one byte because the earlier maximum value was 255.²

Why PPM exists

Jef Poskanzer created PBM as a deliberately simple interchange format in the 1980s. He distributed the Pbmplus toolkit in 1988 and added the grayscale PGM and color PPM formats by the end of that year. Netpbm replaced Pbmplus in 1993 and continues the format and tool collection today.⁵

That history explains PPM's design. It favors an obvious, easily generated byte layout over compression, color-management features, or rich metadata. Netpbm itself describes PPM as highly redundant but easy to write and analyze.² This is why PPM still appears in graphics courses, ray tracers, rendering tests, Unix pipelines, and decoder fixtures even though it is uncommon as a finished asset.

Can browsers display image/ppm?

Do not rely on native browser display. MDN's current list of image types safe for ordinary web pages includes APNG, AVIF, GIF, JPEG, PNG, SVG, and WebP, but not PPM.⁶ Browser behavior can also depend on the declared media type and platform image services, which makes an accidental success a poor compatibility guarantee.

For a website, convert PPM to a widely supported format and send that format's registered media type. If a PPM must be downloadable, use the media type required by the receiving application and include a clear filename.

Desktop graphics tools are a better fit. Netpbm reads and writes PPM directly, while GIMP can import or export the PNM family and lets you choose ASCII or raw output for PPM.⁷

Support in Poly

Poly has a dedicated internal image/ppm identifier and treats it as an image when that type is already present. The image loader can decode standard PPM data, generate WebP thumbnails, extract dimensions, create a visual embedding, show the result in the image viewer, and provide a rendered thumbnail to the agent.

The current limitation is identification. Poly's filename inference table does not map .ppm, and the client MIME map gives image/ppm no default extension. A plain P3 file uploaded without a useful platform media type can be mistaken for text, while a raw P6 file can fall back to generic binary data. In either case, image thumbnails and visual indexing do not run.

When PPM is classified correctly:

• Search includes the filename, dimensions, and visual similarity.
• Words drawn inside the image are not OCR'd.
• Preview and agent reading use derived 8-bit WebP pixels, not the original PPM sample stream.
• A multi-image PPM stream should not be treated as a browsable image sequence. The normal image pipeline renders a single image.

Converting PPM to a practical format

Netpbm provides small conversion tools that work well in pipelines. For example:

pnmtopng input.ppm > output.png
jpegtopnm input.jpg > output.ppm

GIMP can also open or export PPM through its PNM support.⁷ Choose the destination according to the image:

• PNG preserves pixels losslessly and supports transparency and metadata.
• WebP or AVIF can reduce file size for web delivery.
• JPEG is broadly compatible for photographs but introduces lossy compression.
• PPM remains useful when the next program benefits from a trivial decoder or a streamable intermediate format.

Converting PPM to PNG is lossless when the PNG encoder preserves the represented RGB sample precision and color interpretation. Conversion does not solve every color issue, however. The PPM specification uses BT.709 transfer characteristics and D65 white, while many real-world files use sRGB or linear values without declaring that variation.² A converter cannot recover color semantics that the producer never recorded.

PPM, PGM, PBM, PAM, and PNG

These similarly named formats solve different problems:

PBM, PGM, and PPM are collectively called PNM. PAM is a later, more general Netpbm format that can represent the older visual types and additional channel layouts.⁴ PNG is unrelated despite the similar initials. It is normally the more practical choice for a lossless image that needs broad application and browser support.