{"id":29633000,"url":"https://github.com/blinkid/blinkid-capacitor","last_synced_at":"2025-07-21T13:37:54.813Z","repository":{"id":39801035,"uuid":"289884569","full_name":"BlinkID/blinkid-capacitor","owner":"BlinkID","description":"ID scanning for cross-platform apps built with Capacitor.","archived":false,"fork":false,"pushed_at":"2025-03-28T15:19:24.000Z","size":9371,"stargazers_count":12,"open_issues_count":6,"forks_count":3,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-06-27T13:18:14.583Z","etag":null,"topics":["android","capacitor","capacitor-plugin","cross-platform","id-card-camera","id-scanning","ionic","ios","javascript","kyc","machine-learning","onboarding","scanning-id-cards","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BlinkID.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2020-08-24T09:29:02.000Z","updated_at":"2025-05-24T09:48:34.000Z","dependencies_parsed_at":"2024-04-03T13:51:30.559Z","dependency_job_id":"2480a186-97aa-4778-8e14-029ac26c4345","html_url":"https://github.com/BlinkID/blinkid-capacitor","commit_stats":{"total_commits":116,"total_committers":10,"mean_commits":11.6,"dds":0.7068965517241379,"last_synced_commit":"192f01d3ba7772c140286d636aeba696976c8347"},"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/BlinkID/blinkid-capacitor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlinkID%2Fblinkid-capacitor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlinkID%2Fblinkid-capacitor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlinkID%2Fblinkid-capacitor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlinkID%2Fblinkid-capacitor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BlinkID","download_url":"https://codeload.github.com/BlinkID/blinkid-capacitor/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlinkID%2Fblinkid-capacitor/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266312789,"owners_count":23909752,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-21T11:47:31.412Z","response_time":64,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"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":["android","capacitor","capacitor-plugin","cross-platform","id-card-camera","id-scanning","ionic","ios","javascript","kyc","machine-learning","onboarding","scanning-id-cards","typescript"],"created_at":"2025-07-21T13:37:53.166Z","updated_at":"2025-07-21T13:37:54.799Z","avatar_url":"https://github.com/BlinkID.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BlinkID SDK Capacitor plugin\n\nAI-driven ID scanning software for cross-platform apps built with Capacitor. Keep in mind that for full access to all features and functionalities, you’ll be better off using one of our native SDKs ([iOS](https://github.com/BlinkID/blinkid-ios)\nand [Android](https://github.com/BlinkID/blinkid-android)). Not all features of native SDKs are available. However, the wrapper is open source so you can add the features that you need.\n\nDepending on your use case you can choose the recognizer that fits your needs:\n\n* BlinkIDSingleSide recognizer\n\t* Scans and extracts data from the front side of the document as well as any machine readable travel document (MRTD). View list of supported documents [here](https://github.com/BlinkID/blinkid-android/blob/master/documentation/BlinkIDRecognizer.md)\n* BlinkIDMultiSide recognizer\n\t* For scanning both sides of the supported document as well as any machine readable travel document. Passports and travel visas included. Here’s a [list of documents](https://github.com/BlinkID/blinkid-android/blob/master/documentation/BlinkIDRecognizer.md) that you can scan with BlinkID. For more details about the extracted fields click [here](https://github.com/BlinkID/blinkid-android/blob/master/documentation/BlinkIDRecognizerResult.md).\n* BlinkID IDBarcode recognizer\n\t* Extract data from various barcodes found on identity documents. You can find a list of supported documents [here](https://github.com/BlinkID/blinkid-android/blob/master/documentation/IdBarcodeRecognizer.md)\n\nBelow, you'll find everything you need to add BlinkID in your Capacitor iOS or Android app ⬇️\n\n## Minimum software requirements\n\nPackage depends on [BlinkID SDK](https://microblink.com/products/blinkid) and it is required to download and install [BlinkID iOS SDK](https://github.com/BlinkID/blinkid-ios) and [BlinkID Android SDK](https://github.com/BlinkID/blinkid-android). For more information on how to do that, please check our [Platform specifics](#platform-specifics) section.\n\n### Capacitor\n\nBlinkID plugin is developed with Capacitor version 6.1.1.\nFor help with Capacitor, view official [documentation](https://capacitorjs.com/docs).\n\n### iOS\n\nBlinkID Capacitor plugin supports iOS 13.0 or newer.\n\n### Android\n\nBlinkID Capacitor plugin support Android Android 5.1 (API level 22) or newer.\n\n## Getting Started\n\nTo get started, first create empty project if needed:\n\n```shell\nionic start project_name --capacitor\n```\n\nInstall blinkid-capacitor package:\n\n```shell\nnpm install --save @microblink/blinkid-capacitor\n```\n\n### Quick start with sample app\n\nSample app is built with latest [Ionic framework](https://ionicframework.com) and it uses [Angular](https://angular.io). To try BlinkID plugin, you can generate a minimal sample application. To do so run `./initIonicSampleApp.sh` script.\n\nTo run sample application:\n\n* iOS\n\t* Open the app in Xcode by running ```npx cap open ios``` from the sample app's root directory\n\t* Open info.plist and add corresponding permissions to the app\n\t\t* Privacy - Camera Usage Description: To Take Photos and Video\n\t* Open `Signing \u0026 Capabilities` and set your Team\n\t* Press `Run`\n\n* Android\n\t* Run the app by executing ```npx cap run android``` from the sample app's root directory\n\n### Plugin usage\n\n1. Import blinkid-capacitor package\n\n\t```typescript\n\timport * as BlinkID from '@microblink/blinkid-capacitor';\n\t```\n\n2. Initialize plugin\n\n\t```typescript\n\tconst plugin = new BlinkID.BlinkIDPlugin();\n\t```\n\t\n3. Perform scanning by calling the method `plugin.scanWithCamera()` and pass `RecognizerCollection`, `OverlaySettings` you wish to use and license keys. To find out more about licensing, click\n [here](#licensing).\n \n\t ```typescript\n\tasync scan() {\n\t\t \t\n\t \t// Initialize plugin\n\t\tconst plugin = new BlinkID.BlinkIDPlugin();\n\t\t\n\t\t// Initialize wanted recognizer\n\t\tconst blinkIdMultisideRecognizer = new BlinkID.BlinkIdMultiSideRecognizer();\n        blinkIdMultisideRecognizer.returnFullDocumentImage = true;\n        blinkIdMultisideRecognizer.returnFaceImage = true;\n\t\n\t\t// Initialize license \n\t\tconst licenseKeys: BlinkID.License = {\n\t  \t\tios: '\u003cyour_ios_license\u003e',\n\t  \t\tandroid: '\u003cyour_android_license\u003e',\n\t  \t\tshowTimeLimitedLicenseKeyWarning: true\n\t\t};\n\t\t\n\t\t// Perform scan and gather results\n\t\tconst scanningResults = await plugin.scanWithCamera(\n\t\t\tnew BlinkID.BlinkIdOverlaySettings(),\n\t\t\tnew BlinkID.RecognizerCollection([blinkIdMultisideRecognizer]),\n\t\t\tlicenseKeys\n\t\t);\n  \t}\n\t ```\n\t\n4. When scanning is completed, variable `scanningResults` will contain a list of non-empty `RecognizerResults` from recognizers set in `RecognizerCollection`. You can then access each result individually. If the scanning is manually closed, the method will return an empty list.\n\nFor more information please refer to our sample files in [SampleFiles folder](https://github.com/BlinkID/blinkid-capacitor/tree/master/SampleFiles) and  sample application source code.\n\n### Available API\n\nAll available recognizers can be found inside `BlinkID/src/recognizers`.\n\nAll available overlays can be found inside `BlinkID/src/overlays`.\n\n### Platform specifics\n\nPlugin implementation is in folder `src`, while platform specific implementations are in `android` and `ios` folders.\n\n#### iOS\n\nTo initialize BlinkID framework for use with iOS, after you've added the dependency to `@microblink/blinkid-capacitor` to your project, go to `NameOfYourProject/ios`and run `pod install`.\nOur `@microblink/blinkid-capacitor` depends on the latest [PPBlinkID pod](https://cocoapods.org/pods/PPBlinkID) so it will be installed automatically.\n\n#### Android\n\nBlinkID plugin on Android is ready to use after you've added the dependency.\n\n\n## Licensing\n\n- A valid license key is required to initialize scanning. You can request a **free trial license key**, after you register, at [Microblink Developer Hub](https://account.microblink.com/signin)\n- Get information about pricing and licensing of [BlinkID](https://microblink.com/blinkid)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblinkid%2Fblinkid-capacitor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblinkid%2Fblinkid-capacitor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblinkid%2Fblinkid-capacitor/lists"}