#convert #human #human-readable #words #encode #readable

mnumonic

A tiny library to convert opaque binary data to and from a human-memorable phrase

2 unstable releases

0.2.0 Mar 1, 2020
0.1.0 Feb 10, 2020

#2247 in Encoding

0BSD license

8KB
84 lines

mnumonic

Build Status Crate

This is a tiny Rust library that allows you to convert binary byte data to and from a phrase that is memorable for a human. It is useful for cases where you need a human to transfer certain information (e.g. an opaque identifier) between systems where copy/paste may not be readily available. Instead of asking them to type in an opaque number like 3735928559, you can instead have them type in "sweet pump second tree".

Currently only English is supported, but the code is written to allow other languages too. PRs to add word files for other languages are welcome.

See API documentation at docs.rs for full details.

Example usage

use mnumonic;
let opaque_identifier : u32 = 0xDEADBEEF;
let human_readable = mnumonic::encode_u32_joined(opaque_identifier);
println!("Instead of remembering '{}' (difficult), you can remember '{}' (easier)", opaque_identifier, human_readable);
let back_to_identifier = mnumonic::decode_u32_joined(&human_readable).unwrap();
assert_eq!(opaque_identifier, back_to_identifier);

No runtime deps

Features