{"id":15036190,"url":"https://github.com/wetransfer/wescan","last_synced_at":"2025-05-14T10:06:58.777Z","repository":{"id":30955237,"uuid":"123019725","full_name":"WeTransfer/WeScan","owner":"WeTransfer","description":"Document Scanning Made Easy for iOS","archived":false,"fork":false,"pushed_at":"2024-09-10T17:54:26.000Z","size":17459,"stargazers_count":2851,"open_issues_count":3,"forks_count":555,"subscribers_count":68,"default_branch":"master","last_synced_at":"2024-10-29T15:38:21.188Z","etag":null,"topics":["ios","scanner","swift","wt-branch-protection-exempt","wt-branch-protection-two-approvals"],"latest_commit_sha":null,"homepage":"","language":"Swift","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/WeTransfer.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-26T19:30:05.000Z","updated_at":"2024-10-29T02:43:53.000Z","dependencies_parsed_at":"2024-11-19T04:15:39.109Z","dependency_job_id":"81f0105a-1a84-4885-b3a9-d033f6d55982","html_url":"https://github.com/WeTransfer/WeScan","commit_stats":{"total_commits":556,"total_committers":56,"mean_commits":9.928571428571429,"dds":0.6025179856115108,"last_synced_commit":"08e8a06efd37a3d017da8d0f064fe3b8669d3c4b"},"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WeTransfer%2FWeScan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WeTransfer%2FWeScan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WeTransfer%2FWeScan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WeTransfer%2FWeScan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WeTransfer","download_url":"https://codeload.github.com/WeTransfer/WeScan/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247954204,"owners_count":21024181,"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","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":["ios","scanner","swift","wt-branch-protection-exempt","wt-branch-protection-two-approvals"],"created_at":"2024-09-24T20:30:27.562Z","updated_at":"2025-04-09T01:23:28.503Z","avatar_url":"https://github.com/WeTransfer.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WeScan\n\n\u003cp align=\"center\"\u003e\n    \u003cimg width=\"900px\" src=\"Assets/WeScan-Banner.jpg\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://app.bitrise.io/app/df00af454f27891d.svg?token=spjxNvzjnRqug6GfGM3_Lg\"/\u003e\n\u003cimg src=\"https://img.shields.io/cocoapods/l/WeScan.svg?style=flat\"/\u003e\n\u003cimg src=\"https://img.shields.io/cocoapods/p/WeScan.svg?style=flat\"/\u003e\n\u003cimg src=\"https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat\"/\u003e\n\u003cimg src=\"https://img.shields.io/badge/License-MIT-yellow.svg?style=flat\"/\u003e\n\u003c/p\u003e\n\n**WeScan** makes it easy to add scanning functionalities to your iOS app!\nIt's modelled after `UIImagePickerController`, which makes it a breeze to use.\n\n- [Features](#features)\n- [Demo](#demo)\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Features\n\n- [x] Fast and lightweight\n- [x] Live scanning of documents\n- [x] Edit detected rectangle\n- [x] Auto scan and flash support\n- [x] Support for both PDF and UIImage\n- [x] Translated to English, Chinese, Italian, Portuguese, and French\n- [ ] Batch scanning\n\n## Demo\n\n\u003cp align=\"left\"\u003e\n    \u003cimg width=\"350px\" src=\"Assets/WeScan.gif\"\u003e\n\u003c/p\u003e\n\n## Requirements\n\n- Swift 5.0\n- iOS 10.0+\n\n\u003cbr\u003e\n\n## Installation\n\n### Swift Package Manager\n\nThe [Swift Package Manager](https://swift.org/package-manager/) is a tool for automating the distribution of Swift code and is integrated into the `swift` compiler. It is in early development, but WeScan does support its use on supported platforms.\n\nOnce you have your Swift package set up, adding WeScan as a dependency is as easy as adding it to the `dependencies` value of your `Package.swift`.\n\n```swift\ndependencies: [\n    .package(url: \"https://github.com/WeTransfer/WeScan.git\", .upToNextMajor(from: \"2.1.0\"))\n]\n```\n\n## Usage\n\n### Swift\n\n1. In order to make the framework available, add `import WeScan` at the top of the Swift source file\n\n2. In the Info.plist, add the `NSCameraUsageDescription` key and set the appropriate value in which you have to inform the user of the reason to allow the camera permission\n\n3. Make sure that your view controller conforms to the `ImageScannerControllerDelegate` protocol:\n\n```swift\nclass YourViewController: UIViewController, ImageScannerControllerDelegate {\n    // YourViewController code here\n}\n```\n\n4. Implement the delegate functions inside your view controller:\n```swift\nfunc imageScannerController(_ scanner: ImageScannerController, didFailWithError error: Error) {\n    // You are responsible for carefully handling the error\n    print(error)\n}\n\nfunc imageScannerController(_ scanner: ImageScannerController, didFinishScanningWithResults results: ImageScannerResults) {\n    // The user successfully scanned an image, which is available in the ImageScannerResults\n    // You are responsible for dismissing the ImageScannerController\n    scanner.dismiss(animated: true)\n}\n\nfunc imageScannerControllerDidCancel(_ scanner: ImageScannerController) {\n    // The user tapped 'Cancel' on the scanner\n    // You are responsible for dismissing the ImageScannerController\n    scanner.dismiss(animated: true)\n}\n```\n\n5. Finally, create and present a `ImageScannerController` instance somewhere within your view controller:\n\n```swift\nlet scannerViewController = ImageScannerController()\nscannerViewController.imageScannerDelegate = self\npresent(scannerViewController, animated: true)\n```\n\n### Objective-C\n\n1. Create a dummy swift class in your project. When Xcode asks if you'd like to create a bridging header, press 'Create Bridging Header'\n2. In the new header, add the Objective-C class (`#import myClass.h`) where you want to use WeScan\n3. In your class, import the header (`import \u003cyourProjectName.swift.h\u003e`)\n4. Drag and drop the WeScan folder to add it to your project\n5. In your class, add `@Class ImageScannerController;`\n\n#### Example Implementation\n\n```objc\nImageScannerController *scannerViewController = [[ImageScannerController alloc] init];\n[self presentViewController:scannerViewController animated:YES completion:nil];\n```\n\n\u003cbr\u003e\n\n## Contributing\n\nAs the creators, and maintainers of this project, we're glad to invite contributors to help us stay up to date. Please take a moment to review [the contributing document](CONTRIBUTING.md) in order to make the contribution process easy and effective for everyone involved.\n\n- If you **found a bug**, open an [issue](https://github.com/WeTransfer/WeScan/issues).\n- If you **have a feature request**, open an [issue](https://github.com/WeTransfer/WeScan/issues).\n- If you **want to contribute**, submit a [pull request](https://github.com/WeTransfer/WeScan/pulls).\n\n\u003cbr\u003e\n\n## License\n\n**WeScan** is available under the MIT license. See the [LICENSE](https://github.com/WeTransfer/WeScan/blob/develop/LICENSE) file for more info.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwetransfer%2Fwescan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwetransfer%2Fwescan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwetransfer%2Fwescan/lists"}