{"id":18904356,"url":"https://github.com/relikd/abcddb2vcard","last_synced_at":"2025-09-11T10:45:26.339Z","repository":{"id":72079477,"uuid":"374189917","full_name":"relikd/abcddb2vcard","owner":"relikd","description":"Convert abcddb AddressBook format to vCard. Export profile images from vCard.","archived":false,"fork":false,"pushed_at":"2024-01-27T16:12:45.000Z","size":33,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-28T15:21:30.726Z","etag":null,"topics":["abcddb","addressbook","macos","vcard"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/relikd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2021-06-05T18:49:53.000Z","updated_at":"2024-11-28T22:42:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"32bc42b9-ae6f-49f4-b4ea-64ac6859f079","html_url":"https://github.com/relikd/abcddb2vcard","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/relikd%2Fabcddb2vcard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/relikd%2Fabcddb2vcard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/relikd%2Fabcddb2vcard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/relikd%2Fabcddb2vcard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/relikd","download_url":"https://codeload.github.com/relikd/abcddb2vcard/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248680072,"owners_count":21144604,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["abcddb","addressbook","macos","vcard"],"created_at":"2024-11-08T09:08:10.060Z","updated_at":"2025-09-11T10:45:26.316Z","avatar_url":"https://github.com/relikd.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# abcddb2vcard\n\nThis python script reads an AddressBook database file (`AddressBook-v22.abcddb`) and export its content to a vCard file (`.vcf`).\n\nI created this script to automate my contacts backup procedure.\nThe output of this script should be exactly the same as dragging and dropping the “All Contacts” card.\n\n\n### Usage\n\n```sh\npython3 abcddb2vcard.py backup/contacts_$(date +\"%Y-%m-%d\").vcf\n```\n\n\u003e assuming db is located at \"~/Library/Application Support/AddressBook/AddressBook-v22.abcddb\"\n\n#### Export into individual files\n\n```sh\npython3 abcddb2vcard.py outdir -s 'path/%{fullname}.vcf'\n```\n\n#### Extract contact images\n\n```sh\npython3 vcard2image.py AllContacts.vcf ./profile_pics/\n```\n\n\n### Supported data fields\n\n`firstname`, `lastname`, `middlename`, `nameprefix`, `namesuffix`, `nickname`, `maidenname`, `phonetic_firstname`, `phonetic_middlename`, `phonetic_lastname`, `phonetic_organization`, `organization`, `department`, `jobtitle`, `birthday`, `[email]`, `[phone]`, `[address]`, `[socialprofile]`, `note`, `[url]`, `[xmpp-service]`, `image`, `iscompany`\n\n\n### Limitations\n\nThe `image` field currently only supports JPG images.\nBut as far as I see, Apple converts PNG to JPG before storing the image.\nIf you encounter a db which includes other image types, please let me know.\n\n\n### Disclaimer\n\nYou should check the output for yourself before using it in a production environment.\nI have tested the script with many arbitrary fields, however there may be some edge cases missing.\nFeel free to create an issue for missing or wrong field values.\n\n**Note:** The output of `diff` or `FileMerge.app` can be different to this output.\nApples does some weird transformations on vcf export that are not only unnecessary but in many cases break the re-import of the file.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frelikd%2Fabcddb2vcard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frelikd%2Fabcddb2vcard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frelikd%2Fabcddb2vcard/lists"}