Skip to content

Commit e93417d

Browse files
authored
Create README.md
1 parent 4b44a51 commit e93417d

File tree

1 file changed

+127
-0
lines changed

1 file changed

+127
-0
lines changed

README.md

Lines changed: 127 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,127 @@
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

Comments
 (0)