{"id":18088487,"url":"https://github.com/404wolf/obsidian-contact-importer","last_synced_at":"2025-04-13T03:16:25.595Z","repository":{"id":248163004,"uuid":"827922789","full_name":"404Wolf/obsidian-contact-importer","owner":"404Wolf","description":"Transform vCard markdown files into Obsidian-Notes ready Markdown files","archived":false,"fork":false,"pushed_at":"2024-08-02T04:22:15.000Z","size":129,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-13T03:12:20.192Z","etag":null,"topics":["bun","obsidian","obsidian-md","typescript","vcard"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/404Wolf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-12T17:11:52.000Z","updated_at":"2025-03-21T07:57:48.000Z","dependencies_parsed_at":"2024-08-02T04:28:13.170Z","dependency_job_id":null,"html_url":"https://github.com/404Wolf/obsidian-contact-importer","commit_stats":null,"previous_names":["404wolf/obsidian-contact-importer"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/404Wolf%2Fobsidian-contact-importer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/404Wolf%2Fobsidian-contact-importer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/404Wolf%2Fobsidian-contact-importer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/404Wolf%2Fobsidian-contact-importer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/404Wolf","download_url":"https://codeload.github.com/404Wolf/obsidian-contact-importer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248657923,"owners_count":21140846,"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":["bun","obsidian","obsidian-md","typescript","vcard"],"created_at":"2024-10-31T17:13:10.677Z","updated_at":"2025-04-13T03:16:25.568Z","avatar_url":"https://github.com/404Wolf.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Obsidian Contact Importer\n## Import contacts into templated Obsidian markdown\n\n[Obsidian](https://obsidian.md/) is a super cool note taking client. [Vcard](https://www.rfc-editor.org/rfc/rfc6350.html) is a not super cool super annoying Contact storage standard. `Obsidian Contact Importer` is a super cool `ts` project to parse your `vcards`, and generate structured `markdown` ready for importing to `Obsidian`.\n\nThis works by loading your vCards, parsing them with [`vcf`](https://www.npmjs.com/package/vcf), adapting the parser output to be more human-friendly and JSON-ic, and then plugging it all into a handlebar template. Images are handled by converting the base64 embedded images into proper image files, with UUID linking.\n\nCurrently this is only one-way, but it is designed to be able to be two-way so that you can both convert vCards to markdown and vice versa in the future. Eventually this will be ported to a proper Obsidian plugin.\n\n## Usage\n\nClone this repo or create a `inputs` folder with a `vcards.vcf` and `template.md` file (see example template if you're creating your own). Run `nix run github:404wolf/obsidian-contact-importer` if you have `nix`. If not, make sure that `bun` is installed, and then run `bun install`. Export your contacts to a `.vcf` format, and then just run `bun run dev`. Only tested with Apple contacts so far. Please create an issue if your contacts can't import correctly.\n\n## Examples\n\n![20fdcf6b-0961-418b-9c78-effa2b5ef2d9](https://github.com/user-attachments/assets/5df9c689-251b-4e39-b3cd-bc0d8e156703)\n\n![34d5c1f9-ef12-4f90-8d5d-244cb4273313](https://github.com/user-attachments/assets/64ba7881-cb34-418d-a0b3-65865a3a11bf)\n\nCheck out [@ symbol linking!](https://github.com/Ebonsignori/obsidian-at-symbol-linking), so you can dynamically create people notes!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F404wolf%2Fobsidian-contact-importer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F404wolf%2Fobsidian-contact-importer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F404wolf%2Fobsidian-contact-importer/lists"}