'\" t
.\"     Title: stegosuite-embed
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.17
.\"      Date: 2022-10-19
.\"    Manual: Stegosuite Manual
.\"    Source: 
.\"  Language: English
.\"
.TH "STEGOSUITE\-EMBED" "1" "2022-10-19" "" "Stegosuite Manual"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
stegosuite-embed \- Embeds data into image
.SH "SYNOPSIS"
.sp
\fBstegosuite embed\fP [\fB\-d\fP] (\fB\-k\fP=\fI<key>\fP | \fB\-\-keyfile\fP=\fI<keyfile>\fP) [\fB\-m\fP=\fI<message>\fP]
[\fB\-o\fP=\fI<outputPath>\fP] [\fB\-f\fP=\fI<file>\fP[,\fI<file>\fP...]]... \fI<image>\fP
.SH "DESCRIPTION"
.sp
This command embeds data into an image file using the provided key as seed for randomization and encryption. It is possible to embed a text message and multiple files of any type, as long as the image has enough capacity to embed data. The capacity depends on the size of the image and its type. It can be checked with \fBstegosuite capacity\fP.
.SH "OPTIONS"
.sp
\fB\-k\fP, \fB\-\-key\fP=\fI<key>\fP
.RS 4
The secret key used for encryption and hiding.
.RE
.sp
\fB\-\-keyfile\fP=\fI<keyfile>\fP
.RS 4
Path to a file which contains the secret key. Reads its first line.
.RE
.sp
\fB\-m\fP, \fB\-\-message\fP=\fI<message>\fP
.RS 4
The text message to be embedded into the image.
.RE
.sp
\fB\-f\fP, \fB\-\-files\fP=\fI<file>\fP[,\fI<file>\fP...]
.RS 4
Paths to the files to be embedded into the image.
.RE
.sp
\fB\-o\fP, \fB\-\-output\fP=\fI<outputPath>\fP
.RS 4
Specifies path to the generated image file.
.RE
.sp
\fB\-d\fP, \fB\-\-debug\fP
.RS 4
Shows debug information.
.RE
.SH "ARGUMENTS"
.sp
\fI<image>\fP
.RS 4
Path to the image file to process.
.RE
.SH "EXAMPLE"
.sp
\fBstegosuite embed\fP -k \fImy_secret_key\fP -m \fI"My_secret_message"\fP /path/to/image_file.png
.RE
.SH "EXIT CODES:"
.sp
\fB0\fP
.RS 4
Successful program execution
.RE
.sp
\fB1\fP
.RS 4
Internal software error: An exception occurred when invoking the business logic of this command.
.RE
.sp
\fB2\fP
.RS 4
Usage error: User input for the command was incorrect, e.g., the wrong number of arguments.
.RE