Skip to content

gradinazz/CSFloat-Helper

Repository files navigation

CSFloat Helper

Screenshot

Desktop application for convenient inventory management on CSFloat marketplace (CS2).

Features

Listing Management

  • Bulk Listing β€” list multiple items for sale at once
  • Delisting β€” quickly remove items from sale
  • Relisting β€” relist items back to marketplace
  • Price Changes β€” three methods:
    • Set new price value
    • Change price by fixed amount (+/- fixed sum)
    • Change price by percentage (+/- %)

Personalization

  • Custom Note per Account β€” configure individual listing note for each API key
  • Multi-account Support β€” work with multiple accounts simultaneously

Filtering and Display

  • Filters by item name, collection, rarity, wear condition
  • Filters by stickers and float value
  • Display days on sale for each item
  • Information about price, stickers, keychains
  • Status bar showing item count, listings on sale, and selected items

Item Info

  • Detailed item dialog with current listings, recent sales, buy orders and price history chart
  • Float, seed, sticker filters with scroll pagination
  • Price statistics with scoring indicators (7d / 30d / 90d)
  • Collection comparison panel

Item Info

Additional Features

  • View user information (Steam ID, balance, sales statistics)
  • Keep Online β€” automatically maintain online status
  • Light/Dark theme switching
  • Image caching for fast loading

Installation and Setup

Requirements

  • Python 3.7 or higher
  • Windows / Linux / macOS

Quick Start

  1. Clone the repository or download the archive

  2. Rename config.example.json to config.json:

# Linux/macOS
mv config.example.json config.json

# Windows
ren config.example.json config.json
  1. Open config.json and insert your CSFloat API key:
{
    "api_keys": [
        "YOUR_CSFLOAT_API_KEY"
    ]
}

Replace YOUR_CSFLOAT_API_KEY with your actual API key.

How to get CSFloat API key:

  1. Go to CSFloat
  2. Log in to your account
  3. Open profile settings β†’ API
  4. Create a new API key

Multiple accounts: To add more accounts, simply add more keys to the array:

{
    "api_keys": [
        "first_account_api_key",
        "second_account_api_key",
        "third_account_api_key"
    ]
}

Running

Windows (Recommended):

Simply run the launcher - it will automatically install dependencies if needed:

run_csfloat_helper.bat

Linux/macOS or Manual Launch:

pip install -r requirements.txt
python csfloat_helper.py

Usage

  1. Select account from dropdown (if using multiple API keys)
  2. Load inventory β€” click "Load Inventory" button
  3. Apply filters β€” use search fields and filters to find needed items
  4. Select items β€” check the items you need in the table
  5. Execute operation:
    • Sell β€” list items for sale
    • Delist β€” remove items from sale
    • Change Price β€” modify price of listed items
    • Swap β€” swap prices between two items

Security

  • API keys are stored locally and hashed in Windows registry (SHA-256)
  • Never share your API key with third parties

Technologies

  • Python 3.7+
  • PyQt6 β€” graphical interface
  • urllib β€” HTTP requests to CSFloat API
  • orjson β€” fast JSON parsing
  • Threading β€” asynchronous operations

Project Structure

CSFloat-Helper-main/
β”œβ”€β”€ csfloat_helper.py           # Entry point
β”œβ”€β”€ config.json                 # API keys (create from config.example.json)
β”œβ”€β”€ requirements.txt            # Dependencies
β”œβ”€β”€ run_csfloat_helper.bat     # Quick launch (Windows)
β”‚
β”œβ”€β”€ modules/                    # Core modules
β”‚   β”œβ”€β”€ api.py                 # CSFloat API integration
β”‚   β”œβ”€β”€ ui.py                  # Main application window
β”‚   β”œβ”€β”€ workers.py             # Background threads
β”‚   β”œβ”€β”€ theme.py               # Theme system
β”‚   └── ...
β”‚
β”œβ”€β”€ utils/                      # Resources (icons, fonts)
└── cache/                      # Image cache

Contributing

If you have suggestions for improvements or found a bug:

  1. Create an Issue on GitHub
  2. Submit a Pull Request with description of changes

License

MIT License


CSFloat Helper β€” fast and convenient CS2 inventory management.

About

csfloat helper - fast sell, delist and change price.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors