# matomo-org/device-detector

The Universal Device Detection library will parse any User Agent and detect the browser, operating system, device used (desktop, tablet, mobile, tv, cars, console, etc.), brand and model.

Repository: https://github.com/matomo-org/device-detector
Canonical: https://ross.abutalabs.com/products/device-detector
Homepage: http://devicedetector.net
Language: PHP
License: LGPL-3.0
License Family: copyleft
Topics: detection-library, php, device-detector, user-agent, bot-detection, mobile-detection, hacktoberfest
Last push: 2026-08-24T06:03:39+00:00

## Health v2 (maintenance only)
Score: 90/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 74, longevity 100
- inputs: {"age_days": 4536, "days_push": 9, "days_rel": 98, "gap_med": 62.5, "n_releases_24m": 11}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3519, forks 509 (observed 2026-08-28T04:08:07.910860+00:00)

## What it is
A PHP library that parses User Agents and Client Hints to detect the device type, browser, operating system, brand, and model, as well as bots. It is the detection engine used by Matomo Analytics.

## Use cases
- detect mobile devices from user agent strings
- identify browsers and operating systems from user agents
- detect bots and crawlers in access logs
- get device brand and model from client hints
- classify traffic as desktop, tablet, mobile, or tv
- parse user agents in a PHP application

## When to choose
- you need accurate, regularly updated user agent parsing in PHP
- you want bot detection alongside device detection
- you need brand/model-level device identification

## When to avoid
- your stack is not PHP
- you only need simple mobile vs desktop checks and want a tiny dependency
- you need client-side device feature detection rather than user agent parsing

## Facets
- artifact type: library
- maturity: active
- function: parser, nlp
- domain: developer-tools, web-development, analytics
- platform: php
- tags: user-agent-parsing, device-detection, bot-detection, client-hints

## Member repositories
- matomo-org/device-detector (main) score 90

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:07.910860+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:35:33.042951+00:00, confidence not recorded.
  - readme: https://github.com/matomo-org/device-detector (fetched 2026-08-28T04:08:07.910860+00:00, sha 6ef9ccb380d2)
  - homepage: http://devicedetector.net (fetched 2026-08-29T09:29:20.950306+00:00, sha 84d8885eb28b)
- Data as of 2026-08-30T08:39:29.467469+00:00.