Overview

A library for generating IDs that are shared verbally or via printed media.

Use cases

• Order IDs on documents that are printed, e.g. in transportation
• Onine game IDs that are shared via text or verbally in a group, e.g. Among Us game codes
• One-time invite codes

Features

• Does not use ambiguous symbols
• Auto-correct common mistakes (mistype or misheard)

For ID being printed and read

Does not use characters that can be misread as numbers

Letter	Number
T	7
O	0
B	8
I	1

For ID being shared verbally

Does not use Q or W, since they are easy to be misheard

Error-correction

Fix function will replace not used chars with their probable origins

Char	Replaced with
T	7
O	0
B	8
I	1
Q	0

Usage

const hfid = require('hfid');

// Generate a random ID
var id = hfid.random(6);

// Fixing user input
var fixedId = hfid.fix('ARTBI'); // returns 'AR781'