|adx - addressbook.xml|
vCard - What is adx
vCard - What you need
A web browser (e.g. Firefox, Chrome, Chromium, Safari, Vivaldi, Opera, Brave, Edge, etc).
vCard - Operating System
Any OS (including Linux, Windows, Mac OS, Android, etc.)
The OS doesn't matter, just a web browser is needed.
vCard - Features
Contact management incl. web accounts
Usage as personal address book or shared contact list
Very small size (ca. 350 KByte)
Lightweight (only 2 XML files, no dependencies)
Address book in Plain Old XML (POX) for self editing
Online hosting (e.g. easy self-hosting on any web server/space)
Local hosting (e.g. on local disk) possible but needs a browser tweak
Complete offline usage possible
Portable (e.g. on USB flash drive)
Search in contacts
Tagging of contacts
Geo mapping by address, longitude/latitude or what3words
Semantic data support: Microformats hCard 1.0 and XFN
Configurable (URL parameter, in XML or XSLT file)
Export as vCard via file or QR code (completely offline)
QR Code generation of any kind (completely offline)
vCard - Experimental features
Following new experimental features were introduced with adx v1.40
1. Using Settings in addressbook.xml under <settings> tag
2. Quick Access allows putting contact fields on right side e.g. <misc access="quick">
3. Using (X)HTML formatting inside tag <misc format="xhtml">
4. Using custom CSS formatting inside tag <misc format="xhtml">
By combining several experimental features adx can also be used as Micro Content Management System (µCMS)
See Live Demo of experimental features.
Actually, THIS website is also using the experimental features. It was just HTMLized for better SEO. See original index.xml
vCard - Supported online accounts
Matrix, Skype, Twitter, Facebook, Google, digg, tumblr, pinterest,
YouTube, Vimeo, imdb, trakt, last.fm, Hype Machine, AllMusic, bandcamp,
diaspora, GNU Social, HubZilla, stackexchange sites, LinkedIn, Xing, vkontakte
Flickr, DeviantArt, GitHub, SourceForge, and others.
Also generic accounts are supported. See all at Accounts in adx wiki
vCard - How it works (usage)
Open addressbook.xml in your web browser and
you get an address book with many features
vCard - How it works (technically)
XML --[XSLT]--> HTML
address book (XML file) is tranformed (XSLT file) by web browser to a web app (HTML)
vCard - Online hosting
Yes, also easy self-hosting possible. Just upload the 2 adx files (xml, xsl) on any web server.
vCard - Local hosting
Yes. E.g. drag and drop the file addressbook.xml from your local disk on your browser.
BUT due to increased security restrictions by browser vendors you probably need to configure your browser for accessing local files
vCard - What you should know
adx provides no editor for contacts.
Contacts are stored in addressbook.xml (text file) which needs to be edited in an external tool.
A simple text editor works, even Notepad.
vCard - Download
vCard - Quick start (online)
Download adx, unzip, upload to your web server and
open addressbook.xml in your browser: http(s)://.../addressbook.xml
vCard - Quick start (local)
Download adx, unzip, apply browser workaround to have access to local files and
open addressbook.xml in your browser from local disk: file://.../addressbook.xml
Note: If you get just a blank page you need to apply browser workaround to have access to local files.
vCard - Supported browsers
Basically all modern web browsers are supported on any OS.
Recommended browser for fastest adx start-up time (XSL transformation): Firefox.
Minimum browser versions:
Firefox 3+, Chromium based browsers (Chrome, Chromium, Vivaldi, Brave, Opera15+, newer Edge), Safari 3+, Opera 9-12, IE, superseded Edge.
While browser versions mentioned were tested at least once, for latest adx release only following
browsers were actively tested (under Ubuntu): Firefox, Chromium, Vivaldi, Brave.
If you encounter any issue with a certain browser (version) please let me know.
vCard - Browser requirements
XML/XSLT support (included in every major browser)
For local hosting of adx (e.g. local disk) you probably need to apply a workaround for your browser
vCard - Add/edit contacts
Edit addressbook.xml in any text editor
See provided examples and templates in addressbook.xml to build yours
vCard - Import/export contacts
Online Importer for Open Contacts
Export via vCard file or QR code (completely offline)
For more info see adx wiki
vCard - Documentation
See source of addressbook.xml for contact templates and examples and
have a look at adx wiki
vCard - Why
I want to keep private data under my own control, instead of "paying" online platforms with intransparent data protection policy with personal data about myself or my contacts. Web features:
I want a web enabled address book which can call phone numbers by a simple click (e.g. Skype), supports address finding by web mapping (Google Maps, OpenStreetMap, etc.), supports contact tagging, supports Microformats (hCard 1.0, XFN), manages online accounts, ease exporting by QR codes and so on. Lightweight:
I want a small portable solution which can be used where a web browser or at least a text file viewer is available. No need for installation, browser plugin, server component or anything like that. So, adx consists only of two files (XML file for the contacts, XSLT file for transforming to HTML within the web browser). Sustainability:
For data storing I want an open and easy accessible format which to be future proof. Therefore I used Plain Old XML (POX) with a flat data schema leaning on a well-known standard (vCard).
vCard - Credits
Thx to dandavis for download.js v4.1, 2008-2015 (CCBY2 license)
Thx to Kazuhiko Arase for qrcode-generator (MIT license)
Thx to SourceForge for hosting adx project website
The word "QR Code" is registered trademark of DENSO WAVE INCORPORATED