fingerprint-chromium

中文文档

A fingerprint browser based on Ungoogled Chromium.

⚠️ Notice: This project provides no technical support. Please do not contact me for help. Anyone who contacts you asking for payment is a scammer — do not be fooled.

Installation and Usage

Download

Please download the version suitable for your system from the links below. Each major version of Chromium is compiled into a corresponding release. Choose the appropriate version for your operating system:

For chinese users, you can download via cloud storage

Quark: https://pan.quark.cn/s/9bb65af874fb

You can find the compiled versions for each major Chromium release on the GitHub Release page. Download the appropriate file for your platform.

Build from Source

SOURCE CODE IS AVAILABLE IN THE GITHUB REPOSITORY TAGS, NOT IN THE MAIN BRANCH!

To maintain the integrity of this free and open source project, we've adopted a delayed source code release policy:

• Current Version: Compiled binaries are immediately available for all users
• Source Code: patch files will be released when the next version is published (typically one month later)

This approach helps prevent unauthorized repackaging and profiteering from our work while maintaining our open source commitment.

Once the source code is released, you can build by referring to the ungoogled-chromium documentation. Simply replace the ungoogled-chromium submodule URL with the fingerprint-browser repository URL.

📢 Author's Other Projects

Features

Fingerprint Support

You can use creepjs and browserleaks to test fingerprint modification effects.

• User-Agent: Modify the browser's navigator.userAgent, navigator.platform, navigator.userAgentData and Client Hints information.
• Operating System
• Audio
• Plugins: After removal in version 133+, the browser returns a fixed plugin list.
• CPU Cores
• Memory
• WebGL Image
• WebGL Metadata: Modify GPU vendor and graphics card model (currently only supports Linux).
• Fonts
• Canvas Image
• Canvas Text
• ClientRects
• WebRTC
• Language Support
• Timezone Support

Automation Support

Optimized for automation scenarios, offering the following features:

1. Fake Shadow DOM Support
   Adds the fakeShadowRoot property, equivalent to the shadowRoot property, enabling access to Closed Shadow Root for easier automation handling.

2. Avoid CDP Detection
   Prevents Chrome DevTools Protocol (CDP) detection when invoking Runtime.enable, enhancing stealthiness for automation tools.

3. Webdriver
   Sets navigator.webdriver to false to avoid detection of automation tools.

4. Headless
   Only changes User-Agent from HeadlessChrome to Chrome. Other headless characteristics remain unchanged, use with caution.

Enabling Fingerprint Features with Command Line Arguments

You can enable or customize fingerprinting and privacy protection features by passing command line arguments when launching the browser:

New Command Line Arguments in Chrome 139

GPU Fingerprinting Parameters

Note: --fingerprint-gpu-vendor and --fingerprint-gpu-renderer have been removed in Chrome 144. Use --disable-spoofing=gpu to disable GPU fingerprint spoofing instead.

Starting from Chrome 139, GPU fingerprinting is automatically enabled when using the --fingerprint parameter. The following optional parameters allow for custom GPU configuration:

• --fingerprint-gpu-vendor (Optional)

  • Customize the GPU vendor string for WebGL fingerprinting.
  • Examples: Intel Inc., NVIDIA Corporation, AMD, Apple
  • If not specified, GPU vendor will be automatically generated based on the fingerprint seed.

• --fingerprint-gpu-renderer (Optional)

  • Customize the GPU renderer/model string for WebGL fingerprinting.
  • Examples: Intel Iris OpenGL Engine, NVIDIA GeForce GTX 1060, AMD Radeon RX 580
  • If not specified, GPU renderer will be automatically generated based on the fingerprint seed.

User-Agent Customization Command Line Arguments (Chrome 131)

Chrome 131 introduced two command line arguments for advanced customization of User-Agent and User-Agent Data:

• --fingerprint-brand

  • Specifies the browser brand used in User-Agent and User-Agent Data.
  • Supported values: Chrome, Edge, Opera, Vivaldi, or custom brand names.
  • If not specified, the default brand is Chromium.

• --fingerprint-brand-version

  • Specifies the version number for the specified brand.
  • Default values: Chrome, Edge, Opera, Vivaldi all provide default versions, custom versions can also be passed.

These arguments enhance browser environment simulation capabilities, suitable for automation and testing scenarios. If --fingerprint-brand is not specified, the default brand will be used.

New Features in Chrome 142

1. Updated UserAgent and UserAgentData Fingerprint Implementation

   • Improved fingerprint implementation for navigator.userAgent and navigator.userAgentData.

2. Updated Audio Fingerprint Implementation

   • Enhanced audio fingerprint modification. You can verify the effect at https://pixelscan.net/fingerprint-check

3. Updated Canvas Fingerprint Implementation

   • Improved Canvas fingerprint modification for better anti-detection.

4. GPU Fingerprint Disable Option

   • GPU fingerprint may have issues in some scenarios. Use --disable-gpu-fingerprint parameter to disable GPU fingerprint if needed.
   • Removed in Chrome 144. Use --disable-spoofing=gpu instead.

New Features in Chrome 144

1. Removed GPU Fingerprint Parameters

   • Removed --fingerprint-gpu-vendor, --fingerprint-gpu-renderer, and --disable-gpu-fingerprint parameters.

2. New --disable-spoofing Parameter

   • A comma-separated parameter to selectively disable specific fingerprint spoofing.
   • Available values: font, audio, canvas, clientrects, gpu
   • Example: --disable-spoofing=font,gpu disables font and GPU fingerprint spoofing.

Usage Examples

Here are command line examples for several common use cases:

Basic Usage

./chrome --fingerprint=1000 --user-data-dir=/tmp/chromium/1000 --timezone="America/Los_Angeles" --proxy-server="your_proxy_server_address"

Customizing User-Agent

chrome.exe --fingerprint=2023 --fingerprint-platform=macos --fingerprint-platform-version="15.2.0" --fingerprint-brand="Edge"  --user-data-dir=%TEMP%\chromium

Fingerprint Testing

User Communication

Scan the QR code to join QQ groups to communicate with other users

If you need Chrome customization development services or are looking for custom development opportunities, please join the development customization group (QQ group 1055930761)

Sponsors

IPdodo

A trusted proxy IP provider that delivers all-in-one solutions of high-anonymity, high-speed, and secure proxy IPs combined with S5 forwarding services, tailored for cross-border e-commerce, social media operations, web scraping, data collection, and global business growth.

Offer: Register today to get 1GB of free residential proxy traffic.

• Invitation Code: ATUQ3Q0O

🔗 Register Now

IPFly

A cost-effective IP service provider with high-quality IPs and 7x24 customer support.

Offer: Register via exclusive link to enjoy 10% off sitewide.

• Discount Code: adryfish
• Invitation Code: 9A2WLGX9

🔗 Register Now

RapidProxy

A high-performance proxy provider offering clean residential and native static ISP IPs with high anonymity, fast speeds, and low block rates. Designed for web scraping, social media automation, e-commerce, and global business operations.

Offer: Free trial available with non-expiring residential proxy traffic. Highlight: Native static IPs with low detection and stable performance.

• Discount Code: adryfish (10% OFF)

🔗 Register Now

OKKproxy

🔥 OKKproxy offers 80 million global residential IPs as a first-hand provider, with TB-level bulk purchasing as low as $0.4/GB.

• 🌐 Coverage: Rotating residential proxy IPs / overseas mobile IPs / static residential IPs.
• 🎀 Proxy Types: Supports HTTP(S) and SOCKS5 proxies.
• 🎉 Use Cases: Suitable for e-commerce, social media, multi-accounting, and SEO.
• 🤝 Established: 3 years.

🔗 Register Now

Credits

• Ungoogled Chromium

License

BSD-3-clause. See LICENSE