What is adx
Minimalistic but full-featured and web enabled address book
running completely in your web browser. Data privacy in mind.
No further dependencies. See Live demo or download.

 
What you need
A web browser (e.g. Firefox, Chrome, Chromium, Safari, Vivaldi, Opera, Brave, Edge, etc).
IE is not tested any more and therefore not supported.
 
Operating System
Any OS (including Linux, Windows, Mac OS, Android, etc.)
The OS doesn't matter, just a web browser is needed.

 
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
Optimized for Desktop Screens (but still usable on smaller screens like mobile phones)
Online hosting (e.g. easy self-hosting on any web server/space)
Local hosting (e.g. on local disk) possible but needs a browser config change
Cookie-free solution
Complete offline usage possible
Portable (e.g. on USB flash drive)
Search in contacts
Birthday/anniversary reminder
Tagging of contacts
Geo mapping by address, longitude/latitude or what3words
Supports a11y (accessibility) based on WAI-RIA W3C recommendation
Semantic data support: Microformats hCard 1.0 and XFN
Configurable (URL parameter, in XML or XSLT file)
Customizable (XSLT)
Export as vCard via file or QR code (completely offline)
QR Code generation of any kind (completely offline)

 
Hot features
New/experimental features in adx v1.50/1.52
1. [final since v1.50] Custom settings in addressbook.xml under <settings> tag
2. [experimental] Quick Access allows putting contact fields on right side e.g. <misc access="quick">
3. [experimental] Support (X)HTML tags inside <misc format="xhtml">
4. [experimental] Support custom CSS formatting
See Live Demo and documentation of hot features.
By combining several experimental features adx can also be used as Micro Content Management System (µCMS).
Actually, THIS website is also using these new features. It was just HTMLized for better SEO. See original index.xml

 
Supported online accounts
Matrix, Skype, TikTok, 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

 
How it works (usage)
Open addressbook.xml in your web browser and
you get an address book with many features

 
How it works (technically)
XML --[XSLT]--> HTML
address book (XML file) is tranformed (XSLT file) by web browser to a web app (HTML)

 
Online hosting
Yes, also easy self-hosting possible. Just upload the 2 adx files (xml, xsl) on any web server.
 
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

 
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.

 
 
 
Quick start (online)
Download adx, unzip, upload to your web server and
open addressbook.xml in your browser: http(s)://.../addressbook.xml

 
Quick start (local disk)
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 configure your browser for accessing local files.

 
Supported browsers
Basically all modern web browsers are supported on any OS.
Only for using adx from local disk you need to configure your browser for accessing local files. This can be achieved most conveniently and sustainably with 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 browsers mentioned above were tested at least once, for latest adx release only following
browsers were actively tested (under Ubuntu): Firefox, Chromium, Vivaldi, Opera.
If you encounter any issue with a certain browser (version) please let me know.

 
Browser requirements
JavaScript enabled
XML/XSLT support (included in every major browser)
For local hosting of adx (e.g. local disk) you probably need to configure your browser for accessing local files

 
Add/edit contacts
Edit addressbook.xml in any text editor
See provided examples and templates in addressbook.xml to build yours
 
Import/export contacts
Online Importer for Open Contacts
Export via vCard file or QR code (completely offline)
For more info see adx wiki

 
 
Documentation
See source of addressbook.xml for contact templates and examples and
have a look at adx wiki

 
 
Why

I started adx in the early 2000s because I couldn't find an address book tool suited to my needs (and for Javascript/XML/XSLT finger exercises;-)

Data privacy:
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 2.0 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).


 
License
adx is open source (BSD license)
Free for private and commercial usage

 
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

 
Contact
thomas.bartensud-ät-googlemai hurz Thomas Bartensud adx website l.com
 
 
application logo