vCards is a contact management tool that improves the caller ID and messaging interface experience on iOS and macOS by importing common Chinese service provider contacts with avatars.
The tool addresses the problem of generic or missing caller information for frequently contacted Chinese services like banks, delivery companies, and government agencies. It works by providing contact data in vCard format that can be imported into the system address book through multiple methods: installing a CardDAV configuration profile for automatic updates, manually subscribing to a CardDAV service for ongoing synchronization, or downloading and importing vCard files directly into iCloud contacts.
This tool suits users in China who want to enhance their phone's caller ID display with branded avatars and names for common service numbers. The CardDAV subscription method is recommended because it enables automatic updates and keeps the imported contacts separate from personal address books. Users concerned about privacy can self-host the service using the provided tutorial. The project accepts community contributions for adding new contact entries through GitHub issues and pull requests, with contributors adding YAML and PNG files to category directories and running tests to verify format compliance.
Development activity shows consistent maintenance with an established process for community participation. The project maintains organized contribution guidelines requiring format validation before merging. Community members actively submit requests for new contact inclusions through the issue tracker. The tool provides clear documentation for both end users and potential maintainers, with separate setup instructions for different platforms and use cases.
