Skip to content

HelixCipher/project-jackheart

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Project Jackheart

Project Jackheart is an educational project that explores how digital file formats behave at byte level. The notebooks teach practical, reproducible techniques for hiding data inside JPEGs, embedding images within images, creating polyglot files valid in multiple formats, and embedding encrypted payloads in MP3 files using a header-level, codec-aware approach (private-bit embedding with AES-GCM). All material focuses on safe, local experiments, clear explanations of format internals, and OPSEC/privacy best practices.





The project demonstrates practical techniques for:

  • Hiding data inside JPEG files.

  • Embedding entire images inside other images.

  • Creating polyglot files that are valid in multiple formats at the same time.

  • Embedding encrypted data in MP3 files using a header-level, codec-aware technique (private bit).

All demonstrations are for learning and research purposes only. No exploitation, malware, or bypass techniques are produced.


Educational Purpose

This project exists to help developers, and security enthusiasts understand:

  • How file formats are structured.

  • How parsers interpret binary data.

  • How steganography differs from polyglots.

  • Why “file extensions” do not define file behavior.

  • What real-world security implications exist around file handling.

Every technique shown here can be reproduced with normal tools and publicly documented standards.

The goal is awareness and technical literacy.


Project Structure

The repository contains four main Jupyter notebooks:


Audio Demo

🎵 Listen to Audio Files Visit GitHub Pages audio player to hear both the original carrier and stego file directly in your browser.

The Steganography_In_MP3.ipynb notebook demonstrates:

  • How to hide encrypted data in MP3 files.

  • Header-level codec-aware steganography using the Private Bit method.

  • AES-256-GCM encryption for secure payload embedding.

Example carrier/stego files:

  • carrier.mp3

  • stego_codec.mp3


Legal & ethical note

This repository is educational. Use these tools responsibly and lawfully. Do not use to facilitate illegal activity. If you handle sensitive data (e.g., third-party personal data), follow applicable privacy laws and organizational policies.


License & Attribution

This project is licensed under the Creative Commons Attribution 4.0 International (CC BY 4.0) license.

You are free to use, share, copy, modify, and redistribute this material for any purpose (including commercial use), provided that proper attribution is given.

Attribution requirements

Any reuse, redistribution, or derivative work must include:

  1. The creator’s name: HelixCipher

  2. A link to the original repository:

    https://github.com/HelixCipher/project-jackheart

  3. An indication of whether changes were made

  4. A reference to the license (CC BY 4.0)

Example Attribution

This work is based on Project Jackheart by HelixCipher. Original source: https://github.com/HelixCipher/project-jackheart Licensed under the Creative Commons Attribution 4.0 International (CC BY 4.0).

You may place this attribution in a README, documentation, credits section, or other visible location appropriate to the medium.

Full license text: https://creativecommons.org/licenses/by/4.0/


Disclaimer

This project is provided “as-is” for educational purposes only. The author accepts no responsibility for how this material is used. There is no warranty or guarantee that the notebooks or scripts are safe, secure, or appropriate for any particular purpose. Use at your own risk.

see DISCLAIMER.md for full terms. Use at your own risk.


Credits & Media Attribution

The MP3 file used as a carrier in this project is based on the track "Envelope" by TheFatRat, used under a free-to-use license. This applies to both the original carrier.mp3 and the modified stego_codec.mp3.

Required Attribution:

TheFatRat - Envelope is under a YouTube Free license. Watch: 'Envelope' by TheFatRat 🇩🇪 | Japanese Electronic Music (No Copyright) 🗾
Music powered by BreakingCopyright: 'Envelope' by TheFatRat 🇩🇪 | Japanese Electronic Music (No Copyright) 🗾
Find more music: https://breakingcopyright.com

Artist: TheFatRat
License Details: BreakingCopyright - Envelope

About

Project Jackheart is an educational project demonstrating byte-level file techniques: hiding data in JPEGs, embedding images inside images, building polyglot files, and header-level codec-aware MP3 steganography (private-bit embedding + AES-GCM). The notebooks emphasize secure, local experimentation, reproducibility, and OPSEC.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors