embin

embin is a simple program that can embed binary or text files into source code of a specific language.

Installation

You can find pre-built releases for linux, macOS and Windows

Otherwise, you can install embin from source using cargo, with the following command:

sh cargo install embin

⭐ Don't forget to put a star if you like the project!

Usage

``` Usage: embin [OPTIONS]

Arguments: Path to the asset to be embed, which can be a binary or a text file

Options: -o, --output

Write generated source code in the specified output file instead of stdout -n, --name Use a specific variable name for the generated content instead of input file name --lang Language of the generated source code [default: c] --format Format of the generated source code [default: hexa] --indent Indentation type of the generated source code [default: space] --padding Padding value of the generated source code [default: 4] --quantity Number of byte elements per line [default: 16] --mutable Make generated variables mutable -h, --help Print help -V, --version Print version ```

Examples

Embedding a file into C

sh embin --lang=c data.png > output.h

Result:

c const unsigned char data_png[] = { 0x54, 0x68, 0x69, 0x73, 0x20, 0x69, 0x73, 0x20, 0x61, 0x20, 0x74, 0x65, 0x73, 0x74, 0x20, 0x66, 0x69, 0x6c, 0x65, 0x2e, 0x0a, 0x0a, 0x54, 0x68, 0x69, 0x73, 0x20, 0x69, 0x73, 0x20, 0x61, 0x20, 0x6e, 0x65, 0x77, 0x20, 0x6c, 0x69, 0x6e, 0x65, 0x2e, 0x0a }; const int data_png_len = 42;

Embedding a file into C++

sh embin --lang=cpp data.png > output.hpp

Result:

```cpp

include

constexpr std::array data_png = { 0x54, 0x68, 0x69, 0x73, 0x20, 0x69, 0x73, 0x20, 0x61, 0x20, 0x74, 0x65, 0x73, 0x74, 0x20, 0x66, 0x69, 0x6c, 0x65, 0x2e, 0x0a, 0x0a, 0x54, 0x68, 0x69, 0x73, 0x20, 0x69, 0x73, 0x20, 0x61, 0x20, 0x6e, 0x65, 0x77, 0x20, 0x6c, 0x69, 0x6e, 0x65, 0x2e, 0x0a }; ```

Embedding a file into Python

sh embin --lang=python data.png > output.py

Result:

python DATA_PNG = bytes([ 0x54, 0x68, 0x69, 0x73, 0x20, 0x69, 0x73, 0x20, 0x61, 0x20, 0x74, 0x65, 0x73, 0x74, 0x20, 0x66, 0x69, 0x6c, 0x65, 0x2e, 0x0a, 0x0a, 0x54, 0x68, 0x69, 0x73, 0x20, 0x69, 0x73, 0x20, 0x61, 0x20, 0x6e, 0x65, 0x77, 0x20, 0x6c, 0x69, 0x6e, 0x65, 0x2e, 0x0a ])

Options

--name Set the name of the generated variable

sh embin --name my_embed_image data.png

c const unsigned char my_embed_image[] = { 0x54, 0x68, 0x69, 0x73, 0x20, 0x69, 0x73, 0x20, 0x61, 0x20, 0x74, 0x65, 0x73, 0x74, 0x20, 0x66, 0x69, 0x6c, 0x65, 0x2e, 0x0a, 0x0a, 0x54, 0x68, 0x69, 0x73, 0x20, 0x69, 0x73, 0x20, 0x61, 0x20, 0x6e, 0x65, 0x77, 0x20, 0x6c, 0x69, 0x6e, 0x65, 0x2e, 0x0a }; const int my_embed_image_len = 42;

--format Set the format of the generated source code

Char format:

sh embin --format=char data.txt

c const unsigned char data_txt[] = "This is a test file.\n\n" "This is a new line.\n"; const unsigned int data_txt_len = 42;

Octal format:

sh embin --format=octal data.txt

c const unsigned char data_txt[] = "\124\150\151\163\040\151\163\040\141\040\164\145\163\164\040\146" "\151\154\145\056\012\012\124\150\151\163\040\151\163\040\141\040" "\156\145\167\040\154\151\156\145\056\012"; const unsigned int data_txt_len = 42;

--indent Set indentation type of the generated source code

Indent with tabs instead of spaces:

sh embin --indent=tab data.png

--padding Set padding value of the generated source code

sh embin --padding 0 data.png

c const unsigned char data_png[] = { 0x54, 0x68, 0x69, 0x73, 0x20, 0x69, 0x73, 0x20, 0x61, 0x20, 0x74, 0x65, 0x73, 0x74, 0x20, 0x66, 0x69, 0x6c, 0x65, 0x2e, 0x0a, 0x0a, 0x54, 0x68, 0x69, 0x73, 0x20, 0x69, 0x73, 0x20, 0x61, 0x20, 0x6e, 0x65, 0x77, 0x20, 0x6c, 0x69, 0x6e, 0x65, 0x2e, 0x0a }; const unsigned int data_png_len = 42;

--quantity Set number of byte elements per line

sh embin --quantity 8 data.png

c const unsigned char data_png[] = { 0x54, 0x68, 0x69, 0x73, 0x20, 0x69, 0x73, 0x20, 0x61, 0x20, 0x74, 0x65, 0x73, 0x74, 0x20, 0x66, 0x69, 0x6c, 0x65, 0x2e, 0x0a, 0x0a, 0x54, 0x68, 0x69, 0x73, 0x20, 0x69, 0x73, 0x20, 0x61, 0x20, 0x6e, 0x65, 0x77, 0x20, 0x6c, 0x69, 0x6e, 0x65, 0x2e, 0x0a }; const unsigned int data_png_len = 42;

--mutable Make generated variables mutable

sh embin --mutable data.png

c unsigned char data_png[] = { 0x54, 0x68, 0x69, 0x73, 0x20, 0x69, 0x73, 0x20, 0x61, 0x20, 0x74, 0x65, 0x73, 0x74, 0x20, 0x66, 0x69, 0x6c, 0x65, 0x2e, 0x0a, 0x0a, 0x54, 0x68, 0x69, 0x73, 0x20, 0x69, 0x73, 0x20, 0x61, 0x20, 0x6e, 0x65, 0x77, 0x20, 0x6c, 0x69, 0x6e, 0x65, 0x2e, 0x0a }; unsigned int data_png_len = 42;

License

This project is released under MIT license.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.