|
| 1 | +<p align="center"> |
| 2 | + <a href="https://github.com/coduri/VisualCrypto"> |
| 3 | + <img width="100" src="docs/assets/ghost.svg"> |
| 4 | + </a> |
| 5 | +</p> |
| 6 | + |
| 7 | +<h1 align="center">VisualCrypto</h1> |
| 8 | + |
| 9 | +<p align="center">A framework for image-based secret sharing</p> |
| 10 | + |
| 11 | +<p align="center"> |
| 12 | + <!-- Python Version --> |
| 13 | + <a href="https://www.python.org/downloads/"> |
| 14 | + <img src="https://img.shields.io/badge/Python-3.8%2B-blue" alt="Python 3.8+" /> |
| 15 | + </a> |
| 16 | + |
| 17 | + <!-- API Documentation --> |
| 18 | + <a href="https://coduri.github.io/VisualCrypto/"> |
| 19 | + <img src="https://img.shields.io/badge/Documentation-Available-green" alt="Documentation Available" /> |
| 20 | + </a> |
| 21 | + |
| 22 | + <!-- Contributions --> |
| 23 | + <a href="https://coduri.github.io/VisualCrypto/pages/contributing/"> |
| 24 | + <img src="https://img.shields.io/badge/Contributions-Welcome-orange" alt="Contributions Welcome" /> |
| 25 | + </a> |
| 26 | + |
| 27 | + <!-- License --> |
| 28 | + <a href="https://github.com/coduri/VisualCrypto/LICENSE.txt"> |
| 29 | + <img src="https://img.shields.io/badge/License-MIT-red" alt="License" /> |
| 30 | + </a> |
| 31 | + |
| 32 | +</p> |
| 33 | + |
| 34 | +--- |
| 35 | + |
| 36 | +## Overview |
| 37 | +**VisualCrypto** is a Python-based framework for **Visual Secret Sharing (VSS)**, a cryptographic technique that divides a secret image into multiple shares. Each share appears as random noise and reveals no information on its own, but when combined, they reconstruct the original image. |
| 38 | + |
| 39 | +This repository primarily focuses on **(2,2)-VSS schemes**, where a secret image is split into two shares, both of which are required to reveal the hidden content. |
| 40 | + |
| 41 | + |
| 42 | +📌 _For more details on **VisualCrypto**, visit the [Project's Documentation](https://coduri.github.io/VisualCrypto/)._ |
| 43 | + |
| 44 | +--- |
| 45 | + |
| 46 | +## Features |
| 47 | +- Supports Visual Cryptography (VC) & Random Grid (RG) techniques |
| 48 | +- Web-based & script-based execution |
| 49 | +- Easily extendable for new algorithms |
| 50 | + |
| 51 | +--- |
| 52 | + |
| 53 | +## Getting Started |
| 54 | + |
| 55 | +### Installation |
| 56 | +Clone the repository and install dependencies: |
| 57 | +```bash |
| 58 | +git clone https://github.com/coduri/VisualCrypto.git |
| 59 | +cd VisualCrypto |
| 60 | +pip install -r requirements.txt |
| 61 | +``` |
| 62 | + |
| 63 | +### Usage |
| 64 | +You can interact with the framework in two ways: |
| 65 | +1. **Running Python scripts** |
| 66 | +2. **Using the Web Interface** |
| 67 | + |
| 68 | +📌 _For a step-by-step guide, check out the [User Guide](https://coduri.github.io/VisualCrypto/pages/getting_started/)._ |
| 69 | + |
| 70 | +--- |
| 71 | + |
| 72 | +## Web Interface |
| 73 | +Below are sample screenshots of the **web-based interface** of VisualCrypto: |
| 74 | + |
| 75 | +<div align="center"> |
| 76 | + <img src="docs/assets/readme/web_enc1.png" alt="Web App Encryption 1" width="48%"> |
| 77 | + <img src="docs/assets/readme/web_enc2.png" alt="Web App Encryption 2" width="48%"> |
| 78 | +</div> |
| 79 | + |
| 80 | +<div align="center"> |
| 81 | + <img src="docs/assets/readme/web_dec1.png" alt="Web App Decryption 1" width="48%"> |
| 82 | + <img src="docs/assets/readme/web_dec2.png" alt="Web App Decryption 2" width="48%"> |
| 83 | +</div> |
| 84 | + |
| 85 | +--- |
| 86 | + |
| 87 | +## Contributing |
| 88 | +Contributions are welcome! |
| 89 | + |
| 90 | +If you’d like to implement a new Visual Secret Sharing algorithm or improve existing features, please check out our **[Contribution Guide](https://coduri.github.io/VisualCrypto/pages/contributing/)**. |
| 91 | + |
| 92 | +Before submitting a pull request, ensure that: |
| 93 | +- Your algorithm follows the required structure. |
| 94 | +- You’ve tested both encryption & decryption. |
| 95 | +- The web interface is correctly updated. |
| 96 | + |
| 97 | +Thank you for helping improve **VisualCrypto**! 🚀 |
| 98 | + |
| 99 | +--- |
| 100 | + |
| 101 | +## Main References |
| 102 | +- **Visual Cryptography**: Naor, Moni, and Adi Shamir. "Visual cryptography." *Advances in Cryptology—EUROCRYPT'94*. Springer, 1995. <a href="https://doi.org/10.1007/BFb0053419" target="_blank">DOI</a> |
| 103 | +- **Random Grid**: Kafri, Oded, and Eliezer Keren. "Encryption of pictures and shapes by random grids." *Optics Letters* 12.6 (1987): 377-379. <a href="https://doi.org/10.1364/ol.12.000377" target="_blank">DOI</a> |
| 104 | + |
| 105 | + |
| 106 | +--- |
| 107 | + |
| 108 | +## Citation |
| 109 | +If you find this project useful for your research, please consider citing: |
| 110 | + |
| 111 | + ```bibtex |
| 112 | +@misc{Coduri2025VisualCrypto, |
| 113 | + author = {Christian Coduri}, |
| 114 | + title = {VisualCrypto: A Python-based framework for image-based secret sharing}, |
| 115 | + year = {2025}, |
| 116 | + publisher = {GitHub}, |
| 117 | + url = {https://github.com/coduri/VisualCrypto}, |
| 118 | + note = {GitHub repository} |
| 119 | +} |
| 120 | + ``` |
| 121 | + |
| 122 | +--- |
| 123 | + |
| 124 | +## License |
| 125 | +This project is licensed under the **MIT License**. See the [LICENSE](LICENSE.txt) file for details. |
| 126 | + |
| 127 | +--- |
0 commit comments