Fast RFC 4648-compliant Base32 encoding

Version on this page:
LTS Haskell 22.23:0.4@rev:1
Stackage Nightly 2024-05-28:0.4@rev:1
Latest on Hackage:0.4@rev:1

See all snapshots base32 appears in

BSD-3-Clause licensed by Emily Pillmore
Maintained by [email protected]
This version can be pinned in stack with:base32-,2732


Build Status Hackage

Padded and unpadded base32 and base32hex encoding and decoding for Text and ByteString values.

For the companion optics and pattern synonyms, see base32-lens.


The following types are supported for both padded and unpadded std and extended hex alphabets:

  • Data.ByteString
  • Data.ByteString.Lazy
  • Data.ByteString.Short
  • Data.Text
  • Data.Text.Lazy
  • Data.Text.Short

Additionally this library has

  • Better performance than memory for encode and decode 3-4x.
  • Optics for handling more complex structures with Base32 representations via the base32-lens package
  • Checks for both validity and correctness of Base32 and Base32hex encodings

There are no dependencies aside from those bundled with GHC, text-short, and the ghc-byteorder re-export.


Revision history for base32

  • Bugfix: fix unpadded base32 encoding (#4)
  • Bugfix: Use decodeLatin1 when decoding, defer to decodeWith* primitives for finer-grained Text to ByteString conversions. (#5)
  • Add short and lazy variants for Text and ByteString (#6)
  • Expanded test coverage to 96% (#7)
  • Improved performance and better error reporting in final quanta (#9)
  • Improved docs + trustworthy/safe annotations (#10) – 2020-02-16

  • Documentation now references correct RFC section

0.1.1 – 2020-02-16

  • Textual interface now uses correct unpadded version – 2020-02-16

  • First version. Released on an unsuspecting world.