https://github.com/raleighlittles/aamva_drivers_license_decoder

Simple script and webapp for parsing a driver's license AAMVA fields. Deployment coming soon
https://github.com/raleighlittles/aamva_drivers_license_decoder

aamva aamva-standard dhs pdf-417 real-id

Last synced: 2 months ago
JSON representation

Simple script and webapp for parsing a driver's license AAMVA fields. Deployment coming soon

• Host: GitHub
• URL: https://github.com/raleighlittles/aamva_drivers_license_decoder
• Owner: raleighlittles
• License: other
• Created: 2023-12-30T21:40:58.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2023-12-31T20:39:03.000Z (over 2 years ago)
• Last Synced: 2025-03-21T20:19:07.975Z (over 1 year ago)
• Topics: aamva, aamva-standard, dhs, pdf-417, real-id
• Language: Python
• Homepage:
• Size: 5.15 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

          
# Context

[AAMVA](https://www.aamva.org/) is an organization that produces the standards around, among other things, Driver's Licenses. These standards are implemented so that driver's licenses can easily be transferred across different states.

Any driver's license issued in the US or Canada, has to have a [PDF-417 barcode](https://en.wikipedia.org/wiki/PDF417) on the back that encodes the ID's AAMVA data.

![California Drivers License](./docs/california_drivers_license_back.jpeg)

![Canada Drivers License](./docs/canada_drivers_license_back.jpg)

For example, if you're from New York and are pulled over in Montana, the Montana police would scan this barcode to electronically verify your ID is valid, and digitally read the information on it as if you were in New York.

There are over 50 different AAMVA fields, that include basic information for things like your physical description (since your driver's license is supposed to be a basic form of identification), but also driving-specific fields like what "class" of license you have.

# About

This project is a simple Flask webapp that allows you to easily decode these AAMVA fields from a driver's license.

Simply use a PDF-417 scanner online (I like [this](https://online-barcode-reader.inliteresearch.com/) one), and then paste the data into the form.

![UI screenshot](./docs/ui.png)

The output will show each of the decoded AAMVA fields.

![Result screenshot](./docs/result.png)

# Usage

Install dependencies

```bash

$ pip install -r requirements.txt

```

Launch flask app:

```bash

$ flask --app flask_dl_decoder_app run --debug

```

You can also run this as a CLI app on its own.

```

options:

  -h, --help            show this help message and exit

  -f TEXT_FILE, --text-file TEXT_FILE

                        Input text file containing the decoded PDF-417 data, to read from

  -o OUTPUT_FILE, --output-file OUTPUT_FILE

                        Output text file to write results to

```

# Standards and more

The code supports decoding fields from the AAMVA 2020 standard (version 10). You'll find a copy of the standards document in the `standards` folder.

The sample test case for AAMVA data is in the `examples` folder.