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 VCF files for batch import to mobile contacts.

Screenshot

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>_cpython-[3.12|3.13]_zipapp.pyzw

Usage

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

   Isaac Newton	13445467890	British mathematician
   Muhammad		13554678907
   Confucius		13645436748
   

3. Click "Generate", select a path to save the file.
4. Transfer the generated VCF file to your phone, select "Contacts" when opening the file, and follow the prompts to complete the import.
5. Wait for the import to complete.

Note

• Tabs will be automatically converted to spaces for processing.
• 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

Compatibility

System Requirements

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

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

On Windows systems, to launch the Python 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

File Compatibility

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

Development & Contribution

Please refer to the Development Guide (Chinese) and the Contribution Guide (Chinese).

License

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

Copyright 2023-2025 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.

Open Source Notice

Please refer to Open Source Notice (Chinese)

Special Thanks

Parts of the code in this project were generated with the assistance of AI coding tools (DeepSeek, Tongyi Lingma).