VCF Generator Lite

Repositories:

Platforms:

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.

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

Getting the App

Downloading the Packages

You can download the package through the following channels:

• Gitee Releases
• GitHub Releases

Please select the appropriate software package for your platform:

Platform	Package Type	Installation Required	File
Windows	Installer	Yes	VCFGeneratorLite-<version>-win-amd64-setup.exe
Windows	Portable Package	No	VCFGeneratorLite-<version>-win-amd64-portable.zip
Cross-platform	Python Wheel	Optional	vcf_generator_lite-<version>-py3-none-any.whl
Cross-platform	Python ZIP Application	No	VCFGeneratorLite-<version>-py3.pyzw

Using Python Wheel

Python Wheel (.whl) files are suitable for users familiar with the command line. It is recommended to run them in an isolated environment to avoid dependency conflicts.

Method 1: Temporary Execution (Simplest, No Installation Required)

Use uvx, which automatically creates a temporary environment and runs the program.

uvx <path-to-whl-file>

Note

uvx is the shorthand for uv tool run, provided by the uv tool.

Method 2: Install for Long-Term Use

Install using one of the tools below, which automatically create an isolated virtual environment without affecting your system Python.

# Using pipx
pipx install <path-to-whl-file>

# Or using uv
uv tool install <path-to-whl-file>

After installation, simply run the following command in your terminal:

vcf-generator-lite

Tip

If you haven't installed uv or pipx yet, please run pip install uv or pip install pipx first.

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

Note

• You can use both tabs and spaces to separate fields.
• The program will automatically remove extra spaces from the text field.

Example: Han Meimei 13333333333 A well-known girl will be recognized as

Name	Phone	Note
Han Meimei	13333333333	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 Package	Windows 8.1 or later
Python ZIP Application	Python 3.12 or later, Tkinter

If you need to use this application on Windows 8 or earlier versions, please see Running on older versions of Windows.

If you need to double-click to launch a Python ZIP application directly on Windows, please install Python Install Manager (recommended) or Python Launcher.

vCard Compatibility

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

Other Compatibility

System Environment	Issue	Description	Workaround
Windows 10 or later	Dark mode not supported	Tkinter has no built-in dark theme.	Use high contrast themes or modify the system theme with third-party tools (e.g., Rectify11).
Windows 10 or later	UI becomes blurry when DPI changes	App doesn't support DPI adjustment after startup	Avoid changing DPI while the application is running.
Python Install Manager 26.0 or earlier	Command line window appears	Doesn't support automatic upgrade to windowed Python interpreter. (python/pymanager#216)	Upgrade the Python Install Manager to version 26.1 or later, or use the Python launcher.

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.

Credits

AI Assistance

Parts of this project were generated with AI assistance:

• DeepSeek: Coding guidance, code generation, documentation optimization, language translation.
• Yuanbao: Coding guidance, code generation, language translation.
• Tongyi Lingma: Code completion, coding guidance.
• WorkBuddy: Code review, documentation optimization.
• Trae: Code generation, documentation optimization.
• OpenCode: Documentation optimization.

Open Source

This project uses open source code. See Open Source Notices (Chinese) for details.

More Documentation

• Contribution Guidelines
• Development (Chinese)
• FAQ (Chinese)