cs2inspect 0.5.0

CS2 inspect link utility

cs2inspect

Overview

cs2inspect is a python package used for creating and working with counter-strike inspect links and gen codes.

Features

• Creating 'unmasked' inspect links (containing the owners steam id)
• Creating 'masked' (XOR-capable) inspect links
• Decoding/Parsing inspect links back into data or protobuf objects
• Parsing Enrichment: Resolve numeric IDs to human-readable names (Weapon, Skin, Rarity, Origin, Quality, etc.)
• Creating gen codes
• Creating console pasteable inspect links
• Checking inspect link validity (robust regex supporting modern CS2 formats)

Installation

pip install cs2inspect

Quick Start

Link Creation

import cs2inspect

# Create a modern 'masked' link using the Builder
proto = cs2inspect.Builder(
    defindex=7,
    paintindex=941,
    paintseed=0,
    paintwear=0.15,
    rarity=5
)
link = cs2inspect.link(proto.build())
print(link) # steam://rungame/730/76561202255233023/+csgo_econ_action_preview%2000180720AD072805389AB3E6F00340006F59908E

Basic Parsing

import cs2inspect

# Parse a modern 'masked' inspect link
link = "steam://run/730//+csgo_econ_action_preview%206A7AC7C6BEDED06B72704ACE6F426F5A635296868780692AAC6C226A3A6A02E9EAEAEA661A625E7EE646"
data = cs2inspect.parse(link)

print(data['defindex'])    # 26 (PP-Bizon)
print(data['floatvalue'])  # 0.05357979

Smart Enrichment

import cs2inspect

# Resolve IDs to names using an external schema
cs2inspect.download_schema()
info = cs2inspect.parse(link, enrich=True)

print(info['full_item_name']) # AK-47 | Slate (Minimal Wear)

Documentation

For detailed information, please refer to the following docs:

• Example Usage: Comprehensive examples for link creation, parsing, and enrichment.
• Output Model: Detailed specification of the dictionary structure returned by parse().

---

Technical Limitations (Parsing)

cs2inspect is a local, offline decoder. Masked/Modern links (binary Protobuf payload) are fully supported with offline enrichment of stickers, floats, and charms. Unmasked/Legacy links (S/M A D pointers) have only minimal support as they contain no binary property data; resolving their attributes requires a call to the GameCoordinator (GC), which is outside the scope of this offline library.

Contributing

Contributions are welcome! Open an issue or submit a pull request.

License

GPLv3 License. See the LICENSE file for details.

Acknowledgements

Special thanks to these projects for their foundational work and metadata tracking:

• csfloat/inspect - Foundational skin inspect library
• ByMykel/CSGO-API - Primary source for the schema files
• SteamTracking/GameTracking-CS2 - Source for Rarity and Quality enums
• SteamDatabase/SteamTracking - Source for Origin enum