Mymra

This project allows you to embed and extract files or strings within other files using AES encryption.

Installation

Install library:

pip install mymra

Usage Examples

Library Functions

Embedding a File

Embed a file into a host file:

from mymra import embed_file

embed_file(
    input_file_path='123.mp4',  # File to embed
    host_file_path='123.png',   # Host file
    output_file_path='1488.png',  # Path to save file with embedded data
    password='COCKER',          # Optional password
    marker='ITSTEST'            # Optional marker
	xor_key='123'               # Optional XOR-key for marker encryption
)

Extracting a File

Extract an embedded file from a host file:

from mymra import extract_file

output_path = extract_file(
    host_file_path='1488.png',  # File containing embedded data
    password='COCKER',          # Optional password
    marker='ITSTEST'            # Optional marker
	xor_key='123'               # Optional XOR-key for marker encryption
)

print(output_path)

Embedding a string

Embed a string into a host file:

from mymra import embed_string

embed_string(
    input_string='secret',         # String to embed
    host_file_path='123.png',      # Host file
    output_file_path='output.png', # Path to save file with embedded string
    password='COCKER',             # Optional password
    marker='ITSTEST'               # Optional marker
	xor_key='123'                  # Optional XOR-key for marker encryption
)

Extracting a string

Extract a string from file:

from mymra import extract_string

string = extract_string(
    host_file_path='output.png',      # File with embedded string
    password='COCKER',                # Optional password
    marker='ITSTEST'          		  # Optional marker
	xor_key='123'              		  # Optional XOR-key for marker encryption
)

print(string)

Deembedding

Remove embedded data from a file:

from mymra import deembed_file

deembed_file(
    host_file_path='123.png',      # File with embedded data
    output_file_path='321.png',    # Path to save cleaned file
    marker='ITSTEST'               # Optional marker
	xor_key='123'                  # Optional XOR-key for marker encryption
)

Analyzing a File

Analyze a host file to determine the embedded content type, metadata, or content:

from mymra import analyze_file

# Analyze a file containing an embedded file
result = analyze_file(
    host_file_path='1488.png',  # File containing embedded data
    password='COCKER',          # Optional password
    marker='ITSTEST'            # Optional marker
	xor_key='123'               # Optional XOR-key for marker encryption
)

if result['type'] == 'file':
    print("Embedded file details:")
    print(f"Name: {result['file_name']}")
    print(f"Extension: {result['file_extension']}")
    print(f"Size: {result['file_size']} bytes")
elif result['type'] == 'string':
    print("Embedded string content:")
    print(result['value'])

Command-Line Interface

Embedding a File

Embed a file with optional arguments:

mymra embed 123.mp4 123.png 1488.png -p COCKER -m ITSTEST -xor 123

Extracting a File

Extract an embedded file using optional arguments:

mymra extract 1488.png -p COCKER -m ITSTEST -xor 123

Embedding a String

Embed a string into a host file:

mymra embed_string "Secret Data" 123.png string_embedded.png -p COCKER -m ITSTEST -xor 123

Extracting a String

Extract a string from a host file:

mymra extract_string string_embedded.png -p COCKER -m ITSTEST -xor 123

Removing Embedded Data

Remove embedded data from a file:

mymra deembed 1488.png cleaned_123.png -m ITSTEST

Analyzing a File

Analyze a host file to identify embedded content:

• Analyzing a file containing an embedded file:

mymra analyze 1488.png -p COCKER -m ITSTEST -xor 123

Expected output:

Embedded file details:
Name: example.mp4
Extension: mp4
Size: 1048576 bytes

• Analyzing a file containing an embedded string:

mymra analyze string_embedded.png -p COCKER -m ITSTEST -xor 123

Expected output:

Embedded string content:
This is a secret string