README
¶
Bytesmap emoji encoding 
The package bytesmap can be used to encode strings into emojis. Can be used to "humanize" hard to remember/recognize texts such as Hashes, keys, other encodes like base64, ip's and so on.
Depending on the text the result may have fewer characters, but definately will have more bytes in length, so is not an efficient compresison method, is just an encoding like base64, but way cooler and friendlier.
Demo
We have built a full working demo at emoji-compress.com ‼
How
The algorithm is very simple: it split the string in a series of bytes, and map each byte by its value to an unique emoji. A byte can have only 255 possible values, so we only need 255 different emojis to encode ... anything.
Source
The package is a Go port of @ayende 's emoji encoder. He also uses it to encode the Licenses for his product when they are sent to the customers.
There are other advantages. This data is actually a 256 bits key for use in encryption. And you can actually show it to a user and have a reasonably good chance that they will be able to tell it apart from something else. It rely on the ability of humans to recognize shapes, but it will be very hard for them to actually tell someone your key.
Example
ugly := []string{
"127.0.0.1",
"ZW1vamk=", //base64 for "emoji"
"5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8", //sha1 for "password"
}
for _, s := range ugly {
emojified, err := EncodeString(s)
if err != nil {
log.Panic(err)
}
fmt.Printf("%s => %s\n", s, emojified)
}
// Output: 127.0.0.1 => 🙇🙈🙍🙀🙆🙀🙆🙀🙇
//ZW1vamk= => 🚇🚃🙇🚾🚕🚬🚪✉
//5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8 => 🙋🚗🚕🚕🙌🙇🚢🙊🚙🙏🚗🙏🙉🚤🙉🚤🙆🙌🙎🙈🙈🙋🙆🚗🙌🚙🚤🙎🙉🙉🙇🚗🙍🚢🚢🙌🙎🚤🚚🙎
This package has unit tests, GoDoc and Examples.
About
This package is part of a group of emoji-related encoding and compression algorithms built for fun and academic purposes in Go.
Copyright (c) 2017 B.G.Adrian & @Davidescus
Documentation
¶
Overview ¶
Package bytesmap can be used to encode strings into emojis. Can be useful to "humanize" hard to remember/recognize texts such as Hashes, keys, other encodes like base64, ip's and so on.
Depending on the text the result may have fewer characters, but definately will have more bytes in length, so is not an efficient compresison method, is just an encoding like base64, but way cooler and friendlier.
The algorithm is very simple: it split the string in a series of bytes, and map each byte by its value to an unique emoji. A byte can have only 255 possible values, so we only need 255 different emojis to encode ... anything.
Index ¶
Examples ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func DecodeString ¶
DecodeString overload the Decode() function.
Example ¶
beauty := []string{
"🙇🙈🙍🙀🙆🙀🙆🙀🙇", //127.0.0.1
"🚇🚃🙇🚾🚕🚬🚪✉", //base64 for "emoji"
"🙋🚗🚕🚕🙌🙇🚢🙊🚙🙏🚗🙏🙉🚤🙉🚤🙆🙌🙎🙈🙈🙋🙆🚗🙌🚙🚤🙎🙉🙉🙇🚗🙍🚢🚢🙌🙎🚤🚚🙎", //sha1 for "password"
}
for _, s := range beauty {
original, err := DecodeString(s)
if err != nil {
log.Panic(err)
}
fmt.Printf("%s => %s\n", s, original)
}
Output: 🙇🙈🙍🙀🙆🙀🙆🙀🙇 => 127.0.0.1 🚇🚃🙇🚾🚕🚬🚪✉ => ZW1vamk= 🙋🚗🚕🚕🙌🙇🚢🙊🚙🙏🚗🙏🙉🚤🙉🚤🙆🙌🙎🙈🙈🙋🙆🚗🙌🚙🚤🙎🙉🙉🙇🚗🙍🚢🚢🙌🙎🚤🚚🙎 => 5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8
func Encode ¶
Encode a stream of bytes (we presume it is a string) into an emoji form. Each possible byte value (0-255) is mapped to an unique emoji.
func EncodeString ¶
EncodeString is an overload of Encode(), most of the cases you'll need this to avoid code duplication ([]byte <-> string).
Example ¶
ugly := []string{
"127.0.0.1",
"ZW1vamk=", //base64 for "emoji"
"5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8", //sha1 for "password"
}
for _, s := range ugly {
emojified, err := EncodeString(s)
if err != nil {
log.Panic(err)
}
fmt.Printf("%s => %s\n", s, emojified)
}
Output: 127.0.0.1 => 🙇🙈🙍🙀🙆🙀🙆🙀🙇 ZW1vamk= => 🚇🚃🙇🚾🚕🚬🚪✉ 5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8 => 🙋🚗🚕🚕🙌🙇🚢🙊🚙🙏🚗🙏🙉🚤🙉🚤🙆🙌🙎🙈🙈🙋🙆🚗🙌🚙🚤🙎🙉🙉🙇🚗🙍🚢🚢🙌🙎🚤🚚🙎
Types ¶
This section is empty.
Source Files