Files
captcha/docs/audio.rst
Hsiaoming Yang 15af7396c8 docs: update docs
2023-07-29 10:08:00 +09:00

52 lines
1.2 KiB
ReStructuredText

Audio Captcha
=============
.. rst-class:: lead
Unlock security with Audio CAPTCHA aastery.
----
.. module:: captcha.audio
:noindex:
Usage
-----
Generating audio CAPTCHA with the :class:`AudioCaptcha`` class is remarkably simple.
.. code-block:: python
from captcha.audio import AudioCaptcha
captcha = AudioCaptcha()
data: bytearray = captcha.generate('1234')
.. note::
The default voice library only includes numbers from 0 to 9.
Voice library
-------------
We can build our customized voice library with the help of ``espeak`` and ``ffmpeg``:
.. code-block:: bash
# Set the language code
export ESLANG=en
# Create a directory for the specified language code
mkdir "$ESLANG"
# Loop through each character (a-z, A-Z, 0-9) and create a directory for each
for i in {a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y,z,A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,Z,0,1,2,3,4,5,6,7,8,9}; do
mkdir "$ESLANG/$i"
espeak -a 150 -s 100 -p 15 -v "$ESLANG" "$i" -w "$ESLANG/$i/orig_default.wav"
ffmpeg -i "$ESLANG/$i/orig_default.wav" -ar 8000 -ac 1 -acodec pcm_u8 "$ESLANG/$i/default.wav"
rm "$ESLANG/$i/orig_default.wav"
done
Web server
----------