{"id":22284612,"url":"https://github.com/rillke/fritzxml2vcard","last_synced_at":"2025-07-28T22:30:44.865Z","repository":{"id":32903169,"uuid":"145334931","full_name":"Rillke/fritzXML2vcard","owner":"Rillke","description":"Convert FRITZ!Box address book XML format to vcards. (Inofficial, not endorsed or supported by AVM)","archived":false,"fork":false,"pushed_at":"2023-06-12T11:56:53.000Z","size":8365,"stargazers_count":12,"open_issues_count":4,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-11-12T23:50:47.618Z","etag":null,"topics":["address-book","fritzbox","node-js","phonebook","vcard","xml-converter"],"latest_commit_sha":null,"homepage":"https://blog.rillke.com/fritzXML2vcard/","language":"JavaScript","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/Rillke.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}},"created_at":"2018-08-19T20:21:40.000Z","updated_at":"2024-05-19T17:40:34.000Z","dependencies_parsed_at":"2023-01-14T22:35:55.100Z","dependency_job_id":null,"html_url":"https://github.com/Rillke/fritzXML2vcard","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rillke%2FfritzXML2vcard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rillke%2FfritzXML2vcard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rillke%2FfritzXML2vcard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rillke%2FfritzXML2vcard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Rillke","download_url":"https://codeload.github.com/Rillke/fritzXML2vcard/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227961890,"owners_count":17847836,"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":["address-book","fritzbox","node-js","phonebook","vcard","xml-converter"],"created_at":"2024-12-03T16:49:08.778Z","updated_at":"2024-12-03T16:49:10.487Z","avatar_url":"https://github.com/Rillke.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# fritzXML2vcard [![Build Status](https://api.travis-ci.com/Rillke/fritzXML2vcard.svg?branch=master)](https://travis-ci.com/Rillke/fritzXML2vcard)\n\nConvert FRITZ!Box address book XML format to vCards.\n\n## Web interface/ online version\n\nAn [online web-version is available](https://blog.rillke.com/fritzXML2vcard/). You may also [download the entire website](https://github.com/Rillke/fritzXML2vcard/zipball/gh-pages).\n\n[![Screenshot Web interface/ online version](https://raw.githubusercontent.com/Rillke/fritzXML2vcard/gh-pages/img/web-tool-screenshot.png)](https://blog.rillke.com/fritzXML2vcard/)\n\n## CLI user installation\n\nRequires [nodejs and npm](https://nodejs.org/en/download/).\n\nInstall the [fritz-xml-2vcard](https://www.npmjs.com/package/fritz-xml-2vcard) package from npm.\n\n```bash\nnpm i -g fritz-xml-2vcard\nfritz-xml-2vcard /path/to/contact.xml /path/to/output/dir\n```\n\n## Developer installation\n\n```bash\ngit clone https://github.com/Rillke/fritzXML2vcard.git\ncd fritzXML2vcard\nnpm install\nnpm run build\nnpm test\nmkdir -p /path/to/output/dir\n/path/to/node_or_nodejs ./convert.js /path/to/contact.xml /path/to/output/dir\n```\n\n## Node.js API usage\n\n```javascript\nvar libConvert = require('fritz-xml-2vcard');\n// area code and country code are optional arguments\nvar result = libConvert.fritzXML2vcard(xmlString, '030', '+49');\nfor (var vcfFile in result) {\n\tif (result.hasOwnProperty(vcfFile)) {\n\t\tfs.writeFileSync(outputDir + '/' + vcfFile, result[vcfFile]);\n\t}\n}\n```\n\n## Web Browser API usage\n\nGet [fritzXML2vcard-browser-api-min.js](https://raw.githubusercontent.com/Rillke/fritzXML2vcard/gh-pages/fritzXML2vcard-browser-api-min.js) or [fritzXML2vcard-browser-api.js](https://raw.githubusercontent.com/Rillke/fritzXML2vcard/gh-pages/fritzXML2vcard-browser-api.js). Put it side by side with the following html file:\n\n```html\n\u003c!DOCTYPE html\u003e\n\u003chtml lang=\"en\"\u003e\n\t\u003chead\u003e\n\t\t\u003cmeta charset=\"utf-8\"\u003e\n\t\t\u003ctitle\u003eCool vcf converter.\u003c/title\u003e\n\t\u003c/head\u003e\n\t\u003cbody\u003e\n\t\t\u003c!-- page content --\u003e\n\t\t\u003cscript src=\"fritzXML2vcard-browser-api-min.js\"\u003e\u003c/script\u003e\n\t\t\u003cscript\u003e\n\t\tvar fritzXML = '\u003c?xml version=\"1.0\" encoding=\"utf-8\"?\u003e' +\n\t\t\t'\u003cphonebooks\u003e\u003cphonebook name=\"Telefonbuch\"\u003e' +\n\t\t\t'\u003ccontact\u003e\u003cperson\u003e\u003crealName\u003eTest GmbH\u003c/realName\u003e\u003c/person\u003e' +\n\t\t\t'\u003ctelephony nid=\"2\"\u003e\u003cnumber type=\"work\" prio=\"1\" id=\"0\"\u003e(01234) 567890\u003c/number\u003e' +\n\t\t\t'\u003cnumber type=\"fax_work\" prio=\"0\" id=\"1\"\u003e56789-2\u003c/number\u003e\u003c/telephony\u003e' +\n\t\t\t'\u003c/contact\u003e\u003c/phonebook\u003e\u003c/phonebooks\u003e';\n\t\tvar vCards = window.libConvert.fritzXML2vcard(fritzXML, '030', '+49');\n\t\tconsole.log(vCards);\n\t\tfor (var vcfFile in vCards) {\n\t\t\tif (vCards.hasOwnProperty(vcfFile)) {\n\t\t\t\talert(vcfFile + ': ' + vCards[vcfFile]);\n\t\t\t}\n\t\t}\n\t\t\u003c/script\u003e\n\t\u003c/body\u003e\n\u003c/html\u003e\n```\n\n## Other tools\n\n| Tool                                                                             | Language / Plattform                                          | Web-Version                                  | Import                                                         | Export                                                                                                                             | License |\n|----------------------------------------------------------------------------------|-------------------------------------------------------------------------|----------------------------------------------|----------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|--------|\n| [Contact-Conversion-Wizard](https://github.com/Rillke/Contact-Conversion-Wizard) | C# easy to run on Windows; MacOS and Linux possible                      | -                                            | Outlook, Fritz!Box XML, vCard, Fritz!Adr, CSV, Google Contacts | Outlook, Fritz!Box XML, vCard, Fritz!Adr, Snom v7, Snom v8, Gigaset Talk\u0026Surf CSV, Asstra, Grandstream, Auerswald, Google Contacts | GPLv3  |\n| [fritzXML2vcard](https://github.com/Rillke/fritzXML2vcard)                       | JavaScript - Node.js Almost all operating systems                        | [available](https://blog.rillke.com/fritzXML2vcard/) | Fritz!Box XML                                                  | vCard(s)                                                                                                                           | MIT    |\n| [vcard2fritzXML](https://github.com/berkholz/vcard2fritzXML)                     | Java - Almost all operating systems                                        | -                                            | vCard                                                          | Fritz!Box XML                                                                                                                      | GPLv2  |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frillke%2Ffritzxml2vcard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frillke%2Ffritzxml2vcard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frillke%2Ffritzxml2vcard/lists"}