Repolode
Submit
metowolf

metowolf/vCards

A CardDAV-based directory of Chinese business and service contacts with avatars, for importing into iOS and macOS Contacts to improve caller ID and message screens.

View on GitHub
Stars
6,452
Forks
313
Open issues
186
Last commit
10 days ago

What is it?

vCards CN is a curated directory of Chinese phone numbers for businesses and public services, such as banks, carriers, delivery and ride-hailing platforms. Each entry includes a name and logo, so incoming calls and text messages from these numbers show a recognizable identity instead of an unknown number.

The contacts can be added to iOS or macOS in three ways: installing a configuration profile, subscribing to a CardDAV account at vcards.metowolf.com, or downloading a packaged vcf archive and importing it manually. The CardDAV subscription updates automatically, and the project suggests keeping it in a separate group from personal contacts.

Contributors add entries as YAML files with a PNG logo under the data directory, and the repository includes Bun-based format checks. Numbers in the 106 SMS push range are not included.

Key features

  • 01Imports Chinese business and service contacts with logos into iOS and macOS Contacts.
  • 02Offers a CardDAV subscription that updates automatically.
  • 03Provides a configuration profile and a downloadable vcf archive as alternatives.
  • 04Accepts new entries via issue requests and YAML plus PNG pull requests.
  • 05Includes format validation tests for contributed data.

Use cases

  • Identifying incoming calls from banks, carriers or delivery services on an iPhone.
  • Recognizing service text messages with a logo in the Messages app.
  • Using the list as a starting template for a personal contact book with added numbers.

Quick start

  1. 1

    Scan the QR code with the system camera to download the CardDAV profile

  2. 2

    Open Settings and tap the downloaded profile, then tap Install

Things to know

  • Contacts are a fixed directory maintained by the project, not a software tool to run locally.
  • Default iOS fetch settings may delay updates until the device is charging and on Wi-Fi.
  • The README lists no open-source license.

In collections

Open-source Mac apps

Topics

#contacts#carddav#ios#macos#china#caller-id#yellow-pages#vcards

FAQ

What is vCards?
A CardDAV-based directory of Chinese business and service contacts with avatars, for importing into iOS and macOS Contacts to improve caller ID and message screens. vCards CN is a curated directory of Chinese phone numbers for businesses and public services, such as banks, carriers, delivery and ride-hailing platforms. Each entry includes a name and logo, so incoming calls and text messages from these numbers show a recognizable identity instead of an unknown number.
Is vCards free to use? What license does it have?
vCards has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.
Is vCards still maintained?
Actively maintained. The last commit to vCards was on Oct 28, 2026.
What can I use vCards for?
Identifying incoming calls from banks, carriers or delivery services on an iPhone. Recognizing service text messages with a logo in the Messages app. Using the list as a starting template for a personal contact book with added numbers.
How do I install vCards?
Scan the QR code with the system camera to download the CardDAV profile Open Settings and tap the downloaded profile, then tap Install
Where can I get vCards?
The source code and installation instructions are on GitHub: https://github.com/metowolf/vCards

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects