text2img 0.8.3

Creates a png image from text. Useful to protect sensitive information from bots and scrapers, such as email addresses and telephone numbers in web pages, and even passwords sent via email
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148


![Text 2 Image](img/text2img.png)

Command line utility and (soon to be) library.

Banner created using 

text2img -o text2img.png -s 80 -w 30  "Text 2 Image"

# Install Command Line App

cargo install text2img

## Summary

Creates a png image from text, with an easy to use command line tool and/or library.

The idea is to be able to show sensitive information and defeat Optical Character Recognition (OCR).

Useful to protect text from bots and scrapers,
such as email addresses and telephone numbers in web pages,
and even passwords or tokens sent via email.

The image size is calculated automatically so that the text fits,
with a small margin.
The background is transparent so that the image can be used on any color background.


## Options 

You can change the font size (-s)
also to make it harder for bots and scrapers to do OCR on the text 
there is an option (-w) to only fill in a percentage of the pixels at random.

If the text has spaces it must be put in quotes on the command line.

## Help

```
USAGE:
text2img [OPTIONS] --output <OUTPUT> <TEXT>

ARGS:
<TEXT>    Text to render

OPTIONS:
-h, --help               Print help information
-o, --output <OUTPUT>    Output filename. Currently only png format is supported
-s, --size <SIZE>        Point size of text [default: 20]
-V, --version            Print version information
-w, --weight <WEIGHT>    Weight 1 to 100 [default: 100]
```

## Basic Usage

text2img -o email.png myemail@example.com
 
![Email using default options](img/email.png)

## Font size 

50 point font

text2img -o email_size50.png -s 50 myemail@example.com 

![Email at 50 points](img/email_size50.png)

## Weight 

30% of pixels filled in.

Note: you probably want to make the font bigger so that the text is easier to read.

text2img -o email_weight30.png -w 30 -s 80 myemail@example.com

![Email at 30 percent](img/email_weight30.png)

## Font

Currently only Roboto is supported.

The Roboto font used was copied from

/usr/share/fonts/truetype/roboto/unhinted/RobotoTTF/Roboto-Regular.ttf

# Roadmap - Ideas for next version

Submit an issue if you would like a feature, 
or send a PR if you would like to contribute.

## Poisson Disks

Render the text using Poisson Disks to make it even harder for OCR to work.

## Background color

Currently the background is always transparent.

## Change Font 

text2img -s 12 --font DejaVu -o email.png "myemail@example.com"

## Read stdin 

echo data.txt | text2img -o data.png

## Alignment 

echo data.txt | text2img --justify -o data.png
--center --left --right

# Alternatives to this crate

The alternatives given require the output image size to be specified.

## text2image from the Tesseract project

text2image

## ImageMagick

```
convert -size 360x360 xc:white -font "FreeMono" -pointsize 12 -fill black -draw @ascii.txt image.png
```

## file ascii.txt:

```
text 15,15 "                 text to show
"
```

```
convert -size 360x360 xc:white -font "FreeMono" -pointsize 12 -fill black -annotate +15+15 "@ascii.txt" image.png
```

```
convert -list font | grep Font:
```

```
#!/bin/sh

$1 | convert -background black -fill white \
-font Helvetica -pointsize 14 \
-border 10 -bordercolor black \
label:@- $2
```