Skip to content

Repository files navigation

BusinessCardScannerVer3

BusinessCardScannerVer3 is an open-source Swift iOS project for scanning business cards and turning them into structured contact information.

Overview

This project is aimed at building a practical business card scanning workflow on iOS, including image capture, recognition, parsing, and contact data organization. It is currently in an early public stage and is being actively maintained and improved.

Goals

  • Scan business cards on iOS
  • Extract useful contact information from card images
  • Organize parsed content into a structured format
  • Improve maintainability and code quality over time
  • Provide an open Swift codebase for learning and iteration

Tech Stack

  • Swift
  • iOS
  • Xcode

Current Status

This repository is still in an early stage. Public adoption is limited for now, but the project is under active development and maintenance.

Current work includes:

  • improving code structure
  • refining scanning and parsing workflows
  • preparing the project for broader reuse
  • improving documentation and release readiness

Why Open Source

The project is open source so that the implementation can be improved transparently over time and potentially become useful to other iOS developers working on scanning, OCR, or contact extraction workflows.

Roadmap

  • Improve scanning flow and reliability
  • Improve extracted field accuracy and structure
  • Refactor core modules for maintainability
  • Add clearer documentation
  • Publish tagged releases

Contributing

Issues and suggestions are welcome. Contributions may be opened up further as the project structure and documentation continue to improve.

Security

Business-card images and OCR text are treated as untrusted input.

AI-assisted parsing sends OCR text to an external AI service when configured. The project applies input boundaries, output validation, and secure credential storage to reduce prompt-injection, malformed-output, and credential risks.

Please see SECURITY.md for vulnerability reporting.

License

MIT License

Copyright (c) 2026 Gao Bob

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

About

An open-source Swift iOS app for scanning business cards and structuring contact information.

Topics

Resources

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages