{"id":19763971,"url":"https://github.com/dwarf1er/vaxicode-parser","last_synced_at":"2026-06-09T03:40:12.157Z","repository":{"id":67008965,"uuid":"400913685","full_name":"Dwarf1er/vaxicode-parser","owner":"Dwarf1er","description":"The Vaxicode Parser extracts information from vaccination QR codes using the SHC standard, making it easy for anyone to access their vaccination records","archived":false,"fork":false,"pushed_at":"2025-02-27T22:38:51.000Z","size":12134,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-08T10:44:52.403Z","etag":null,"topics":["json-web-token","jwt","qrcode","shc","smart-health-card"],"latest_commit_sha":null,"homepage":"http://antoinepoulin.com/vaxicode-parser/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Dwarf1er.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2021-08-28T23:59:12.000Z","updated_at":"2025-02-27T22:38:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"c9733743-0fd9-4d56-86f8-8a94f183c723","html_url":"https://github.com/Dwarf1er/vaxicode-parser","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Dwarf1er/vaxicode-parser","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dwarf1er%2Fvaxicode-parser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dwarf1er%2Fvaxicode-parser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dwarf1er%2Fvaxicode-parser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dwarf1er%2Fvaxicode-parser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dwarf1er","download_url":"https://codeload.github.com/Dwarf1er/vaxicode-parser/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dwarf1er%2Fvaxicode-parser/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34090751,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"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":["json-web-token","jwt","qrcode","shc","smart-health-card"],"created_at":"2024-11-12T04:11:55.265Z","updated_at":"2026-06-09T03:40:12.098Z","avatar_url":"https://github.com/Dwarf1er.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VaxiCode Parser\r\n\r\nThe VaxiCode Parser is a command-line tool for decoding Smart Health Card (SHC) information from QR codes embedded in PDFs, images, or provided as a string.\r\n\r\n## Project Description\r\n\r\nThe Smart Health Card (SHC) is a standard format for securely storing and sharing COVID-19 vaccination and testing information. This tool helps decode the encoded health information contained within SHC QR codes, allowing users to view the decoded data in a human-readable format.\r\n\r\n## Webpage Version\r\n\r\nAlternatively, a webpage version of the VaxiCode Parser is available, providing a user-friendly interface for decoding SHC information. The webpage runs entirely on the client-side, ensuring that no data is stored or sent anywhere. Users can upload PDF files, images, or enter SHC strings directly for decoding. The decoded information is displayed on the webpage for easy access.\r\n\r\nYou can access the webpage version of the VaxiCode Parser [here](https://antoinepoulin.com/vaxicode-parser)\r\n\r\n**NOTE: To use the PDF/image decoding features you need to have canvas reading enabled in your browser for QR codes to be read with JavaScript (privacy.resistFingerprinting must be turned off for Firefox users)**\r\n\r\n## Prerequisites\r\n\r\nBefore installing and using the VaxiCode Parser, ensure you have the following prerequisites:\r\n\r\n- **Python**: Ensure you have Python (\u003e=3.6) installed on your system.\r\n- **Poppler**: For decoding PDF files, you need to have Poppler installed. Instructions for installing Poppler on different operating systems are provided below.\r\n- **Poetry**: Poetry is a dependency manager for Python projects. You'll need Poetry to install and manage the dependencies for this project. Follow the installation instructions below.\r\n\r\n## Installing Poppler\r\n\r\n### Linux (Ubuntu/Debian)\r\n\r\n```bash\r\nsudo apt update \u0026\u0026 sudo apt upgrade\r\nsudo apt install poppler-utils\r\n```\r\n### MacOS\r\n\r\n```bash\r\nbrew install poppler\r\n```\r\n\r\n### Windows\r\n1. Download the latest version of Poppler from [oschwartz10612/poppler-windows](https://github.com/oschwartz10612/poppler-windows/releases)\r\n2. Extract the latest release .zip to C:\\Program Files\r\n3. Add the absolute path to the Poppler bin directory to your system PATH\r\n\r\n## Installing Poetry\r\n\r\nTo install Poetry, run the following command:\r\n```bash\r\ncurl -sSL https://install.python-poetry.org | python3 -\r\n```\r\n\r\nFor detailed installation instructions, refer to the [Poetry documentation](https://python-poetry.org/docs/#installing-with-the-official-installer).\r\n\r\n## Installation\r\n\r\nTo install the VaxiCode Parser and its dependencies, follow these steps:\r\n\r\n1. Clone the repository:\r\n```bash\r\ngit clone https://github.com/Dwarf1er/vaxicode-parser.git\r\n```\r\n\r\n2. Navigate to the project directory:\r\n```bash\r\ncd path/to/vaxicode-parser\r\n```\r\n\r\n3. Install dependencies using Poetry:\r\n```bash\r\npoetry install\r\n```\r\n\r\n## Usage\r\n\r\nAfter installing the VaxiCode Parser, you can use it to decode SHC information from PDFs, images, or SHC strings using the following command-line interface:\r\n\r\n1. Enter the poetry virtual environment:\r\n\r\n```bash\r\npoetry shell\r\n```\r\n2. Use the command line interface:\r\n```bash\r\npython vaxicode-parser.py --pdf \u003cpath_to_pdf_file\u003e\r\npython vaxicode-parser.py --image \u003cpath_to_image_file\u003e\r\npython vaxicode-parser.py --shc \u003cshc_string\u003e\r\n```\r\nReplace \u003cpath_to_pdf_file\u003e, \u003cpath_to_image_file\u003e, and \u003cshc_string\u003e with the appropriate values.\r\n\r\n## Authors\r\n\r\n  - **Antoine Poulin**\r\n    [Dwarf1er](https://github.com/Dwarf1er)\r\n\r\n## License\r\n\r\nThis project is licensed under the [GNU General Public License v3.0](LICENSE)\r\n\r\n## Acknowledgments\r\n\r\n  - **Billie Thompson**, this README was based on the template provided [here](https://github.com/PurpleBooth/a-good-readme-template)\r\n  - **Mikkel Paulson**, this project was inspired by the project found [here](https://github.com/MikkelPaulson/smart-health-card-parser)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdwarf1er%2Fvaxicode-parser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdwarf1er%2Fvaxicode-parser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdwarf1er%2Fvaxicode-parser/lists"}