https://github.com/colorsafe/colorsafe

A colorized data storage scheme for printing on paper.
https://github.com/colorsafe/colorsafe

Last synced: 5 days ago
JSON representation

A colorized data storage scheme for printing on paper.

• Host: GitHub
• URL: https://github.com/colorsafe/colorsafe
• Owner: colorsafe
• License: gpl-3.0
• Created: 2017-11-13T01:56:52.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2023-05-25T06:51:27.000Z (over 1 year ago)
• Last Synced: 2024-09-21T16:38:35.670Z (about 2 months ago)
• Language: Python
• Size: 1.23 MB
• Stars: 57
• Watchers: 10
• Forks: 5
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-starred - colorsafe/colorsafe - A colorized data storage scheme for printing on paper. (others)

README

        
# ColorSafe

A data matrix scheme for printing on paper and microfilm. Inspired by

[PaperBak](https://github.com/Rupan/paperbak), ColorSafe is written in Python

and has a flexible specification. It aims to allow a few Megabytes of data

(or more) to be stored on printable media for a worst case scenario backup, for

extremely long-term archiving, or just for fun. With best practices, ColorSafe

encoded data can safely withstand the vicissitudes of technology changes over

long periods of time.

# Examples

ColorSafe encoded data with default black and white settings looks like this:

![Color depth 1](images/sector_c1.png "Color depth 1")

With a color depth of 2 (Cyan, Magenta, Yellow, White) it looks like this:

![Color depth 2](images/sector_c2.png "Color depth 2")

With a color depth of 3 (Black, Red, Green, Yellow, Blue, Magenta, Cyan, White)

it looks like this:

![Color depth 3](images/sector_c3.png "Color depth 3")

Check out the images folder to see sample images of full pages.

# Usage

To install:

``pip install colorsafe``

To encode a file with default settings, e.g. 100dpi:

``colorsafe encode input.txt``

This generates a single pdf and multiple png files with the black and white

data matrices, which can then be printed and stored.

To decode, scan the images back at 3x resolution, e.g. 300dpi, and run decoding:

``colorsafe decode scan_page0.bmp scan_page1.bmp``

Which outputs the data on the given pages.

Try the argument -c 2 or 3 for colorized encoding and decoding modes.