ClientID (Javadocs [I2P+ 2.13.0+] - API Version 0.9.70+)

java.lang.Object
- org.klomp.snark.ClientID

```
public final class ClientID
extends Object
```
Registry of known BitTorrent client identities.
Two things live here:
- The peer ID prefix recognition table mapping the first three raw peer ID bytes (as the first four Base64 characters of the ID) to a client name. This is the single source of truth; I2PSnarkServlet delegates to it.
- Spoofing profiles for well-known clearnet clients, each bundling a peer ID prefix, the HTTP tracker User-Agent, and the BEP 10 extension handshake "v" string, with consistent version numbers across all three surfaces.
Spoofing is opt-in via the i2psnark.clientId property (empty to identify as I2PSnark, "random" to select a random profile per destination per run, or a profile name to always impersonate that client), optionally restricted to a subset via i2psnark.clientIds. Only clients recognizable by our own identification table are spoofable, so the console peers page keeps showing a real client name for our own IDs.
Version strings are pinned to upstream client releases verified as of 2026-08; bump them only when an upstream release changes the UA or "v" format, since point releases do not require updates. All three strings of a profile must carry the same version, as trackers may cross-check them.

Nested Class Summary
Nested Classes
Modifier and Type Class and Description
static class ClientID.Profile
One impersonatable client: peer ID prefix plus the matching tracker User-Agent and extension handshake "v" strings.

Nested Classes
Modifier and Type	Class and Description
`static class`	`ClientID.Profile` One impersonatable client: peer ID prefix plus the matching tracker User-Agent and extension handshake "v" strings.

Field Summary

Fields
Modifier and Type	Field and Description
`static ClientID.Profile`	`BIGLYBT`
`static ClientID.Profile`	`DELUGE`
`static ClientID.Profile`	`KTORRENT`
`static ClientID.Profile`	`LIBTORRENT`
`static ClientID.Profile`	`QBITTORRENT`
`static ClientID.Profile`	`TIXATI`
`static ClientID.Profile`	`TRANSMISSION`
`static ClientID.Profile`	`VUZE`

Constructor Summary
Constructors
Constructor and Description
ClientID()

Constructors
Constructor and Description
`ClientID()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static ClientID.Profile`	`getByName(String name)` Look up a profile by name, case-insensitively.
`static String`	`getClientName(String ch)` The client name for a peer ID prefix, from the same table used to identify remote peers in the console.
`static ClientID.Profile`	`getRandomProfile(Random random, List<ClientID.Profile> candidates)` A random profile, optionally restricted to a candidate subset.
`static List<ClientID.Profile>`	`parseCandidateList(String raw)` Parse a comma-separated i2psnark.clientIds value into profiles, dropping whitespace, duplicates, and names that match no known client.
`static List<ClientID.Profile>`	`profiles()` All spoofable client profiles, unmodifiable.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - BIGLYBT
```
public static final ClientID.Profile BIGLYBT
```
  - DELUGE
```
public static final ClientID.Profile DELUGE
```
  - KTORRENT
```
public static final ClientID.Profile KTORRENT
```
  - LIBTORRENT
```
public static final ClientID.Profile LIBTORRENT
```
  - QBITTORRENT
```
public static final ClientID.Profile QBITTORRENT
```
  - TIXATI
```
public static final ClientID.Profile TIXATI
```
  - TRANSMISSION
```
public static final ClientID.Profile TRANSMISSION
```
  - VUZE
```
public static final ClientID.Profile VUZE
```
- Constructor Detail
  - ClientID
```
public ClientID()
```
- Method Detail
  - getByName
```
public static ClientID.Profile getByName(String name)
```
    Look up a profile by name, case-insensitively.
    Parameters:
    name - the profile name, e.g. "Vuze" or "qbittorrent"
    Returns:
    the profile, or null if unknown
  - getClientName
```
public static String getClientName(String ch)
```
    The client name for a peer ID prefix, from the same table used to identify remote peers in the console.
    Parameters:
    ch - the first four Base64 characters of the peer ID, i.e. the Base64 of its first three non-zero bytes
    Returns:
    the client name, or null if unknown
  - getRandomProfile
```
public static ClientID.Profile getRandomProfile(Random random,
                                                List<ClientID.Profile> candidates)
```
    A random profile, optionally restricted to a candidate subset.
    Parameters:
    random - the randomness source
    candidates - profiles to choose from; null or empty for all
    Returns:
    one of the candidates, never null
  - parseCandidateList
```
public static List<ClientID.Profile> parseCandidateList(String raw)
```
    Parse a comma-separated i2psnark.clientIds value into profiles, dropping whitespace, duplicates, and names that match no known client.
    Parameters:
    raw - the raw property value, may be null or empty
    Returns:
    the recognized profiles in order, unmodifiable; empty if none
  - profiles
```
public static List<ClientID.Profile> profiles()
```
    All spoofable client profiles, unmodifiable.
    Returns:
    an unmodifiable list of profiles, never null

Class ClientID

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

BIGLYBT

DELUGE

KTORRENT

LIBTORRENT

QBITTORRENT

TIXATI

TRANSMISSION

VUZE

Constructor Detail

ClientID

Method Detail

getByName

getClientName

getRandomProfile

parseCandidateList

profiles