← All commands
THE COMMAND REFERENCE

base64

Encode data as text, or decode it back.

Last updated

Portable / common

Implementation-level reference; examples are not certified for every installed version.

Overview

base64 turns any data into plain letters, digits, +, / and =, so binary content can travel through systems that only handle text, such as email or a JSON field. With -d it turns that text back into the original data. It is an encoding, not encryption: anyone can decode it.

Background

Base64 is the encoding described in RFC 4648. Today the name covers GNU base64, the base64 that macOS ships, and the base64 applet in BusyBox. They agree on encoding standard input and on -d for decoding.

Examples

Encode some text:

printf hello | base64

Decode it back with -d:

printf aGVsbG8= | base64 -d

Encode a file, and decode the result into a new file. The file is read from standard input, because macOS base64 has no plain file argument:

printf hello > in.txt && base64 < in.txt > in.b64 && base64 -d < in.b64 > out.txt && cat out.txt

Check that decoding undoes encoding for text with a newline:

printf 'a\nb\n' | base64 | base64 -d

Options

-d
Decode instead of encode. Older macOS releases spell it -D.

Common mistakes

Base64 is not secret: use real encryption for secrets. echo text | base64 encodes the newline that echo adds, so the result differs from printf text | base64. Output line wrapping differs between implementations (see below), which matters when a program expects one line. The standard alphabet uses + and /; the URL-safe form uses - and _ and needs extra steps.

Portability

Only encoding, -d and short inputs are in the Common examples, which fit on one line on every implementation. GNU and BusyBox wrap long output at 76 characters and macOS does not. The Common examples were executed on GNU coreutils 9.11, macOS system tools, and BusyBox 1.37.0 (see the development guide for the exact check).

References

Original explanations, with upstream documentation for further reading. FreeBSD references are comparison material, not a claim of Apple version equivalence.