README.md

VCF Generator Lite

Repositories:

Platforms:

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

VCF Generator Lite can convert a contact list into a single vCard file, which can be batch-imported into mobile phone contacts or used for other purposes.

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

• 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 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 does not have a 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	The application does not support DPI adjustment after startup.	Keep the same DPI to avoid blurriness.
Python Install Manager 26.0 or earlier	A command line window appears after double-clicking to launch	Python Install Manager 26.0 or earlier does not support automatically upgrading to a windowed Python interpreter. (python/cpython#261)	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: Parts of this project are generated by AI.
  • DeepSeek: Guidance on coding, code generation.
  • Yuanbao: Guidance on coding, code generation.
  • Tongyi Lingma: Code completion, guidance on coding.
  • WorkBuddy: Code review.
  • Trae: Code generation.
• 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)