VCF Generator Lite

Repositories:

Platforms:

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

VCF Generator Lite is a lightweight tool that quickly converts name and phone number lists into vCard files for batch import to mobile contacts.

Features

• Smart Parsing: Batch contacts in Name Phone Note format (note optional), automatically handles tabs and spaces.
• Batch Generation: Combines all contacts into a single .vcf file.
• Number Validation: Automatically skips invalid numbers and quickly locates error rows.
• Editing Assistance: Displays line numbers in text area, supports one-click quote removal.

Screenshots

Get the App

Download the Packages

Download the software from the following channels:

• Gitee Releases
• GitHub Releases

Users of different systems need to download different files. You can make your selection according to the table below:

Platform	Package Type	File
Windows	Installer	VCFGeneratorLite-<version>-win-amd64-setup.exe
Windows	Portable	VCFGeneratorLite-<version>-win-amd64-portable.zip
Cross-platform	Python ZIP Application	VCFGeneratorLite-<version>-py3.pyzw

Usage

1. Copy the name and phone number in the format of Name Phone Note on each line into the text field below. The note can be omitted.

   Isaac Newton	13445467890	British mathematician
   Muhammad		13554678907
   Confucius		13645436748
   

2. Click Generate, select a path to save the file.
3. You can use the generated vCard file wherever you need it. For details, please refer to Using vCard Files below.

Note

• Tabs will be automatically converted to spaces, and you can use both tabs and spaces to separate the name and phone number.
• The program will automatically remove extra spaces from the text field.

For example, Han Meimei 13333333333 A well-known girl will be recognized as

• Name: Han Meimei
• Phone: 13333333333
• Note: A well-known girl

Using vCard Files

Import to Mobile Contacts

1. Transfer the vCard file to your phone.
2. Open the vCard file and select Contacts, then follow the prompts.
3. Wait for the import to complete.

Import to QQ Mail

1. Open the new version of the QQ Mail website.
2. In the sidebar, select Apps > Contacts, then choose Manage > Import contacts.
3. In the dialog box that appears, click the Select File button and select your vCard file.
4. Click Start to import.

Import to Lark

1. Open the Lark client.
2. In the sidebar, select Contacts > Email Contacts, then choose the Add > Import contacts button.
3. In the dialog box that appears, select or drag your vCard file.
4. Click Import.

Compatibility

System Requirements

Software Package Type	System Requirements
Windows Installer & Portable	Windows 8.1 or later
Python ZIP Application	Python 3.12 or later, Tkinter

If you wish to use this application on Windows 8 or earlier versions, please see Running on Older Windows.

On Windows systems, to launch the Python Zip Application by double-clicking, you need to install either the Python Launcher or Python Install Manager.

Features Compatibility

System Environment	Feature	Details
Windows 10 or later	Dark Mode	Dark mode not supported
Windows 10 or later	Display Scaling	Display scaling adaptation is handled by the OS when switching DPI

If you want to use dark mode in Windows, you can enable high contrast mode, or use Rectify11 or other third-party tools to modify the system theme.

File Compatibility

• vCard Version: 2.1
• Supported Fields: Name, Phone Number, Note
• Known Issues:
  • Windows Contacts: May display garbled characters in non-UTF-8 environments.

License

This project is licensed under the Apache 2.0 license. For details, please refer to the LICENSE file.

Copyright 2023-2026 Jesse205

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Thanks

• AI Coding Assistants: Parts of the code and test code in this project were generated with the assistance of AI coding assistants.
  • DeepSeek
  • Tongyi Lingma
• Open Source Code: This project uses some open source code. For details, please see Open Source Notices (Chinese).

More Documentation

• Development Guide (Chinese)
• Contribution Guide (Chinese)
• FAQ (Chinese)