{"id":13802833,"url":"https://github.com/Valve/fingerprintjs","last_synced_at":"2025-05-13T13:33:02.907Z","repository":{"id":27169273,"uuid":"30638861","full_name":"fingerprintjs/fingerprintjs","owner":"fingerprintjs","description":"The most advanced browser fingerprinting library.","archived":false,"fork":false,"pushed_at":"2024-10-28T11:47:19.000Z","size":2965,"stargazers_count":22998,"open_issues_count":15,"forks_count":2296,"subscribers_count":427,"default_branch":"master","last_synced_at":"2024-10-30T01:02:35.921Z","etag":null,"topics":["audio-fingerprinting","browser","browser-fingerprint","browser-fingerprinting","detection","fingerprint","fingerprinting","fingerprintjs","fraud","fraud-detection","identification","javascript","visitor-identifier"],"latest_commit_sha":null,"homepage":"https://fingerprint.com/github/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fingerprintjs.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":"contributing.md","funding":null,"license":"LICENSE","code_of_conduct":"code_of_conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-02-11T08:49:54.000Z","updated_at":"2024-10-30T00:54:19.000Z","dependencies_parsed_at":"2023-10-21T11:19:04.384Z","dependency_job_id":"5904221a-b4a1-4ff1-a33e-840804d8f784","html_url":"https://github.com/fingerprintjs/fingerprintjs","commit_stats":{"total_commits":736,"total_committers":102,"mean_commits":7.215686274509804,"dds":0.7228260869565217,"last_synced_commit":"5e6916a1f4a17ff1cec3d7816d6cf436f264d9ec"},"previous_names":["valve/fingerprintjs2","valve/fingerprintjs","fingerprintjs/fingerprintjs2"],"tags_count":104,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fingerprintjs%2Ffingerprintjs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fingerprintjs%2Ffingerprintjs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fingerprintjs%2Ffingerprintjs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fingerprintjs%2Ffingerprintjs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fingerprintjs","download_url":"https://codeload.github.com/fingerprintjs/fingerprintjs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224866876,"owners_count":17382875,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio-fingerprinting","browser","browser-fingerprint","browser-fingerprinting","detection","fingerprint","fingerprinting","fingerprintjs","fraud","fraud-detection","identification","javascript","visitor-identifier"],"created_at":"2024-08-04T00:01:59.391Z","updated_at":"2025-05-13T13:33:02.895Z","avatar_url":"https://github.com/fingerprintjs.png","language":"TypeScript","readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://fingerprint.com\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"resources/logo_light.svg\" /\u003e\n      \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"resources/logo_dark.svg\" /\u003e\n      \u003cimg src=\"resources/logo_dark.svg\" alt=\"FingerprintJS logo\" width=\"312px\" /\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/fingerprintjs/fingerprintjs/actions/workflows/test.yml\"\u003e\u003cimg src=\"https://github.com/fingerprintjs/fingerprintjs/actions/workflows/test.yml/badge.svg\" alt=\"Build status\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@fingerprintjs/fingerprintjs\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/@fingerprintjs/fingerprintjs.svg\" alt=\"Current NPM version\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@fingerprintjs/fingerprintjs\"\u003e\u003cimg src=\"https://img.shields.io/npm/dm/@fingerprintjs/fingerprintjs.svg\" alt=\"Monthly downloads from NPM\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.jsdelivr.com/package/npm/@fingerprintjs/fingerprintjs\"\u003e\u003cimg src=\"https://img.shields.io/jsdelivr/npm/hm/@fingerprintjs/fingerprintjs.svg\" alt=\"Monthly downloads from jsDelivr\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://discord.gg/39EpE2neBg\"\u003e\n    \u003cimg src=\"https://img.shields.io/discord/852099967190433792?style=for-the-badge\u0026label=Discord\u0026logo=Discord\u0026logoColor=white\u0026color=5865F2\" alt=\"Discord server\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\nFingerprintJS is a [source-available](docs/licensing.md), client-side, browser fingerprinting library that queries browser attributes and computes a hashed visitor identifier from them. Unlike cookies and local storage, a fingerprint stays the same in incognito/private mode and even when browser data is purged.\n\nFingerprintJS is available under a [BSL license](docs/licensing.md) for non-production purposes.\n\n_FingerprintJS is different from [Fingerprint Identification](https://dev.fingerprint.com/docs/introduction#fingerprint-identification-vs-fingerprintjs), our more detailed and accurate commercial product. See below for [more information](#industry-leading-accuracy-with-fingerprint-identification)._\n\n## Demo\n\nVisit https://fingerprintjs.github.io/fingerprintjs to see your visitor identifier.\n\nNow, try visiting the same page in private / incognito mode and notice how the visitor identifier remains the **same**!\n\n## Getting Started\n\n```html\n\u003cscript\u003e\n  // Initialize the agent at application startup.\n  // If you're using an ad blocker or Brave/Firefox, this import will not work.\n  // Please use the NPM package instead: https://t.ly/ORyXk\n  const fpPromise = import('https://openfpcdn.io/fingerprintjs/v4')\n    .then(FingerprintJS =\u003e FingerprintJS.load())\n\n  // Get the visitor identifier when you need it.\n  fpPromise\n    .then(fp =\u003e fp.get())\n    .then(result =\u003e {\n      // This is the visitor identifier:\n      const visitorId = result.visitorId\n      console.log(visitorId)\n    })\n\u003c/script\u003e\n```\n\n[Run this code](https://stackblitz.com/edit/fpjs-4-cdn?file=index.html\u0026devtoolsheight=100)\n\n### Resources\n\n📕 [API Reference](docs/api.md)\n\n⚛️ [Sample usage with React on the StackBlitz platform](https://stackblitz.com/edit/fingerprintjs-react-demo)\n\n🔑 [FingerprintJS Licensing](docs/licensing.md)\n\n## Limitations\n\n### Accuracy\n\nSince FingerprintJS processes and generates the fingerprints from within the browser itself, the accuracy is limited (40% - 60%). For example, when 2 different users send requests using identical (i.e. same version, same vendor, same platform), browsers, FingerprintJS will not be able to tell these two browsers apart, primarily because the attributes from these browsers will be identical.\n\n### Security\n\nBecause of how the fingerprints are processed and generated from within the browser itself, they are vulnerable to spoofing and reverse engineering.\n\n## Industry-leading accuracy with Fingerprint Identification\n\nThe main difference between FingerprintJS and [Fingerprint Identification](https://dev.fingerprint.com/docs/introduction) lies in the number of attributes collected from the browser, how they are processed, and the accuracy in identifying visitors.\n\nFingerprint Identification is a **closed-source**, **commercial** device intelligence platform designed to prevent fraud and improve user experiences. It's an enhanced version of FingerprintJS and has been fully re-designed to solve the most challenging identification use cases. Its source is not available in this or any other public repository.\n\nUnlike FingerprintJS, Fingerprint Identification is able to achieve **industry-leading accuracy** because it processes the browser attributes on the server and also analyzes vast amounts of auxiliary data (e.g. IP addresses, time of visit patterns, URL changes, etc.). Because of these advanced matching techniques, Fingerprint Identification is able to reliably deduplicate different visitors that have identical devices.\n\nFingerprint Identification is available for Web, Android, iOS, and other platforms. You can easily get started by [signing up](https://dashboard.fingerprint.com/signup) for a free, unlimited 14-day trial.\n\nCheck out our [comparison table](docs/comparison.md) for a detailed breakdown of the differences between FingerprintJS and Fingerprint Identification.\n\n### Fingerprint Identification resources\n\n🍿 [Fingerprint Identification live demo](https://demo.fingerprint.com/playground)\n\n📕 [Fingerprint Identification documentation](https://dev.fingerprint.com)\n\n▶️ [Video: Use Fingerprint Identification to prevent multiple signups by same user](https://www.youtube.com/watch?v=jWX9P5_jZn8)\n\n⏱️ [How to upgrade from FingerprintJS to Fingerprint Identification in 30 seconds](https://dev.fingerprint.com/docs/migrating-from-fingerprintjs-to-fingerprint-pro#migrating-from-fingerprintjs-v4-source-available-to-pro)\n\n## Migrating to v4\n\n| Migrating from | Migration Guide | Documentation |\n|----------|-----------|-----------|\n| **v3** | [Migrating from v3 to v4](docs/migration/v3_v4.md) | [v3 documentation](https://github.com/fingerprintjs/fingerprintjs/tree/v3) |\n| **v2** | [Migrating from v2 to v4](docs/migration/v2_v4.md) | [v2 documentation](https://github.com/fingerprintjs/fingerprintjs/tree/v2) |\n| **v1** | [Migrating from v1 to v4](docs/migration/v1_v4.md) | [v1 documentation](https://github.com/fingerprintjs/fingerprintjs/tree/1.8.6) |\n\n## Version policy\n\nSee the compatibility policy for the API and visitor identifiers in the [version policy guide](docs/version_policy.md).\n\n## Supported browsers\n\nThe library supports all popular browsers. See more details and learn how to run the library in old browsers in the [browser support guide](docs/browser_support.md).\n\n## Where to get support\n\nUsing [Issues](https://github.com/fingerprintjs/fingerprintjs/issues) and [Discussions](https://github.com/fingerprintjs/fingerprintjs/discussions) publicly will help the community and other users with similar issues.\n\nYou can also join our [Discord server](https://discord.gg/ad6R2ttHVX) to ask questions, share feedback, and connect with other developers.\n\nIf you require private support for FingerprintJS, please email us at [oss-support@fingerprint.com](mailto:oss-support@fingerprint.com).\n\n## Contributing\n\nSee the [Contribution guidelines](contributing.md) to learn how to contribute to the project or run the project locally.\nPlease read it carefully before making a pull request.\n","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FValve%2Ffingerprintjs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FValve%2Ffingerprintjs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FValve%2Ffingerprintjs/lists"}