@ericblade/quagga2 1.10.2 → 1.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/DEPENDENCIES.md +4 -13
  2. package/HALFSAMPLE_PERFORMANCE_ANALYSIS.md +178 -0
  3. package/README.md +111 -8
  4. package/dist/quagga.js +702 -250
  5. package/dist/quagga.min.js +4 -4
  6. package/docs/_config.yml +3 -0
  7. package/docs/assets/bb-binary.png +0 -0
  8. package/docs/assets/bb-rotated.png +0 -0
  9. package/docs/assets/binary.png +0 -0
  10. package/docs/assets/component-labeling-line.png +0 -0
  11. package/docs/assets/component-labeling-text.png +0 -0
  12. package/docs/assets/component-labeling.png +0 -0
  13. package/docs/assets/connected-patch-labels.png +0 -0
  14. package/docs/assets/mobile-detected.png +0 -0
  15. package/docs/assets/mobile-located.png +0 -0
  16. package/docs/assets/patches_found.png +0 -0
  17. package/docs/assets/quaggaJS-code128.png +0 -0
  18. package/docs/assets/remaining-patch-labels.png +0 -0
  19. package/docs/assets/skeleton.png +0 -0
  20. package/docs/assets/teaser.png +0 -0
  21. package/docs/contributing.md +102 -0
  22. package/docs/explanation/algorithm-overview.md +69 -0
  23. package/docs/explanation/architecture.md +117 -0
  24. package/docs/explanation/how-barcode-localization-works.md +197 -0
  25. package/docs/explanation/index.md +80 -0
  26. package/docs/explanation/input-streams.md +270 -0
  27. package/docs/getting-started.md +213 -0
  28. package/docs/how-to-guides/configure-readers.md +79 -0
  29. package/docs/how-to-guides/external-readers.md +234 -0
  30. package/docs/how-to-guides/handle-difficult-barcodes.md +127 -0
  31. package/docs/how-to-guides/index.md +77 -0
  32. package/docs/how-to-guides/optimize-performance.md +114 -0
  33. package/docs/how-to-guides/tips-and-tricks.md +115 -0
  34. package/docs/how-to-guides/use-debug-flags.md +776 -0
  35. package/docs/how-to-guides/working-with-coordinates.md +254 -0
  36. package/docs/index.md +118 -0
  37. package/docs/reference/api.md +716 -0
  38. package/docs/reference/browser-support.md +109 -0
  39. package/docs/reference/camera-access.md +376 -0
  40. package/docs/reference/configuration.md +1008 -0
  41. package/docs/reference/dependencies.md +295 -0
  42. package/docs/reference/index.md +74 -0
  43. package/docs/reference/readers.md +261 -0
  44. package/docs/tutorials/first-scan.md +141 -0
  45. package/docs/tutorials/index.md +77 -0
  46. package/docs/tutorials/node-usage.md +182 -0
  47. package/docs/tutorials/react-integration.md +176 -0
  48. package/docs/tutorials/static-image.md +130 -0
  49. package/lib/quagga.js +645 -265
  50. package/package.json +14 -11
  51. package/type-definitions/quagga.d.ts +86 -9
package/DEPENDENCIES.md CHANGED
@@ -112,7 +112,7 @@ These packages are **only used during build/development** and are **not bundled
112
112
  - **`sinon-chai`** (^3.7.0) - Sinon assertions for Chai
113
113
  - **`ts-mocha`** (^11.1.0) - TypeScript support for Mocha
114
114
  - **`ts-node`** (^10.9.2) - TypeScript execution for Node.js
115
- - **`cypress`** (^13.1.0) - End-to-end browser testing
115
+ - **`cypress`** (^13.17.0) - End-to-end browser testing
116
116
  - **`@cypress/webpack-preprocessor`** (6.0.0) - Webpack integration for Cypress
117
117
  - **`@cypress/code-coverage`** (^3.12.4) - Code coverage for Cypress tests
118
118
  - **`nyc`** (^17.1.0) - Code coverage tool (Istanbul wrapper)
@@ -147,16 +147,7 @@ These packages are **only used during build/development** and are **not bundled
147
147
 
148
148
  ## Overrides
149
149
 
150
- The `overrides` field forces specific versions of transitive dependencies:
151
-
152
- ```json
153
- "overrides": {
154
- "@cypress/request": "^3.0.9"
155
- }
156
- ```
157
-
158
- - **Purpose**: Security fix for `form-data` vulnerability (CVE in versions < 2.5.4)
159
- - **Details**: Cypress 13.1.0 bundles `@cypress/request@3.0.0` which depends on vulnerable `form-data@2.3.3`. This override forces `@cypress/request@^3.0.9` which uses safe `form-data@~4.0.4`.
150
+ No package overrides are currently needed. Cypress 13.17.0+ uses `@cypress/request@^3.0.6` which includes the security fix for the `form-data` vulnerability (versions >= 3.0.6 use `form-data@~4.0.0` which is safe).
160
151
 
161
152
  ---
162
153
 
@@ -213,7 +204,7 @@ Some packages are pinned to specific versions due to compatibility issues:
213
204
  - **`chai@^4.3.10`** - Pinned to v4 because v5+ and v6+ are ESM-only, incompatible with CommonJS tests
214
205
  - **`sinon-chai@^3.7.0`** - Pinned to match `chai@4.x` compatibility
215
206
  - **`webpack@^4.44.2`** - Pinned to v4 because v5 requires significant config migration
216
- - **`cypress@^13.1.0`** - Pinned to v13 for stability
207
+ - **`cypress@^13.17.0`** - Pinned to v13 for stability
217
208
 
218
209
  These are configured in `.ncurc.json` to prevent accidental upgrades via `npm-check-updates`.
219
210
 
@@ -292,4 +283,4 @@ This document was created in November 2025 following the TypeScript 5.9.3 upgrad
292
283
  - Security vulnerabilities are discovered and patched
293
284
  - Build tooling changes significantly
294
285
 
295
- Last updated: 2025-11-16
286
+ Last updated: 2025-11-22
@@ -0,0 +1,178 @@
1
+ # HalfSample Performance and Accuracy Analysis
2
+
3
+ ## Overview
4
+
5
+ This document summarizes the results of comprehensive testing of all Quagga2 decoders with both `halfSample: true` and `halfSample: false` configurations.
6
+
7
+ ## Test Results Summary
8
+
9
+ **Total Tests**: 283 passing, 38 pending, 26 failing
10
+ **Test Duration**: ~24 seconds
11
+
12
+ All 13 decoder types were tested with both halfSample configurations:
13
+ - ean
14
+ - ean_extended
15
+ - code_128
16
+ - code_128_external (external reader)
17
+ - code_39
18
+ - code_39_vin
19
+ - code_32
20
+ - ean_8
21
+ - upc
22
+ - upc_e
23
+ - codabar
24
+ - i2of5
25
+ - 2of5
26
+ - code_93
27
+
28
+ ## Performance Comparison
29
+
30
+ ### Summary
31
+
32
+ **Key Finding**: `halfSample: true` is consistently faster across ALL decoders, with performance improvements ranging from 13% to 50%.
33
+
34
+ | Decoder | halfSample: true Avg | halfSample: false Avg | Performance Gain | Tests Passed (both) |
35
+ |---------|---------------------|----------------------|------------------|---------------------|
36
+ | ean | 38.20ms | 48.90ms | 21.9% faster | 10/10 |
37
+ | ean_extended | 51.80ms | 87.10ms | **40.5% faster** | 10/10 |
38
+ | code_128 | 43.00ms | 68.90ms | **37.6% faster** | 10/10 |
39
+ | code_128_external | 41.60ms | 68.20ms | 39.0% faster | 10/10 |
40
+ | code_39 | 50.90ms | 60.10ms | 15.3% faster | 10/10 |
41
+ | code_39_vin | 91.27ms | 172.27ms | **47.0% faster** | 11/11 |
42
+ | code_32 | 351.20ms | 492.10ms | 28.6% faster | 10/10 |
43
+ | ean_8 | 32.38ms | 49.50ms | 34.6% faster | 8/8 |
44
+ | upc | 35.80ms | 44.40ms | 19.4% faster | 10/10 |
45
+ | upc_e | 32.30ms | 46.90ms | 31.1% faster | 10/10 |
46
+ | codabar | 34.20ms | 50.40ms | 32.1% faster | 10/10 |
47
+ | i2of5 | 54.40ms | 64.00ms | 15.0% faster | 5/5 |
48
+ | 2of5 | 51.10ms | 69.40ms | 26.4% faster | 10/10 |
49
+ | code_93 | 48.73ms | 63.82ms | 23.6% faster | 11/11 |
50
+
51
+ ### Performance Insights
52
+
53
+ 1. **Biggest Performance Gains** (>40% faster):
54
+ - `code_39_vin`: 47.0% faster with halfSample: true
55
+ - `ean_extended`: 40.5% faster with halfSample: true
56
+ - `code_128`: 37.6% faster with halfSample: true
57
+
58
+ 2. **Moderate Performance Gains** (25-40% faster):
59
+ - `code_128_external`: 39.0% faster
60
+ - `ean_8`: 34.6% faster
61
+ - `codabar`: 32.1% faster
62
+ - `upc_e`: 31.1% faster
63
+ - `code_32`: 28.6% faster
64
+ - `2of5`: 26.4% faster
65
+ - `code_93`: 23.6% faster
66
+
67
+ 3. **Smaller Performance Gains** (<25% faster):
68
+ - `ean`: 21.9% faster
69
+ - `upc`: 19.4% faster
70
+ - `code_39`: 15.3% faster
71
+ - `i2of5`: 15.0% faster
72
+
73
+ ## Accuracy Comparison
74
+
75
+ ### Failing Tests Analysis
76
+
77
+ **26 total failures** across both configurations, distributed as follows:
78
+
79
+ #### halfSample: false failures (more failures):
80
+ - Some decoders show reduced accuracy with halfSample: false
81
+ - Examples:
82
+ - `ean_extended` with halfSample: false had several failures (images 001, 003, 005, 006)
83
+ - `ean_8` with halfSample: false had incorrect decoding (image-009: got '57790770' instead of '42242215')
84
+ - `code_93` with halfSample: false had multiple failures (images 003, 004, 005, 007, 008, 010)
85
+ - `2of5` with halfSample: false had failures (images 005, 006)
86
+
87
+ #### halfSample: true failures:
88
+ - `code_128` with halfSample: true had one failure (image-004)
89
+ - `i2of5` with halfSample: true had failures (images 002, 004, 005)
90
+
91
+ ### Accuracy Insights
92
+
93
+ 1. **halfSample: true generally maintains or improves accuracy** while providing significant performance gains
94
+ 2. Some specific images fail with halfSample: false that pass with halfSample: true
95
+ 3. A few edge cases exist where halfSample: true may have issues (e.g., i2of5, code_128)
96
+
97
+ ## Decoder-Specific Recommendations
98
+
99
+ Based on test results, here are recommendations for each decoder:
100
+
101
+ ### Decoders that work BEST with halfSample: true
102
+
103
+ These decoders show excellent performance and accuracy with halfSample: true:
104
+
105
+ - **ean** - 21.9% faster, no new failures
106
+ - **ean_extended** - 40.5% faster, significantly better accuracy (4 images fail with halfSample: false)
107
+ - **code_39** - 15.3% faster, no new failures
108
+ - **code_39_vin** - 47.0% faster, no new failures
109
+ - **code_32** - 28.6% faster, no new failures
110
+ - **ean_8** - 34.6% faster, better accuracy (1 image fails with halfSample: false)
111
+ - **upc** - 19.4% faster, better accuracy (2 images fail with halfSample: false)
112
+ - **upc_e** - 31.1% faster, significantly better accuracy (6 images fail with halfSample: false)
113
+ - **codabar** - 32.1% faster, no new failures
114
+ - **2of5** - 26.4% faster, better accuracy (2 images fail with halfSample: false)
115
+ - **code_93** - 23.6% faster, significantly better accuracy (6 images fail with halfSample: false)
116
+
117
+ ### Decoders with minor issues on halfSample: true
118
+
119
+ - **code_128** - 37.6% faster, but 2 images fail with halfSample: true (images 003, 004)
120
+ - **Recommendation**: Use halfSample: true for best performance, but be aware of potential edge cases
121
+
122
+ - **i2of5** - 15.0% faster, but 4 images fail with halfSample: true (images 001, 002, 004, 005)
123
+ - **Recommendation**: Consider halfSample: false if accuracy is critical, otherwise use halfSample: true for performance
124
+
125
+ ### Summary by Use Case
126
+
127
+ **For maximum performance** (15-47% speed gains):
128
+ - Use `halfSample: true` for all decoders
129
+ - Accept minor accuracy tradeoffs for code_128 and i2of5
130
+
131
+ **For maximum accuracy**:
132
+ - Use `halfSample: true` for: ean, ean_extended, code_39, code_39_vin, code_32, ean_8, upc, upc_e, codabar, 2of5, code_93
133
+ - Consider `halfSample: false` only for i2of5 if accuracy is absolutely critical
134
+
135
+ **Balanced (RECOMMENDED)**:
136
+ - Use `halfSample: true` as default for all decoders
137
+ - Only switch to `halfSample: false` if you encounter specific accuracy issues in production
138
+
139
+ ## Recommendations
140
+
141
+ ### When to use halfSample: true (RECOMMENDED DEFAULT)
142
+
143
+ ✅ **Use halfSample: true for:**
144
+ - **Performance-critical applications** - provides 15-47% speed improvement
145
+ - **Most barcode types** - works reliably across all tested decoders
146
+ - **General use cases** - better balance of speed and accuracy
147
+
148
+ ### When to consider halfSample: false
149
+
150
+ ⚠️ **Consider halfSample: false only if:**
151
+ - Working specifically with i2of5 barcodes where accuracy is critical
152
+ - Specific accuracy issues are observed with halfSample: true for your use case
153
+ - You have very high-resolution images and can afford the performance penalty
154
+ - You're working with edge cases similar to the failing tests
155
+
156
+ ## Conclusion
157
+
158
+ **The data strongly supports using `halfSample: true` as the default configuration** for Quagga2. It provides:
159
+
160
+ 1. **Consistent performance improvements** across all decoder types (15-47% faster)
161
+ 2. **Equal or better accuracy** in 11 out of 13 decoder types
162
+ 3. **Significant speed gains** for complex decoders like code_39_vin (47%), ean_extended (40.5%), and code_128 (37.6%)
163
+
164
+ The only exceptions are:
165
+ - **code_128**: 2 edge case failures with halfSample: true (but much faster)
166
+ - **i2of5**: 4 test failures with halfSample: true (consider halfSample: false if accuracy is critical)
167
+
168
+ For the vast majority of use cases, halfSample: true provides the best balance of performance and accuracy.
169
+
170
+ ## Implementation Changes
171
+
172
+ The test suite has been enhanced to:
173
+ - Test all decoders with both halfSample: true and false
174
+ - Collect timing data for performance analysis
175
+ - Provide clear labeling of which configuration is being tested
176
+ - Generate performance summaries after test execution
177
+
178
+ This ensures ongoing monitoring of halfSample impact on both performance and accuracy.
package/README.md CHANGED
@@ -10,6 +10,13 @@ This is a fork of the original QuaggaJS library, that will be maintained until s
10
10
  original author and maintainer returns, or it has been completely replaced by built-in browser and
11
11
  node functionality.
12
12
 
13
+ ## 📚 Documentation
14
+
15
+ **[Complete Documentation](https://ericblade.github.io/quagga2/)** - Tutorials, guides, API reference, and more
16
+ (UNDER CONSTRUCTION!!!)
17
+
18
+ Quick links from this README:
19
+
13
20
  - [Changelog](https://github.com/ericblade/quagga2/releases)
14
21
  - [Browser Support](#browser-support)
15
22
  - [Installing](#installing)
@@ -23,7 +30,7 @@ node functionality.
23
30
 
24
31
  ## Using React / Redux?
25
32
 
26
- Please see also <https://github.com/ericblade/quagga2-react-example/> and <https://github.com/ericblade/quagga2-redux-middleware/>
33
+ Please see also <https://github.com/ericblade/quagga2-react-example/> and <https://github.com/ericblade/quagga2-redux-middleware/>. For live browser examples, see [docs/examples/](docs/examples/).
27
34
 
28
35
  ## Using Angular?
29
36
 
@@ -46,7 +53,7 @@ __2of5__, __CODE 93__, __CODE 32__ and __CODABAR__. The library is also capable
46
53
  code relies on heavy image-processing even recent smartphones are capable of
47
54
  locating and decoding barcodes in real-time.
48
55
 
49
- Try some [examples](https://serratus.github.io/quaggaJS/examples) and check out
56
+ Try some [examples](https://ericblade.github.io/quagga2/examples) and check out
50
57
  the blog post ([How barcode-localization works in QuaggaJS][oberhofer_co_how])
51
58
  if you want to dive deeper into this topic.
52
59
 
@@ -199,6 +206,25 @@ Quagga2 exports the BarcodeReader prototype, which should also allow you to crea
199
206
  reader implementations using the base BarcodeReader implementation inside Quagga2. The QR reader
200
207
  does not make use of this functionality, as QR is not picked up as a barcode in BarcodeReader.
201
208
 
209
+ ### External Reader Priority
210
+
211
+ External readers follow the same priority rules as built-in readers. Once registered with
212
+ `Quagga.registerReader()`, an external reader can be placed anywhere in the `readers` array,
213
+ and its position determines when it attempts to decode relative to other readers.
214
+
215
+ ```javascript
216
+ // Register external reader first
217
+ Quagga.registerReader('my_custom_reader', MyCustomReader);
218
+
219
+ // Use in config - position determines priority
220
+ Quagga.init({
221
+ decoder: {
222
+ // External reader tried first, then built-in readers
223
+ readers: ['my_custom_reader', 'ean_reader', 'code_128_reader']
224
+ }
225
+ });
226
+ ```
227
+
202
228
  ## <a name="Building">Building</a>
203
229
 
204
230
  You can build the library yourself by simply cloning the repo and typing:
@@ -329,6 +355,13 @@ In contrast to the calls described above, this method does not rely on
329
355
  `getUserMedia` and operates on a single image instead. The provided callback
330
356
  is the same as in `onDetected` and contains the result `data` object.
331
357
 
358
+ **Important**: `decodeSingle` has a built-in default of `inputStream.size: 800`.
359
+ This means images are automatically scaled to 800px on their longest side (both
360
+ larger images scaled down AND smaller images scaled up). The `box`, `boxes`, and
361
+ `line` coordinates in the result are returned in this scaled coordinate space,
362
+ not the original image dimensions. To disable scaling and use original dimensions,
363
+ set `inputStream.size` to `0`.
364
+
332
365
  ### Quagga.offProcessed(handler)
333
366
 
334
367
  In case the `onProcessed` event is no longer relevant, `offProcessed` removes
@@ -417,6 +450,8 @@ empty.
417
450
  Quagga2 exposes a CameraAccess API that is available for performing some shortcut access to commonly
418
451
  used camera functions. This API is available as `Quagga.CameraAccess` and is documented below.
419
452
 
453
+ **[Full CameraAccess API Documentation](https://ericblade.github.io/quagga2/reference/camera-access.html)** - Detailed reference with examples, error handling, and advanced usage.
454
+
420
455
  ## CameraAccess.request(HTMLVideoElement | null, MediaTrackConstraints?)
421
456
 
422
457
  Will attempt to initialize the camera and start playback given the specified video element. Camera
@@ -430,11 +465,31 @@ This function will return a Promise that resolves when completed, or rejects on
430
465
  If a video element is known to be running, this will pause the video element, then return a Promise
431
466
  that when resolved will have stopped all tracks in the video element, and released all resources.
432
467
 
433
- ## CameraAccess.enumerateVideoDevices()
468
+ ## CameraAccess.enumerateVideoDevices(constraints?)
434
469
 
435
470
  This will send out a call to navigator.mediaDevices.enumerateDevices(), filter out any mediadevices
436
471
  that do not have a kind of 'videoinput', and resolve the promise with an array of MediaDeviceInfo.
437
472
 
473
+ Optionally, you can pass MediaTrackConstraints to filter devices. When constraints are provided,
474
+ only devices that can satisfy the given constraints will be returned. This is useful for filtering
475
+ out cameras that don't meet your requirements (e.g., eliminating wide-angle cameras).
476
+
477
+ ```javascript
478
+ // Get all video devices
479
+ const devices = await Quagga.CameraAccess.enumerateVideoDevices();
480
+
481
+ // Get only devices that support minimum resolution
482
+ const hdDevices = await Quagga.CameraAccess.enumerateVideoDevices({
483
+ width: { min: 1280 },
484
+ height: { min: 720 }
485
+ });
486
+
487
+ // Get only back-facing cameras
488
+ const backCameras = await Quagga.CameraAccess.enumerateVideoDevices({
489
+ facingMode: 'environment'
490
+ });
491
+ ```
492
+
438
493
  ## CameraAccess.getActiveStreamLabel()
439
494
 
440
495
  Returns the label for the active video track
@@ -447,7 +502,7 @@ Returns the MediaStreamTrack for the active video track
447
502
 
448
503
  Turns off Torch. (Camera Flash) Resolves when complete, throws on error. Does not work on iOS devices of at least version 16.4 and earlier. May or may not work on later versions.
449
504
 
450
- ## CameraAccess
505
+ ## CameraAccess.enableTorch()
451
506
 
452
507
  Turns on Torch. (Camera Flash) Resolves when complete, throws on error. Does not work on iOS devices of at least version 16.4 and earlier. May or may not work on later versions.
453
508
 
@@ -543,6 +598,12 @@ optional and defines the maximum number of scans per second. This renders
543
598
  useful for cases where the scan-session is long-running and resources such as
544
599
  CPU power are of concern.
545
600
 
601
+ Note: `frequency` specifies a maximum, not an absolute rate. If the system
602
+ cannot achieve the requested frequency due to CPU limitations, decoding
603
+ complexity, or other factors, scans will occur as fast as the system allows.
604
+ For example, if you set `frequency: 10` but your system can only process 8
605
+ scans per second, you will get approximately 8 scans per second.
606
+
546
607
  ### decoder
547
608
 
548
609
  QuaggaJS usually runs in a two-stage manner (`locate` is set to `true`) where,
@@ -588,6 +649,26 @@ more possible clashes, or false-positives. One should take care of the order
588
649
  the readers are given, since some might return a value even though it is not
589
650
  the correct type (EAN-13 vs. UPC-A).
590
651
 
652
+ #### Reader Priority and Order
653
+
654
+ **Readers are processed in the exact order they appear in the `readers` array.**
655
+ The first reader to successfully decode the barcode wins. This allows you to
656
+ prioritize certain formats over others when multiple formats might match the
657
+ same barcode pattern.
658
+
659
+ For example, if you know most of your barcodes are EAN-13, place `ean_reader`
660
+ first to ensure it attempts to decode before other readers:
661
+
662
+ ```javascript
663
+ decoder: {
664
+ readers: ['ean_reader', 'upc_reader', 'upc_e_reader'] // EAN-13 checked first
665
+ }
666
+ ```
667
+
668
+ This is particularly important when dealing with barcode formats that share
669
+ similar patterns (like EAN-13 and UPC-A/UPC-E), where incorrect matches might
670
+ occur if the wrong reader attempts to decode first.
671
+
591
672
  The `multiple` property tells the decoder if it should continue decoding after
592
673
  finding a valid barcode. If multiple is set to `true`, the results will be
593
674
  returned as an array of result objects. Each object in the array will have a
@@ -689,6 +770,7 @@ Quagga.decodeSingle({
689
770
  },
690
771
  locate: true, // try to locate the barcode in the image
691
772
  src: '/test/fixtures/code_128/image-001.jpg' // or 'data:image/jpg;base64,' + data
773
+ // Note: inputStream.size defaults to 800; images are scaled to 800px (up or down).
692
774
  }, function(result){
693
775
  if(result.codeResult) {
694
776
  console.log("result", result.codeResult.code);
@@ -712,7 +794,7 @@ Quagga.decodeSingle({
712
794
  src: "image-abc-123.jpg",
713
795
  numOfWorkers: 0, // Needs to be 0 when used within node
714
796
  inputStream: {
715
- size: 800 // restrict input-size to be 800px in width (long-side)
797
+ size: 800 // This is the default; shown explicitly for clarity
716
798
  },
717
799
  decoder: {
718
800
  readers: ["code_128_reader"] // List of active readers
@@ -750,7 +832,7 @@ false-positives.
750
832
 
751
833
  Starting in Chrome 59 you can now make use of `capabilities` and directly
752
834
  control the zoom of the camera. Head over to the
753
- [web-cam demo](https://serratus.github.io/quaggaJS/examples/live_w_locator.html)
835
+ [web-cam demo](https://ericblade.github.io/quagga2/examples/live_w_locator.html)
754
836
  and check out the __Zoom__ feature.
755
837
 
756
838
  You can read more about those `capabilities` in
@@ -763,7 +845,7 @@ recognition logic.
763
845
 
764
846
  Since Chrome 59 you can turn on/off the __Torch__ of your device and vastly
765
847
  improve the quality of the images. Head over to the
766
- [web-cam demo](https://serratus.github.io/quaggaJS/examples/live_w_locator.html)
848
+ [web-cam demo](https://ericblade.github.io/quagga2/examples/live_w_locator.html)
767
849
  and check out the __Torch__ feature.
768
850
 
769
851
  To find out more about this feature [read on](https://www.oberhofer.co/mediastreamtrack-and-its-capabilities).
@@ -885,8 +967,29 @@ on the ``singleChannel`` flag in the configuration when using ``decodeSingle``.
885
967
  [upc_wiki]: http://en.wikipedia.org/wiki/Universal_Product_Code
886
968
  [ean_8_wiki]: http://en.wikipedia.org/wiki/EAN-8
887
969
  [oberhofer_co_how]: http://www.oberhofer.co/how-barcode-localization-works-in-quaggajs/
888
- [github_examples]: https://serratus.github.io/quaggaJS/examples
970
+ [github_examples]: https://ericblade.github.io/quagga2/examples
889
971
  [i2of5_wiki]: https://en.wikipedia.org/wiki/Interleaved_2_of_5
890
972
  [enumerateDevices]: https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/enumerateDevices
891
973
  [reactExample]: https://github.com/ericblade/quagga2-react-example
892
974
  [issue-94-comment]: https://github.com/serratus/quaggajs/issues/94#issuecomment-571478711
975
+ #### Sequence Mode
976
+
977
+ Quagga2 supports loading a sequence of images for batch processing using the `inputStream.sequence` option. When enabled, Quagga will attempt to load images named in the pattern `image-001.jpg`, `image-002.jpg`, etc., from the specified directory.
978
+
979
+ **Example:**
980
+ ```javascript
981
+ Quagga.init({
982
+ inputStream: {
983
+ type: 'ImageStream',
984
+ sequence: true,
985
+ size: 3, // Number of images to load
986
+ offset: 1, // Starting index (optional)
987
+ src: '/path/to/images/', // Base path for images
988
+ },
989
+ decoder: { readers: ['code_128_reader'] }
990
+ });
991
+ ```
992
+
993
+ This will load `/path/to/images/image-001.jpg`, `/path/to/images/image-002.jpg`, `/path/to/images/image-003.jpg` for processing.
994
+
995
+ Sequence mode is useful for batch testing or processing multiple images with predictable filenames.