{"id":21861573,"url":"https://github.com/raleighlittles/aamva_drivers_license_decoder","last_synced_at":"2026-05-19T04:41:06.471Z","repository":{"id":214904639,"uuid":"737393009","full_name":"raleighlittles/AAMVA_Drivers_License_Decoder","owner":"raleighlittles","description":"Simple script and webapp for parsing a driver's license AAMVA fields. Deployment coming soon","archived":false,"fork":false,"pushed_at":"2023-12-31T20:39:03.000Z","size":5404,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-21T20:19:07.975Z","etag":null,"topics":["aamva","aamva-standard","dhs","pdf-417","real-id"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/raleighlittles.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["raleighlittles"],"custom":["paypal.me/raleighlittles"]}},"created_at":"2023-12-30T21:40:58.000Z","updated_at":"2024-11-26T19:53:02.000Z","dependencies_parsed_at":null,"dependency_job_id":"98dc6361-4361-4320-8703-f682f695dad5","html_url":"https://github.com/raleighlittles/AAMVA_Drivers_License_Decoder","commit_stats":null,"previous_names":["raleighlittles/aamva_drivers_license_decoder"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/raleighlittles/AAMVA_Drivers_License_Decoder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raleighlittles%2FAAMVA_Drivers_License_Decoder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raleighlittles%2FAAMVA_Drivers_License_Decoder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raleighlittles%2FAAMVA_Drivers_License_Decoder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raleighlittles%2FAAMVA_Drivers_License_Decoder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raleighlittles","download_url":"https://codeload.github.com/raleighlittles/AAMVA_Drivers_License_Decoder/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raleighlittles%2FAAMVA_Drivers_License_Decoder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33202121,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-18T09:27:30.708Z","status":"online","status_checked_at":"2026-05-19T02:00:06.763Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aamva","aamva-standard","dhs","pdf-417","real-id"],"created_at":"2024-11-28T03:12:00.332Z","updated_at":"2026-05-19T04:41:06.453Z","avatar_url":"https://github.com/raleighlittles.png","language":"Python","funding_links":["https://github.com/sponsors/raleighlittles","paypal.me/raleighlittles"],"categories":[],"sub_categories":[],"readme":"# Context\n\n[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.\n\nAny 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.\n\n![California Drivers License](./docs/california_drivers_license_back.jpeg)\n\n![Canada Drivers License](./docs/canada_drivers_license_back.jpg)\n\nFor 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.\n\nThere 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.\n\n# About\n\nThis project is a simple Flask webapp that allows you to easily decode these AAMVA fields from a driver's license.\n\nSimply use a PDF-417 scanner online (I like [this](https://online-barcode-reader.inliteresearch.com/) one), and then paste the data into the form.\n\n![UI screenshot](./docs/ui.png)\n\nThe output will show each of the decoded AAMVA fields.\n\n![Result screenshot](./docs/result.png)\n\n# Usage\n\nInstall dependencies\n\n```bash\n$ pip install -r requirements.txt\n```\n\nLaunch flask app:\n\n```bash\n$ flask --app flask_dl_decoder_app run --debug\n```\n\nYou can also run this as a CLI app on its own.\n\n```\noptions:\n  -h, --help            show this help message and exit\n  -f TEXT_FILE, --text-file TEXT_FILE\n                        Input text file containing the decoded PDF-417 data, to read from\n  -o OUTPUT_FILE, --output-file OUTPUT_FILE\n                        Output text file to write results to\n```\n\n# Standards and more\n\nThe code supports decoding fields from the AAMVA 2020 standard (version 10). You'll find a copy of the standards document in the `standards` folder.\n\nThe sample test case for AAMVA data is in the `examples` folder.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraleighlittles%2Faamva_drivers_license_decoder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraleighlittles%2Faamva_drivers_license_decoder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraleighlittles%2Faamva_drivers_license_decoder/lists"}