This repository contains multiple samples that demonstrate how to use the Dynamsoft Barcode Reader Python Edition. It also includes an AI coding skill that helps you quickly build your own barcode app with AI agents like GitHub Copilot, Claude, and Cursor.
Windows
- Supported Versions: Windows 8 and higher, or Windows Server 2012 and higher
- Architectures: x64
Linux
- x64
- Supported Distributions: Ubuntu 16.04+ LTS, Debian 8+, CentOS 7+
- Dependencies: glibc 2.17
- ARM64
- Supported Distributions: Ubuntu 18.04+ LTS, Debian 10+, CentOS/RHEL 8+
- Dependencies: glibc 2.27
macOS
- Supported Versions: macOS 12 (Monterey) and higher
- Architectures: universal (x64, Apple Silicon)
- Python 3.14
- Python 3.13
- Python 3.12
- Python 3.11
- Python 3.10
- Python 3.9
- Python 3.8
pip install dynamsoft-barcode-reader-bundle
or
pip3 install dynamsoft-barcode-reader-bundle
| Sample Name | Description |
|---|---|
ReadAnImage |
Shows the simplest way to read barcodes from an image file and output barcode format and text. |
ReadMultipleImages |
Shows the simplest way to read barcodes from directory with image files and output barcode format and text. |
GeneralSettings |
Shows how to adjust general scan settings, e.g., barcode format, barcode count, scan region. |
GridBarcodeScanner |
This sample demonstrates a multi-phase pipeline for decoding a large barcode grid from a single image, maximizing the decode rate with low latency. |
MultiFormatImageProcessing |
Shows how to decode barcodes from various image format. |
ParameterTuner |
This sample demonstrates how to adjust and test different parameter settings to optimize barcode recognition performance. |
ReadDPMBarcode |
Shows how to read DPM (Direct Part Mark) barcodes. |
ServerSideBarcodeDecoder |
This sample demonstrates how to decode barcodes on the server side by sending images from a client application. |
ShowLocalizedVSDecodedBarcodes |
This sample demonstrates how to highlight successfully decoded and only-localized barcodes with different styles of rectangles. |
VideoDecoding |
Shows how to decode barcodes from live video or video file. |
In addition to the classic barcode decoding samples listed above, the following samples go a step further by parsing the decoded results and showcasing more structured workflows.
Important
These samples use the dynamsoft_capture_vision_bundle package instead of dynamsoft_barcode_reader_bundle. If you're switching to these samples, make sure to install and use the correct package.
| Sample Name | Description |
|---|---|
DriverLicenseScanner |
Shows how to capture and extract user's information from driver license/ID. |
GS1AIScanner |
Shows how to extract and interpret GS1 Application Identifiers (AIs) from GS1 barcodes. |
Tip
This repository includes an AI coding skill that teaches your AI agent (GitHub Copilot, Claude, Cursor, Windsurf, and 40+ others) the correct DBR SDK patterns. Just describe what you need and get working code instantly - ideal for quickly building a POC.
Install the skill after cloning this repository, run from the repo root:
npx skills add .This detects your installed AI agents and sets up the skill for all of them automatically. You can also target a specific agent:
npx skills add . -a claude-code npx skills add . -a cursor -a windsurf
Try it out - after installation, ask your AI agent:
"Write a Python script that reads barcodes from a single image file and prints the format and text."
For manual setup per agent, example prompts, and more details, see the skill documentation.
The library requires a license to work, you use the API LicenseManager.init_license to initialize license key and activate the SDK.
These samples use a free public trial license which require network connection to function. You can request a 30-day free trial license via the Request a Trial License link which works offline.