Friendly, easy, lightweight, self-hostable CAPTCHA service.
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Skylar Ittner e955fa9885 Override website theme link borders 7 years ago
db_upgrade Add (much) better text questions. 7 years ago
images Initial commit 7 years ago
nbproject Initial commit 7 years ago
.gitignore Initial commit 7 years ago
LICENSE Initial commit 7 years ago
api.php Fix a thing 7 years ago
captcheck.css Override website theme link borders 7 years ago
captcheck.dist.js Override website theme link borders 7 years ago
captcheck.js Override website theme link borders 7 years ago
composer.json Initial commit 7 years ago
composer.lock Initial commit 7 years ago
database.mwb Add (much) better text questions. 7 years ago
database.sql Add (much) better text questions. 7 years ago
index.php Use event handlers instead of onClick and onEnter, for strict CSPs 7 years ago
logo.png Add logo 7 years ago Update readme 7 years ago
required.php Update readme, add SQL code, remove unused function in required.php 7 years ago
scrapetexts.php Add (much) better text questions. 7 years ago
settings.template.php Automatically delete old sessions 7 years ago
test.html Add accessible format, add support for multiple CAPTCHAS on a page (use class instead of id for container) 7 years ago
test.php Make sure question text is black, improve test sample 7 years ago


Easy, light, self-hostable CAPTCHA service. Works on modern browsers (and IE9+). Uses a selection of icons from Font-Awesome. Text-only accessibility mode and support for keyboard-only operation.

Thanks to for supplying the data for the text CAPTCHA.

How to use

In your form, put an empty div with the class "captcheck_container". Add captcheck.js (or captcheck.dist.js) into your page.

<!DOCTYPE html>
        <title>Captcheck Sample Form</title>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
        <script src="captcheck.js"></script>
        <form action="submit.php">
            <input type="text" name="form_field" placeholder="Some random form field" />
            <div class="captcheck_container">
            <button type="submit">Submit Form</button>

When the form is submitted, your server will receive two extra form fields: captcheck_session_code and captcheck_selected_answer. In your form handling code, send a request to http(s)://captcheck-url/api.php. Pass the variables session_id and answer_id with the values sent with the form, and also pass the variable action with the value verify.
You will receive a JSON response with (among other things) "result": true or "result": false. If result is false, the user failed the test, and another variable msg is available with an explanation.

Example URL:

Example responses:
{"session":"some_session_id","result":false,"msg":"Answer incorrect."}


  1. Run composer install.
  2. Copy settings.template.php to settings.php and plug in your settings.
  3. Install the database.
  4. Customize captcheck.js with the correct api_url.
  5. Follow the How to Use section and the example setup in test.html and test.php.

Execution Flow

JS = captcheck.js, API = api.php, FORM = parent form, 
SITE = form processing code, -> = some action taken on the right by the left

JS -> API:      Request session ID, question, and answers (with scrambled random codes)
API -> JS:      Sends info, saves session ID, correct answer, and scrambled answer codes in DB
JS -> API:      Requests answer images by sending scrambled value and session ID
JS -> FORM:     Adds hidden field with value=session ID, displays question and images (or text box)
SITE -> API:    Sends session ID and answer
API -> SITE:    Responds with true/false to indicate if the answer is valid, marks session as expired to prevent CAPTCHA reuse