Skip to content

Latest commit

 

History

775 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 application 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 application.

License Contributor Covenant

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

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

Main window

Invalid Lines Window

Download and 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 box. 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

Code of conduct

Contributing

Stars

1 star

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages