Welcome to fgprint - an advanced fingerprinting library

fgprint - The most powerful, fast, and convenient library for browser and device fingerprinting in pure TypeScript.

Zero dependencies · Modern architecture · 100% Typed · Extendable

📖 Table of contents

🚀 Why fgprint?

Most fingerprinting libraries are either outdated, use a limited set of signals, or have bloated dependencies. Fgprint was built from the ground up to be:

• Full-featured: collects over 30 stable and unique signals, including WebGPU, WebCodecs, Canvas, AudioContext, WebGL, fonts, math artifacts, and many others.
• Fast: a synchronous fingerprint is calculated in <10 ms, an asynchronous fingerprint in 100–300 ms.
• Client side - no required API keys or payments;
• Modular: you can use only the components you need or add your own.
• Typed: written on pure TypeScript with type preservation in all public methods.
• Independent: dependency free, works even in the most confined environments.

✨ Features list

🧩 Unique signals

• Basic: Navigator, Screen, Timezone, Plugins;
• Graphics: Canvas, WebGL, WebGPU;
• Audio: AudioContext with dynamic buffer;
• System: Networking, performance, fonts, virtual keyboard;
• Extended: Math Precision, CSS-properties;

⚡ Performance and reliability

• Built-in results caching;
• Configurable timeouts for asynchronous operations;
• Robust data normalization (e.g. rounding of screen sizes);
• Sync and Async modes;
• SHA-512 cached fingerprints;

🧪 For developers

• Full typing with autocompletion in the IDE
• Clear OOP design with abstract class FingerprintComponent
• Component getters with generics: fp.getComponent<CanvasFingerprinter>('canvas')
• Ready-to-use demo with visual debugging

Comparison with analogues

| Characteristic | fgprint | FingerprintJS | ClientJS | CreepJS (browser extension) | |------------------------|--------------------|---------------|---------------|-----------------------------| | Signals | 30+ | ~20 | ~15 | ~40+ | | WebGPU / WebCodecs | ✅ | ❌ | ❌ | ✅ (partial) | | Audio Fingerprint | ✅ (no sound) | ✅ | ❌ | ✅ | | Math | ✅ | ❌ | ❌ | ✅ | | Caching | ✅ | ✅ | ❌ | ❌ | | Typed (TypeScript) | ✅ | ✅ | ❌ | ❌ | | Size (min+gzip) | ~7 KB | ~14 KB | ~10 KB | N/A | | Modular | ✅ (any components) | ⚠️ (fixed) | ❌ | ✅ | | Dependencies | 0 | 0 | 0 | - |

Get started

📦 Installation

Installation using NPM:

npm install @neurosell/fgprint

Or using GitHub:

git clone https://github.com/devsdaddy/fgprint
cd ./fgprint

🏁 Simple usage

import { Fingerprint } from "@neurosell/fgprint";

/* Create basic fingerprint */
const fp = Fingerprint.createDefault();
const fingerprint = await fp.getFingerprint();
console.log('Full fingerprint:', fingerprint);

🔧 Advanced usage

Components selection:

import { Fingerprint, NavigatorFingerprint, CanvasFingerprint } from '@neurosell/fgprint';

const fp = new Fingerprint({
  components: [
    new NavigatorFingerprint(),
    new CanvasFingerprint(),
  ],
  exclude: [],                // Exclude components
  timeout: 2000,              // Async operations timeout
  debug: false,               // Debug data
});

const hash = await fp.getFingerprint();

Access to component data:

// Get registred component with type
const webgl = fp.getComponent<WebGLFingerprint>('webgl');
if (webgl) {
  const data = webgl.getData(); // Has data
  console.log('GPU:', data.unmaskedRenderer);
}

// Get directly typed data from component
const navData = await fp.getComponentDataTyped<{ userAgent: string }>('navigator');
console.log(navData?.userAgent);

Create your own signals:

import { FingerprintComponent } from '@neurosell/fgprint';

class MyComponent extends FingerprintComponent<string> {
  name = 'myComponent';
  
  public override getData() {
    return 'custom data';
  }
}

fp.registerComponent(new MyComponent());

📋 Components list

Note: Asynchronous components are automatically handled with a timeout, and their failure does not affect the final print.

| Component | Mode | Description | |------|-------|----------------------------------------------------------------| | NavigatorFingerprint | Sync | User agent, platform, languahes. harware etc. | | ScreenFingerprint | Sync | Screen size, color depth, orientation etc. | | TimezoneFingerprint | Sync | Timezone information | | PluginsFingerprint | Sync | Browser plugins | | CanvasFingerprint | Sync | Canvas fingerprint based on GPU/OS | | WebGLFingerprint | Sync | WebGL Features | | FontsFingerprint | Sync | List of available fonts | | MiscFingerprint | Sync | Additional small signals (touch support, pointer events etc.) | | AudioFingerprint | Async | An unique audio-fingerprint based on signal generator | | MediaDevicesFingerprint | Async | (require user permission!) list of cameras, mics etc. | | NetworkFingerprint | Sync | Connection type, RTT, downlink, saveData | | WebGPUFingerprint | Async | GPU information based on modern WebGPU API | | WebCodecsFingerprint | Async | List of codecs | | PerformanceFingerprint | Sync | (unique) Memory usage from JS-heap and speed of math functions | | MathPrecisionFingerprint | Sync | Compute artifacts of some math functions | | SensorFingerprint | Sync | Sensors availability | | GamepadFingerprint | Sync | Gamepad list info | | SpeechSynthesisFingerprint | Sync | Speech synthesis fingerprint | | CSSFeaturesFingerprint | Sync | CSS features list |

🖥️ Demo and Debug

The repository contains a demo/ folder with a ready-made page for visual testing.

git clone https://github.com/devsdaddy/fgprint.git
cd ./fgprint
npm install
npm run build:demo
npx serve demo

Open http://localhost:3000 to view demo data and fingerprints.

Licensing

Fgprint library is distributed under the MIT license. You can use it however you like. I would appreciate any feedback and suggestions for improvement. Full license text can be found here

Why? | Features | Get Started | Contact