Skip to content

hellotool/VCFGeneratorLiteWithTkinter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

749 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
App icon

VCF Generator Lite with Tkinter

Repositories: Gitee primary repository GitHub secondary repository

Platforms: Windows 8.1+ (exe) Python 3.12+ (pyzw)

Languages: 简体中文 | English | More translations are welcome!

VCF Generator Lite is a simple and efficient tool that converts contact lists into a single vCard (.vcf) file. Generated files can be batch-imported into mobile phone contacts or used for various other purposes. Built with Python and Tkinter for a native desktop experience.

License Contributor Covenant

GitHub - Test GitHub - Release GitHub - Stars Gitee - Stars

Features

  • Smart Parsing: Recognizes contacts in the Name Phone Notes format, with automatic merging of tabs and spaces.
  • Batch Generation: Combines all contacts into a single .vcf file.
  • Number Validation: Automatically skips invalid numbers and quickly locates erroneous lines.
  • Editing Assistance: Displays line numbers in the text area, supports one-click quote removal.
  • Localization: Supports Simplified Chinese and English, with phone number recognition for China (including Hong Kong, Macau, and Taiwan regions).
  • Lightweight: Provided as a Python ZIP application package.
  • Free and Open Source: Licensed under Apache License 2.0, ad-free, no payment required.

Screenshots

Main window

Invalid Lines Window

Download & Installation

Download packages from the following channels:

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-<version>-win-amd64-setup.exe Windows Installer
Windows Portable Package No VCFGeneratorLite-<version>-win-amd64-portable.zip Windows Portable
Cross-platform Python Wheel Optional vcf_generator_lite-<version>-py3-none-any.whl Python Wheel
Cross-platform Python ZIP Application No VCFGeneratorLite-<version>-py3.pyzw Python ZIP App

Usage

  1. Paste your contacts in the format Name Phone Note into the text field. The note is optional.
    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 for details.

For more information, see User Documentation.

For system requirements, vCard compatibility, and known issues, see Compatibility.

Credits

AI Assistance

Parts of this project were generated with AI assistance:

  • Trae: Code generation, document optimization, code optimization, language translation.
  • Qoder: Code completion, document optimization, coding guidance.
  • 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.

Third-Party Notices

This project uses third-party open source code. For details, please refer to the NOTICES file.

More Documentation


Copyright © 2023-2026 Jesse205

About

A lightweight VCF creation tool written in Python.

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Contributors