Skip to content
User-Agent Classifier: Erlang version of WeatherChannel's dClass
C Erlang C++
Find file

README.markdown

lser-Agent classification using TheWeatherChannel's dClass and OpenDDR

An implementation of the user agent classification library dClass by TheWeatherChannel using an Erlang NIF.

Device Classification

The main interface is ua_classifier:classify/1. It returns a property list with user agent properties from OpenDDR.

{ok, Ps} = ua_classifier:classify("Mozilla/5.0 (iPod; U; CPU iPhone OS 4_0 like Mac OS X; en-us) AppleWebKit/532.9 (KHTML, like Gecko) Version/4.0.5 Mobile/8A293 Safari/6531.22.7").

Returns:

{ok,[{is_wireless_device,true},
     {is_tablet,false},
     {ajax_support_javascript,true},
     {device_os,<<"iPhone OS">>},
     {displayWidth,320},
     {displayHeight,480},
     {inputDevices,<<"touchscreen">>},
     {parentId,<<"genericApple">>},
     {model,<<"iPod Touch">>},
     {vendor,<<"Apple">>},
     {id, <<"iPod">>]}

This property list can be mapped to a device type with ua_classifier:device_type/1. Known device types are: text, phone, tablet and desktop.

ua_classifier:device_type(Ps).

Returns:

phone

Browser Classification

Another interface is ua_classifier:browser_classify/1. Instead of returning the device classification of the user-agent it returns the browser classification.

ua_classifier:browser_classify("Mozilla/5.0 (iPod; U; CPU iPhone OS 4_0 like Mac OS X; en-us) AppleWebKit/532.9 (KHTML, like Gecko) Version/4.0.5 Mobile/8A293 Safari/6531.22.7").

Returns:

{ok, [{os, <<"iOS">>},
      {browser, <<"Safari">>},
      {version, 4050},
      {id, <<"iossafari405">>}
]}

The OpenDDR data files

This library uses the ".dtree" file of dClass. They are placed in priv/openddr.dtree and priv/browser.dtree. The dtree files are loaded when the NIF is initialized and when the NIF is upgraded.

Something went wrong with that request. Please try again.