https://github.com/minightdev/numcha
Numcha is a simple and customizable CAPTCHA (Completely Automated Public Turing test to tell Computers and Humans Apart) system designed to verify that the user interacting with a web application is a human and not a bot. It utilizes image rotation as a challenge for the user to solve.
https://github.com/minightdev/numcha
Last synced: about 2 months ago
JSON representation
Numcha is a simple and customizable CAPTCHA (Completely Automated Public Turing test to tell Computers and Humans Apart) system designed to verify that the user interacting with a web application is a human and not a bot. It utilizes image rotation as a challenge for the user to solve.
- Host: GitHub
- URL: https://github.com/minightdev/numcha
- Owner: MinightDev
- Created: 2023-11-20T20:21:55.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-11-20T20:36:22.000Z (over 2 years ago)
- Last Synced: 2025-01-27T06:12:13.168Z (over 1 year ago)
- Language: CSS
- Size: 18.6 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Numcha CAPTCHA System
## Overview
Numcha is a simple and customizable CAPTCHA (Completely Automated Public Turing test to tell Computers and Humans Apart) system designed to verify that the user interacting with a web application is a human and not a bot. It utilizes image rotation as a challenge for the user to solve.
## Features
- **Image Rotation Challenge:** Users are presented with an image that needs to be rotated to the correct orientation.
- **Random Image Selection:** The system randomly selects a set of images for each challenge to enhance security.
- **Dynamic Image Rotation:** The rotation angle of the image is set randomly, increasing the variability of challenges.
## Project Structure
The project consists of the following files:
- **index.html:** The main HTML file that contains the structure of the Numcha CAPTCHA system.
- **styles.css:** The stylesheet file defining the visual appearance of the CAPTCHA system.
- **numcha.js:** The JavaScript file containing the logic for generating and verifying CAPTCHA challenges.
## Getting Started
1. Clone the repository to your local machine.
```bash
git clone https://github.com/MinightDev/Numcha.git
```
2. Open the `index.html` file in a web browser to see the Numcha CAPTCHA system in action.
## Usage
- Click the CAPTCHA start button to initiate the challenge.
- Rotate the presented image until it's correctly oriented.
- Click the submit button to verify your response.
- The system provides feedback on whether the CAPTCHA was successfully solved or not.
## Customization
You can customize the CAPTCHA system by modifying the following parameters in the `numcha.js` file:
- **maxImages:** Controls the maximum number of images in a challenge.
- **imageUrls:** Array of URLs for the challenge images. Add or remove URLs to change the image set.
## Contributing
Contributions are welcome! If you have any suggestions, bug reports, or feature requests, please open an issue or submit a pull request.
## License
This project is licensed under the [MIT License](LICENSE).
## Acknowledgments
Numcha uses the Unsplash API to fetch placeholder images for the challenges. Special thanks to Unsplash for providing beautiful and freely-usable images.
## Author
[MinightDev (Ayoub)]
Feel free to reach out if you have any questions or concerns. Thank you for using Numcha!