Skip to main content

No project description provided

Project description

Python driver for fingerprint sensors by Zhiantec - ZFM-20 series

Is your scanner can be managed by this library?

If your scanner is ZFM-20 or his cheap clone then it possible. I made this library inspired by pyfingerprint, so it may also work with ZFM-60, ZFM-70, ZFM-100, R303 and R305.



Image is a Fingerprint scanned grayscale image. Image can be scanned and stored in volatile image buffer.


Characteristic is a fingerprint characteristic. It represented by a bytearray. Characteristic can be created from fingerprint image and stored in volatile characteristic buffer.


Template is a registered fingerprint model stored in scanner nonvolatile memory. We can not see or feel the template, we only can ask scanner if characteristic look like some template in scanner memory.

Working with sensor


First of all you need make a handshake to verify connection:

with SerialPort(Serial(port='<COM1 or /dev/ttyUSB0>', baudrate=9600 * 6, timeout=2)) as port:
   rq = RqCommand(port)
   rs = RsSimple(port)
   Handshake(rq, rs).make()

As you see you will need to know serial port name of your scanner device. For windows users it may looks like COM1, for unix users it may looks like /dev/ttyUSB0.

Fingerprint image

More complex task - make an image of your fingerprint:

with SerialPort(Serial(port='...', baudrate=9600 * 6, timeout=2)) as port:
    rq = RqCommand(port)
    rs = RsSimple(port)
    print 'Waiting for finger...'
    while not Scan(rq, rs).is_scanned():
    print 'Finger has been scanned! Downloading the finger image...'
    image = UpImage(rq, rs).image()

Project details

Download files

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

Files for fpscanner, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size fpscanner-0.1.0-py2-none-any.whl (55.2 kB) File type Wheel Python version py2 Upload date Hashes View
Filename, size fpscanner-0.1.0.tar.gz (9.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page