Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

A captcha library that generates audio and image CAPTCHAs.

Project description

A captcha library that generates audio and image CAPTCHAs.

https://travis-ci.org/lepture/captcha.png?branch=master https://ci.appveyor.com/api/projects/status/amm21f13lx4wuura https://coveralls.io/repos/lepture/captcha/badge.png?branch=master

Features

  1. Audio CAPTCHAs DEMO
  2. Image CAPTCHAs
https://cloud.githubusercontent.com/assets/290496/5213632/95e68768-764b-11e4-862f-d95a8f776cdd.png

Installation

Install captcha with pip:

$ pip install captcha

Usage

Audio and Image CAPTCHAs are in seprated modules:

from io import BytesIO
from captcha.audio import AudioCaptcha
from captcha.image import ImageCaptcha

audio = AudioCaptcha(voicedir='/path/to/voices')
image = ImageCaptcha(fonts=['/path/A.ttf', '/path/B.ttf'])

data = audio.generate('1234')
assert isinstance(data, bytearray)
audio.write('1234', 'out.wav')

data = image.generate('1234')
assert isinstance(data, BytesIO)
image.write('1234', 'out.png')

This is the APIs for your daily works. We do have built-in voice data and font data. But it is suggested that you use your own voice and font data.

Contribution

We need voice wav files. The voice wav file should be in 8-bit, please keep it as small as possible. Name your voice file as:

{{language}}-{{character}}-{{username}}.wav
# exmaple: zh-1-lepture.wav

TODO: we need a place to upload voice files.

Project details


Release history Release notifications

History Node

0.2.4

History Node

0.2.3

History Node

0.2.2

History Node

0.2.1

History Node

0.2

This version
History Node

0.1.1

History Node

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
captcha-0.1.1.tar.gz (100.4 kB) Copy SHA256 hash SHA256 Source None Dec 2, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page