| adx - addressbook.xml | ||
|---|---|---|
What you need A web browser (e.g. Firefox, Chrome, Chromium, Safari, Vivaldi, Opera, Brave, Edge, etc). |
||
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 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 Birthday/anniversary reminder 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) Customizable (XSLT) Export as vCard via file or QR code (completely offline) QR Code generation of any kind (completely offline) |
||
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 |
||
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 |
||
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) 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. |
||
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. |
||
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 apply a workaround for your browser |
||
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 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). |
||
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-googlemail.com |
||
 |
||