Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 

README.md

Ease64 (alpha). Base64 for humans

Ease64 is a Base64 alternative that can be encoded/decoded by hand. This means: no error-prone math operations like addition (uuencode) and no arbitrary look-up tables. All that's needed is a regular ASCII-octal table for both encoding and decoding.

For more, continue reading this or look at the tests.

Encoding by hand

Let's encode the word "Man". First, get yourself an ASCII table with octals in it. It's not that difficult.

Then, look up every character and write down their octal values:

  • M → 115(8)
  • a → 141(8)
  • n → 156(8)

Put every digit (octet, actually) together:

115141156

Now separate the octets in groups of two, add one zero at the end if needed:

11 51 41 15 60

Then, go back to the same ASCII table and look up your two octets. As you see, most values are three octets long. The key here is to ignore the third octet from the right. In some cases, you will have more than one character to choose from. That's fine.

Octal Character Other option
11 I 111(8)
51 i 151(8) ) 051(8)
41 a 141(8) ! 041(8)
15 M 115(8)
60 p 160(8) 0 060(8)

Finally, put every character together into a string. Each one of the next eight results are 100% ease64 valid and decode back to "Man". Use whichever you prefer:

  IiaMp      IiaM0      I)aMp     I)aM0
  Ii!Mp      Ii!M0      I)!Mp     I)!M0

Example

Hello World! may be encoded into any of the following:

a. IAeMalMx`JyoNQlL`a (backtick)
b. IAeMalMx JyoNQlL a (space)
c. IAeMalMxàJyoNQlLàa (agrave)

All three examples decode back to Hello World!. Why?

Unlike Base64, for any value that you want to encode, you can choose between different characters as long as they follow this rule: its octal value must share the last two digits. Be careful with text encodings if you get very fancy and start using emojis, special characters and the like.

Usage

Download ease64.rb in the same directory of your project.

require_relative 'ease64'

enc = Ease64.encode64 'Hello World!'
# => "IAeMalMx`JyoNQlL`a"
plain = Ease64.decode64 enc
# => "Hello World!"

To play in the console with interactive Ruby:

$ irb -r './ease.rb'
2.3.0 :001 > Ease64.encode64 'Hello World!'
# => "IAeMalMx`JyoNQlL`a"

Current Version

v0.0.1 alpha

TODO:

  • Handle Unicode characters properly so emojis can be used (using String#codepoints?)
  • Explain motivation in this Readme.
  • Write down some ideas where Ease64 can be used.

Releases

No releases published

Packages

No packages published

Languages

You can’t perform that action at this time.