README
¶
underbyte
Fun with steganography, images, and Go. Encode arbitrary bytes in image pixels.
Note that encoding only writes output images as PNGs (though JPEGs can be used as an input image).
Example:
This image of Leo Tolstoy encodes an epub of the entirety of War and Peace.
It was created by running
cat war_and_peace.epub| ./underbyte -file tolstoy.jpg -out tolstoy_war_peace.png
You can decode and extract the epub file by running
./underbyte -decode -file tolstoy_war_peace.png -out decoded_war_peace.epub
Secret keys
You can supply a secret key when coding and decoding. This secret is used to seed randomized pixel cursor that determines which pixels contain which bytes of the encoded message.
Installation
Building from source
go build -o underbyte cmd/main.go
Usage
Usage of ./underbyte:
-decode
Decode message from image instead of encoding (default false)
-file string
Input image filepath
-message string
message to encode (STDIN used if not specified)
-out string
Output filepath for encoded image (STDOUT used if not specified)
-secret string
secret key value used to encode and decode message
Examples:
Encoding:
underbyte -file image.png -message "hello there" -out encoded_image.png
underbyte -file image.png -message "hello there" > encoded_image.png
cat somefile.txt | underbyte -file image.png > encoded_image.png
Decoding:
underbyte -decode -file encoded_image.png
underbyte -decode -file encoded_image.png -out decoded_image.png
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type DoublePackReader ¶
type DoublePackReader struct {
// contains filtered or unexported fields
}
type ImageLoader ¶
type ImageLoader interface {
// contains filtered or unexported methods
}
type PixelCursor ¶
type PixelCursor struct {
Sequence
}
func NewPixelCursor ¶
func NewPixelCursor(max, index int) *PixelCursor
func NewRandomizedPixelCursor ¶
func NewRandomizedPixelCursor(u UnderbyteImage, initPosition, maxIterations int) *PixelCursor
type RandomizedSequence ¶
type RandomizedSequence struct {
// contains filtered or unexported fields
}
type SequentialSequence ¶
type SequentialSequence struct {
// contains filtered or unexported fields
}
type SinglePackReader ¶
type SinglePackReader struct {
// contains filtered or unexported fields
}
type SourceImageBytes ¶
type SourceImageBytes []byte
type SourceImagePath ¶
type SourceImagePath string
type UnderbyteImage ¶
func NewUnderbyteImage ¶
func NewUnderbyteImage(source ImageLoader, options *UnderbyteOptions) *UnderbyteImage
func (*UnderbyteImage) Encode ¶
func (u *UnderbyteImage) Encode(message []byte) error
func (*UnderbyteImage) WriteImage ¶
func (u *UnderbyteImage) WriteImage(w io.Writer)
type UnderbyteOptions ¶
type UnderbyteReader ¶
type UnderbyteReader interface {
// contains filtered or unexported methods
}
Source Files
¶
Directories
Click to show internal directories.
Click to hide internal directories.