# VCF 生成器 轻量版 - Tkinter
**Repository Path**: hellotool/VCFGeneratorLiteWithTkinter
## Basic Information
- **Project Name**: VCF 生成器 轻量版 - Tkinter
- **Description**: 使用 Python 编写的轻量的 VCF 制作工具。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 6
- **Forks**: 0
- **Created**: 2023-04-21
- **Last Updated**: 2026-11-13
## Categories & Tags
**Categories**: Uncategorized
**Tags**: Python, vcf, 通讯录, tkinter, APP
## README

# Hello VCF Generator Lite 
**Repositories**:
[][repository-gitee]
[][repository-github]
**Platforms**:
[][release-gitee]
[][release-gitee]
**Languages**:
[简体中文](./README.zh-CN.md) |
**English** |
More translations are welcome!
VCF Generator Lite is a simple and efficient desktop tool that converts contact lists into a single vCard (`.vcf`) file, making it easy to batch import contacts into your phone's address book, email, or other contact applications.
Built with Python and Tkinter for a native desktop application.

[](./LICENSE)
[](./CODE_OF_CONDUCT.md)
[][workflow-test]
[][release-github]

[][stargazers-gitee]
## Features
### Core Features
- **Smart Parsing**: Auto-recognizes and parses `Name Phone Notes` format; multiple spaces merged automatically.
- **Regional Support**: Covers phone number rules for Mainland China, Hong Kong, Macau, and Taiwan.
- **Editing Aids**: Built-in line numbers; one-click removal of cell quotes.
- **Number Validation**: Filters invalid numbers and jumps to the offending line for quick fixes.
- **Batch Export**: Merges all contacts into a single `.vcf` file.
- **Massive Scale**: Handles millions of contacts per run, limited only by available memory.
### UI & Interaction
- **Native Look**: Layout follows Windows 7 design guidelines, styled by the OS.
- **UI Scaling**: Auto-adapts to high DPI and system scaling, crisp on high-res displays.
- **Multi-Monitor Ready**: Child windows follow the parent and stay fully within the current display.
- **Multilingual**: Built-in Chinese and English UI, switching automatically with system language.
### Distribution, Licensing & Privacy
- **Extremely Lightweight**: Minimal dependencies, the Python ZIP app is under 100KB, download and run.
- **Completely Free**: All features free forever, no registration or payment.
- **Clean and Distraction-Free**: No ads, no bundles, no promotions.
- **No Disk Logs**: Logs go to stdout only, nothing is written to disk.
- **Open Source**: Licensed under Apache License 2.0, free to modify, distribute, and use commercially.
## Use Cases
- **Corporate Directory Distribution**: HR or admin staff bulk-import the company directory into employees' phones.
- **Event Participant Contacts**: Organizers of meetings, training, or team-building events quickly share attendee contacts.
- **Client Data Migration**: Sales and support staff bulk-migrate client contacts when switching phones or devices.
- **Data Migration**: Export contacts from Excel, legacy systems, or other formats to a new phone.
- **School-Home Contact Distribution**: Teachers or administrators share student and parent contacts for a class.
## Screenshots
## Download and Installation
Download packages from the following channels:
- [Gitee Releases][release-gitee]
- [GitHub Releases][release-github]
Select a package for your platform and click the guide for detailed installation instructions:
| Platform | Package Type | Installation Required | File | Guide |
| -------------- | ---------------------- | --------------------- | --------------------------------------------------------- | -------------------------------------------------------------------- |
| Windows | Installer | Yes | VCFGeneratorLite-\-**win-amd64**-*setup.exe* | [Windows Installer](./docs/guides/installation/windows-installer.md) |
| Windows | Portable Package | No | VCFGeneratorLite-\-**win-amd64**-*portable.zip* | [Windows Portable](./docs/guides/installation/windows-portable.md) |
| Cross-platform | Python Wheel | Optional | vcf_generator_lite-\-**py3-none-any**.*whl* | [Python Wheel](./docs/guides/installation/wheel.md) |
| Cross-platform | Python ZIP Application | No | VCFGeneratorLite-\-**py3**.*pyzw* | [Python ZIP App](./docs/guides/installation/zipapp.md) |
From v6.0.2 onward, all release artifacts have build provenance attestations issued on GitHub. No matter where you download them from, you can use the GitHub CLI to verify a file's build provenance (requires access to GitHub):
```bash
gh attestation verify -o hellotool --signer-workflow hellotool/VCFGeneratorLiteWithTkinter/.github/workflows/build.yml
```
## Usage
1. Paste your contacts in the format `Name Phone Note` into the text box. The note is optional.
```text
Qu Yuan 13333333333 Poet of the Warring States period
Cao Cao 13444444444
Tao Y.M. 13555555555
Xie Lingyun 13666666666
```
2. Click **Generate**, select a path to save the file.
3. You can use the generated vCard file wherever you need it. See [Using vCard Files](./docs/guides/vcard-usage.md) for details.
For more information, see [User Documentation](./docs/index.md).
For system requirements, vCard compatibility, and known issues, see [Compatibility](./docs/reference/compatibility.md).
## Credits
### AI Assistance
Parts of this project were generated with AI assistance:
- **Qoder**: Code generation, document optimization, coding guidance, language translation
- **Trae**: Code generation, document optimization, code optimization, language translation
- **DeepSeek**: Coding guidance, code generation, document optimization, language translation
- **Yuanbao**: Coding guidance, code generation, language translation
- **WorkBuddy**: Code review, document optimization
- **OpenCode**: Document optimization
## License
This project is licensed under the Apache 2.0 license. For details, please refer to the [LICENSE file](./LICENSE).
## Third-Party Notices
This project uses third-party open source code. For details, please refer to the [NOTICES file](./NOTICES.md).
## More Documentation
- [Contribution Guidelines](./CONTRIBUTING.md)
- [Development (Chinese)](./docs/dev/index.md)
- [User Documentation (Chinese)](./docs/index.md)
---
Copyright © 2023-2026 Jesse205
[repository-gitee]: https://gitee.com/hellotool/VCFGeneratorLiteWithTkinter/
[repository-github]: https://github.com/hellotool/VCFGeneratorLiteWithTkinter/
[release-gitee]: https://gitee.com/hellotool/VCFGeneratorLiteWithTkinter/releases/latest
[release-github]: https://github.com/hellotool/VCFGeneratorLiteWithTkinter/releases/latest
[stargazers-gitee]: https://gitee.com/hellotool/VCFGeneratorLiteWithTkinter/stargazers
[workflow-test]: https://github.com/hellotool/VCFGeneratorLiteWithTkinter/actions/workflows/test.yml