Home

Welcome, this wiki is for documentation of adx.

You can find here information how adx works, tips and tricks, etc.

Table of contents:

• What is adx?
• Live Demo
• Getting started
• Requirements
• IMPORTANT: Browser workaround needed for local usage
  • Workaround for Firefox 68 and newer for local usage ("file://...")
  • Workaround for Chromium based browsers for local usage ("file://...")
    • Workaround for Chrome under Windows
    • Workaround for Chromium under Ubuntu
    • Workaround for other Chromium based browsers like Chrome, Opera, Vivaldi, Brave, etc under Ubuntu
  • Obsolete browsers (not tested any more)
• Import contacts
• Export contacts
  • Export contacts to vCard (vcf file)
  • Export contacts via QR Code (vCard)
  • Export contacts to whatever format you want
• Web browser search in your adx contacts
  • Integrate adx in browser search: Chrome/Chromium
  • Integrate adx in browser search: Firefox
• Settings
  • Settings in XSL File (adx2html_phonelist.xsl)
  • URL parameters
• Securing your data in adx
  • Basic access authentication over HTTPS
  • Others ways to secure adx

What is adx?

adx (addressbook.xml) is a simple but massively web enabled address book in your web browser (no server components needed).

Supported web accounts: Skype, LinkedIn, Facebook, Xing, ebay, Flickr, Picasa, YouTube, MySpace, Twitter, Soup, ICQ, AIM, YIM, MSNIM, Jabber, Picasa, Google, Spin.de, last.fm, SourceForge, DeviantArt, identi.ca, bebo, studiVZ, qype.com, brightkite.com, hi5.com, quarterlife.com, amiestreet.com, hellotxt, etc. See [Accounts] for full list

Supported Microformats:

• hCard 1.0
• XFN (Xhtml Friends Network)

How it works: addressbook.xml + XSLT = HTML in your web browser

Live Demo

http://elektronengehirn.net/addressbook/addressbook.xml

Getting started

• Download from Sourceforge latest adx zip file
• Unzip downloaded adx zip file
• Load addressbook.xml in a web browser.
  Note: in case of local usage (file://...) you need to apply a workaround in your browser to allow local file access, see #important-browser-workaround-needed-for-local-usage
• Click on the entries to expand details (TODO: Add animated gif)
• Most entries in contact details are clickable (e.g. direct calling phone numbers via Skype, address lookup in map providers like Google Maps or Open Street Map)

To add contacts just edit addressbook.xml in a text editor of your choice

Requirements

Any modern web browser should work (e.g. Firefox, Safari, Chrome and any other Chromium-based browser like Edge, Vivaldi, Opera, Brave, etc). All of them have support for XSLT which is needed for adx to transfrom XML to HTML.

For online usage (http(s)://...) no further requirements beside that you need to host the two files addressbook.xml and adx2html_phonelist.xsl on any web server

For local usage (file://...) most modern browser don't allow local file access any more out of the box. Therefore you need to configure your browser to allow local file access! See details in following.

IMPORTANT: Browser workaround needed for local usage

A workaround for your browser is only needed if you want to use adx locally (file://...) instead of online (http(s)://....)

Workaround for Firefox 68 and newer for local usage ("file://...")

With introduced restrictions to access local files in Mozilla Firefox version 68, adx does not work any more out of the box (because the opened addressbook.xml in the browser is not allowed to access the needed XSL to do the transformation to HTML). for details about restriction reasons see here.

On opening adx you will get then probably an empty browser screen and an error message on browser web Console like following:
Cross-Origin Request Blocked: The Same Origin Policy disallows reading the remote resource at file:///.../adx2html_phonelist.xsl. (Reason: CORS request not http).

Workaround A:
You can also use adx locally by setting up a local web server and access adx by something like http://localhost/adx/addressbook.xml

Workaround B:
In order to be still able to run adx locally ("file://...") you can apply a workaround by changing internal Firefox config. But please be aware that disabling this security setting is at your own risk!
1. Enter about:config as URL in Firefox
2. Set security.fileuri.strict_origin_policy to true. See "security.fileuri.strict_origin_policy" for more details.
Note: Setting privacy.file_unique_origin to false allowed also local file access but seems not to work any more since Firefox 95.

Workaround for Chromium based browsers for local usage ("file://...")

All Chromium based browsers (version 5 or newer) need a workaround if you want to use adx locally (if you use "file://..." to access adx):

• Google Chrome: workaround needed
• Microsoft Edge (Chromium based): workaround needed
• Opera: workaround needed
• Vivaldi: workaround needed
• Brave: workaround needed
• Chromium: workaround needed
• Safari and other Chromium based browsers: not tested; workaround probably needed

Reason: Chromium's more restrictive security model for local access starting with version 5. See here for more info.

Workaround: Start browser with command line param "--allow-file-access-from-files"

In following you see two How Tos which should be similar on any other OS.

Workaround for Chrome under Windows

1. Search for your shortcut icon for starting Chrome on your Windows desktop.
2. Right-click on the Chrome shortcut and select "Properties"
3. Append in field "Target": --allow-file-access-from-files

Notes:

• It's important that the very first instance of Chrome was started with parameter --allow-file-access-from-files. You can check this in Chrome by entering URL chrome://version (see screenshot below).
• As Chrome/Chomium uses background tasks even if it's closed a restart of the whole OS is the safest way to ensure that the additional paramter is applied.
• It might be necessary to apply this on every shortcut you use. E.g. in start menu, on desktop, etc.
• You may not be able to access properties of a pinned Chrome icon to the task bar. Try unpin Chrome shortcut. Start Chrome with an adjusted Chrome shortcut (with --allow-file-access-from-files) and pin again.

Workaround for Chromium under Ubuntu

Following was tested with Ubuntu 11.10 - 20.04 under Gnome 3. Add needed command line parameter in file /usr/share/applications/chromium-browser.desktop:

1. Load file in browser. E.g. open a terminal window and enter sudo gedit /usr/share/applications/chromium-browser.desktop
2. Replace in text editor Exec=/usr/bin/chromium-browser %U with Exec=/usr/bin/chromium-browser --allow-file-access-from-files %U
3. As Chrome/Chomium uses background tasks even if it's closed a reboot is the safest way to ensure that the additional paramter is applied.

If it's still not working you can doublecheck with URL chrome://version if the parameter --allow-file-access-from-files is listed:

Attention: This option is applied to all chromium instances started inside Gnome desktop. If you have security concerns you should start chromium directly from terminal with command line parameter chromium-browser --allow-file-access-from-files.

Note: This change gets overwritten on each update of the browser and must be repeated. An automated way to check and update the desktop file is therefore recommended.

Workaround for other Chromium based browsers like Chrome, Opera, Vivaldi, Brave, etc under Ubuntu

Workaround should be similar as described above for Chromium.

Filenames of the different browsers in /usr/share/applications/:
- Opera: e.g. opera.desktop
- Vivaldi (stable): e.g. vivaldi-stable.desktop
- Brave: e.g. brave-browser.desktop
- Google Chrome: ?
- ...

Obsolete browsers (not tested any more)

• Microsoft IE (Internet Explorer version 11 worked but not tested any more)
• Obsolete version of Microsoft Edge based on short living render engine EdgeHTML (worked but superseded by Edge based on Chromium first announced 2018)

Import contacts

Importing contacts
- Online importer for Open Contacts (a freeware address book tool for Windows)
- Opent Contacts has itself various import possibilities which can be used as intermediate step before importing to adx. Supported import formats are Outlook, vCard, Mozilla, Eudora, CSV, LDIF and more.
- You can create your own XSLT transformator to import any XML based format to adx (e.g. based on the XSLT file from Open Contacts to adx)

Otherwise add your contacts manually to [addressbook.xml] with a text editor of your choice.

Export contacts

Export contacts to vCard (vcf file)

Native vCard export via adx:

• All contacts in one vcf file: in adx menu => Export => All
• One contact per vcf file: in adx menu => Export => One (formerly known as "Specific") enables for each contact a link vCard to download a vcf file
• Note: On native exporting the contacts are completely processed in the web browser. So, your contact data is not leaving your web browsor and therefore not uploaded to any server. Privacy matters!

Or export via Firefox browser plugins like Operator or Tails Export

How to use the vCard files:

• Android phones can import easily vCard contacts (Android >= 2.1). Go to contacts in your phone and press 'menu' where you can find an import functionality from your SDCard (e.g. in 'options').

• Thunderbird (version 16 as of now) has several issues on importing vCard data. The Thunderbird extension MoreFunctionsForAddressBook imports vCards much better.

• Evolution Email solution can also import vCard files.

• As vCard is the standard format for contact interchange there are many tools which support vCards.

Export contacts via QR Code (vCard)

A QR code is a two-dimensional barcode which can contain vCard data. Following example contains a full contact:

A QR code can be optical read out e.g. by any device with a camera and an app (Recommendation for Android: Barcode Scanner)

adx uses a open source QR code generator library to generate the QR code completely offline. So, your contact data is not leaving your web browsor and therefore not uploaded to any server.

Export contacts to whatever format you want

You can also create a XSLT document to export the contacts to the format of your choice.

Web browser search in your adx contacts

You can register adx as browser search engine. Add a url template like following consisting of your addressbook.xml (works online and offline). "%s" will be replaced by your search term.

Examples:

• file:///home/username/addressbook.xml?searchfilter=%s
• http://myhost.com/addressbook.xml?searchfilter=%s

You need to replace the path to your addressbook.xml (works online and offline).

Integrate adx in browser search: Chrome/Chromium

In Chrome this can be added very easy in Preferences -> Manage Search Engines.

Integrate adx in browser search: Firefox

Firefox integration can be done via a bookmark with above url pattern. Important is to apply a keyword for the bookmark (e.g. "adx") in order to call it from the url bar:

Once added as bookmark (here with keyword "adx") you can search from the address bar:

Settings

There are two types of settings:

• permanent settings in XSL File (adx2html_phonelist.xsl)
• URL parameters

For details see below.

Cookies or similar technology is not used at all.

Settings in XSL File (adx2html_phonelist.xsl)

For adjusting settings, search for "User settings" in adx2html_phonelist.xsl and edit them. In following you can find some of them (but for latest list see in adx2html_phonelist.xsl):

• headline_show_default
• details_show_default
• exports_show_default
• photo_show_default
• headline_text
• menu_opacity
• menu_shadow
• phone_showIcons
• phone_internationalAreaCode_default
• phone_protocol: Can be adjusted in order to execute the phone program of your choice like Skype. Example value "tel:" or "callto:"
• phone_skype_show: adds skype as direct call to right side of a contact (below the normal phone numbers)
• accountIcons_colorStyle: possible values are "grey" or "color" removed in version 1.12
• accountIcons_saturation_basic: sets saturation of account icons (color) when mouse is NOT over the contact, e.g. "20%" results in quite greyed out icon colors
• accountIcons_saturation_groupHover: sets saturation of account icons (color) when mouse is over the contact, e.g. "50%" result in medium greyed out icon colors. Note: When mouse is over the account icon itself the saturation is always set to "100%" (full color, not greyed out at all)
• birthday_highlightUpcoming_default
• birthday_outputFormat
• folksonomy_href
• tag_adxFrequency_Show: defines which frequency levels are shown by default (e.g. "high,medium")
• map_href: Defines URL for map application, e.g. "http://www.bing.com/maps/default.aspx?q=" for Bing Maps or "http://maps.google.com/maps?q=" for Google Maps
• map_geo_href: Defines URL for geo information (based on latitude and longitude)
• logo_href: Own logo can be configured as URL or Data URI in variables
• logo_href_protectionzone: Own logo can be configured as URL or Data URI in variables (logo with protection zone is used for resolutions > 32x32 pixels)
• debugMode: can be enabled for developing/debugging purposes

URL parameters

URL parameters cover most settings you can directly adjust on your adx web site. Example in order to show contact details by default: http://elektronengehirn.net/addressbook/addressbook.xml?showdetails=1

This is handy in order to bookmark adx with your needed settings:

1. Adjust settings in your adx web site
2. Clicking on "Save" in your adx web site results in a reload with all URL parameters
3. Now you can bookmark adx with your settings in URL parameters

Example with all URL parameters: http://elektronengehirn.net/addressbook/addressbook.xml?showdetails=1&showheader=1&showexport=1&tagfilter=Musician&searchfilter=Raph&frequencyhigh=1&frequencymedium=1&frequencylow=1&fontsize=1.1em

adx can also be directly started with text for QR code generator, e.g.: https://elektronengehirn.net/addressbook/addressbook.xml?qr=Hello%20world

Securing your data in adx

Basic access authentication over HTTPS

Provides an easy way to encrypt your data and set user/password, e.g. if you want to publish your adx on the internet.

Two independent techniques are combined:

• Basic access authentication Wikipedia for user credentials (user/password)
• HTTPS Wikipedia for encryption of transport (avoid sniffing your adx data)

Protection:

• What is protected: all files (including addressbook.xml with your sensitive contact data) are encryped while transport from server to browser via HTTPS-protocol
• Who can access: Everybody who has the credentials (user/password)

Security notes:

• See article on StackOverflow about security issues
• Warning: If you forget the "s" in https your password (from Basic Authentication) will be sent unecnrypted and can be easily sniffed (see next item)
• Do NOT use Basic access authentication alone because the password is only BASE64-encoded. This is no encryptioin and can be sniffed in clear text when the browser sends it to the server.

How to setup:

• Create a directory on your web server. e.g. "demo-https-basicauth"
• Enable Basic authentication for the new directory and define user and password to access it (for more details check your hoster's documentation)
• Enable HTTPS on your web server (for more details check your hoster's documentation)
• Upload your adx files to the new directory on your web server (e.g. addressbook.xml, adx2html_phonelist.xsl, qrcodeUTF8.min.js)
  Now you should be able to access your adx accordingly.

Demo: https://elektronengehirn.net/addressbook/demo-https-basicauth/addressbook.xml (user: "demo", password: "httpsBasicAuth")

Others ways to secure adx

Basically every possibility to encrypt or protect you data on the web. E.g. OAuth, ...