cs2tracker 2.1.16__tar.gz → 2.1.18__tar.gz

{cs2tracker-2.1.16 → cs2tracker-2.1.18}/.gitignore

@@ -14,8 +14,10 @@ cs2tracker.egg-info
 # Auto generated version file on build
 _version.py
 
-# PyInstaller output
+# PyInstaller files
 output
+cs2tracker.spec
+build.ps1
 
 # Files generated by the program
 cs2tracker_scraper.bat

{cs2tracker-2.1.16 → cs2tracker-2.1.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cs2tracker
-Version: 2.1.16
+Version: 2.1.18
 Summary: Tracking the steam market prices of CS2 items
 Home-page: https://github.com/ashiven/cs2tracker
 Author: Jannik Novak
@@ -54,6 +54,7 @@ Dynamic: license-file
 - [Usage](#usage)
 - [Configuration](#configuration)
 - [Advanced Features](#advanced-features)
+- [FAQ](#faq)
 - [Contributing](#contributing)
 - [License](#license)
 
@@ -74,8 +75,9 @@ Dynamic: license-file
 #### Method 1: Executable
 
 Simply download the program and run it:
-  - [Windows](https://github.com/ashiven/cs2tracker/releases/latest/download/cs2tracker-windows.zip)
-  - [Linux](https://github.com/ashiven/cs2tracker/releases/latest/download/cs2tracker-linux.zip)
+
+- [Windows](https://github.com/ashiven/cs2tracker/releases/latest/download/cs2tracker-windows.zip)
+- [Linux](https://github.com/ashiven/cs2tracker/releases/latest/download/cs2tracker-linux.zip)
 
 #### Method 2: Install via Pip
 
@@ -90,6 +92,7 @@ Simply download the program and run it:
    ```bash
    cs2tracker
    ```
+
 ### Additional Setup
 
 - Register for the [Crawlbase Smart Proxy API](https://crawlbase.com/) and retrieve your API key. (Optional)
@@ -117,18 +120,36 @@ This will open the config editor where you can change any setting by double clic
 
 - Enable **Daily Background Calculations** to automatically run a daily calculation of your investment in the background.
 - Use **Receive Discord Notifications** to receive a notification on your Discord server whenever the program has finished calculating your investment.
-- You need to set up a [webhook](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks) in your Discord server and enter the webhook url into the `discord_webhook_url` field in the config `User Settings`.
+- You need to set up a [webhook](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks) in your Discord server and enter the webhook URL into the `discord_webhook_url` field in the config `User Settings`.
 - Enable **Proxy Requests** to prevent your requests from being rate limited by the steamcommunity server.
 - You need to register for a free API key on [Crawlbase](crawlbase.com) and enter it into the `proxy_api_key` field in the config `User Settings`.
 
+## FAQ
+
+- **Q: Is it safe to login with my Steam account?**
+- **A:** Yes, the program uses the [SteamUser](https://github.com/DoctorMcKay/node-steam-user?tab=readme-ov-file#methods-) and [Globaloffensive](https://github.com/DoctorMcKay/node-globaloffensive) libraries to sign in and import your Storage Units (the same method is used by [casemove](https://github.com/nombersDev/casemove)) and all of the login-related code is transparently available in [this file](cs2tracker/data/get_inventory.js).
+
+
+- **Q: Do I have to login with my Steam account?**
+- **A:** No, you can also manually specify the number of items you own in the config editor.
+
+
+- **Q: Can I get VAC-banned for using this program?**
+- **A:** No, this program does not interact with the game in any way and only reads your Storage Units.
+
+
+- **Q: Why does Windows Defender flag this program as potentially harmful?**
+- **A:** This is because the program is not signed with a [Code Signing Certificate](https://www.globalsign.com/en/code-signing-certificate/what-is-code-signing-certificate), which Windows uses to verify the identity of publishers. These certificates are very expensive and not something I am willing to invest in for a free and open source project like this.
+
 ## Contributing
 
-Please feel free to submit a pull request or open an issue. See [issues](https://github.com/ashiven/cs2tracker/issues) and [pull requests](https://github.com/ashiven/cs2tracker/pulls) for current work.
+Please feel free to submit a [pull request](https://github.com/ashiven/cs2tracker/pulls) or open an [issue](https://github.com/ashiven/cs2tracker/issues).
 
 1. Fork the repository
-2. Create a new branch
+2. Create a new branch: `git checkout -b feature-name`.
 3. Make your changes
-4. Submit a PR
+4. Push your branch: `git push origin feature-name`.
+5. Submit a PR
 
 ## License
 

{cs2tracker-2.1.16 → cs2tracker-2.1.18}/README.md

@@ -26,6 +26,7 @@
 - [Usage](#usage)
 - [Configuration](#configuration)
 - [Advanced Features](#advanced-features)
+- [FAQ](#faq)
 - [Contributing](#contributing)
 - [License](#license)
 
@@ -46,8 +47,9 @@
 #### Method 1: Executable
 
 Simply download the program and run it:
-  - [Windows](https://github.com/ashiven/cs2tracker/releases/latest/download/cs2tracker-windows.zip)
-  - [Linux](https://github.com/ashiven/cs2tracker/releases/latest/download/cs2tracker-linux.zip)
+
+- [Windows](https://github.com/ashiven/cs2tracker/releases/latest/download/cs2tracker-windows.zip)
+- [Linux](https://github.com/ashiven/cs2tracker/releases/latest/download/cs2tracker-linux.zip)
 
 #### Method 2: Install via Pip
 
@@ -62,6 +64,7 @@ Simply download the program and run it:
    ```bash
    cs2tracker
    ```
+
 ### Additional Setup
 
 - Register for the [Crawlbase Smart Proxy API](https://crawlbase.com/) and retrieve your API key. (Optional)
@@ -89,18 +92,36 @@ This will open the config editor where you can change any setting by double clic
 
 - Enable **Daily Background Calculations** to automatically run a daily calculation of your investment in the background.
 - Use **Receive Discord Notifications** to receive a notification on your Discord server whenever the program has finished calculating your investment.
-- You need to set up a [webhook](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks) in your Discord server and enter the webhook url into the `discord_webhook_url` field in the config `User Settings`.
+- You need to set up a [webhook](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks) in your Discord server and enter the webhook URL into the `discord_webhook_url` field in the config `User Settings`.
 - Enable **Proxy Requests** to prevent your requests from being rate limited by the steamcommunity server.
 - You need to register for a free API key on [Crawlbase](crawlbase.com) and enter it into the `proxy_api_key` field in the config `User Settings`.
 
+## FAQ
+
+- **Q: Is it safe to login with my Steam account?**
+- **A:** Yes, the program uses the [SteamUser](https://github.com/DoctorMcKay/node-steam-user?tab=readme-ov-file#methods-) and [Globaloffensive](https://github.com/DoctorMcKay/node-globaloffensive) libraries to sign in and import your Storage Units (the same method is used by [casemove](https://github.com/nombersDev/casemove)) and all of the login-related code is transparently available in [this file](cs2tracker/data/get_inventory.js).
+
+
+- **Q: Do I have to login with my Steam account?**
+- **A:** No, you can also manually specify the number of items you own in the config editor.
+
+
+- **Q: Can I get VAC-banned for using this program?**
+- **A:** No, this program does not interact with the game in any way and only reads your Storage Units.
+
+
+- **Q: Why does Windows Defender flag this program as potentially harmful?**
+- **A:** This is because the program is not signed with a [Code Signing Certificate](https://www.globalsign.com/en/code-signing-certificate/what-is-code-signing-certificate), which Windows uses to verify the identity of publishers. These certificates are very expensive and not something I am willing to invest in for a free and open source project like this.
+
 ## Contributing
 
-Please feel free to submit a pull request or open an issue. See [issues](https://github.com/ashiven/cs2tracker/issues) and [pull requests](https://github.com/ashiven/cs2tracker/pulls) for current work.
+Please feel free to submit a [pull request](https://github.com/ashiven/cs2tracker/pulls) or open an [issue](https://github.com/ashiven/cs2tracker/issues).
 
 1. Fork the repository
-2. Create a new branch
+2. Create a new branch: `git checkout -b feature-name`.
 3. Make your changes
-4. Submit a PR
+4. Push your branch: `git push origin feature-name`.
+5. Submit a PR
 
 ## License
 

{cs2tracker-2.1.16 → cs2tracker-2.1.18}/cs2tracker/_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '2.1.16'
-__version_tuple__ = version_tuple = (2, 1, 16)
+__version__ = version = '2.1.18'
+__version_tuple__ = version_tuple = (2, 1, 18)

{cs2tracker-2.1.16 → cs2tracker-2.1.18}/cs2tracker/app/app.py

@@ -15,6 +15,7 @@ from cs2tracker.logs import PriceLogs
 from cs2tracker.scraper.background_task import BackgroundTask
 from cs2tracker.scraper.scraper import Scraper
 from cs2tracker.util.currency_conversion import CURRENCY_SYMBOLS
+from cs2tracker.util.padded_console import get_console
 from cs2tracker.util.tkinter import centered, fix_sv_ttk, size_info
 
 APPLICATION_NAME = "CS2Tracker"
@@ -31,6 +32,7 @@ PRICE_HISTORY_TITLE = "Price History"
 PRICE_HISTORY_SIZE = "900x700"
 
 config = get_config()
+console = get_console()
 
 
 class Application:
@@ -48,6 +50,7 @@ class Application:
 
         fix_sv_ttk(ttk.Style())
 
+        window.focus_force()
         window.mainloop()
 
     def _configure_window(self):
@@ -76,6 +79,10 @@ class MainFrame(ttk.Frame):
         super().__init__(parent, padding=15)
         self.parent = parent
         self.scraper = scraper
+
+        self.scraper_window = None
+        self.config_editor_window = None
+        self.price_history_window = None
         self._add_widgets()
 
     def _add_widgets(self):
@@ -181,13 +188,21 @@ class MainFrame(ttk.Frame):
         """Scrape prices from the configured sources, print the total, and save the
         results to a file.
         """
-        scraper_window = tk.Toplevel(self.parent)
-        scraper_window.geometry(centered(scraper_window, SCRAPER_WINDOW_SIZE))
-        scraper_window.minsize(*size_info(SCRAPER_WINDOW_SIZE))
-        scraper_window.title(SCRAPER_WINDOW_TITLE)
+        if self.scraper_window is None or not self.scraper_window.winfo_exists():
+            self._open_scraper_window()
+        else:
+            self.scraper_window.lift()
+            self.scraper_window.focus_set()
+
+    def _open_scraper_window(self):
+        """Open a new window with the scraper GUI."""
+        self.scraper_window = tk.Toplevel(self.parent)
+        self.scraper_window.geometry(centered(self.scraper_window, SCRAPER_WINDOW_SIZE))
+        self.scraper_window.minsize(*size_info(SCRAPER_WINDOW_SIZE))
+        self.scraper_window.title(SCRAPER_WINDOW_TITLE)
 
         run_frame = ScraperFrame(
-            scraper_window,
+            self.scraper_window,
             self.scraper,
             sheet_size=SCRAPER_WINDOW_SIZE,
             dark_theme=self.dark_theme_checkbox_value.get(),
@@ -196,26 +211,42 @@ class MainFrame(ttk.Frame):
         run_frame.start()
 
     def _edit_config(self):
+        """Open a new window with a config editor GUI or lift the existing one."""
+        if self.config_editor_window is None or not self.config_editor_window.winfo_exists():
+            self._open_config_editor()
+        else:
+            self.config_editor_window.lift()
+            self.config_editor_window.focus_set()
+
+    def _open_config_editor(self):
         """Open a new window with a config editor GUI."""
-        config_editor_window = tk.Toplevel(self.parent)
-        config_editor_window.geometry(centered(config_editor_window, CONFIG_EDITOR_SIZE))
-        config_editor_window.minsize(*size_info(CONFIG_EDITOR_SIZE))
-        config_editor_window.title(CONFIG_EDITOR_TITLE)
+        self.config_editor_window = tk.Toplevel(self.parent)
+        self.config_editor_window.geometry(centered(self.config_editor_window, CONFIG_EDITOR_SIZE))
+        self.config_editor_window.minsize(*size_info(CONFIG_EDITOR_SIZE))
+        self.config_editor_window.title(CONFIG_EDITOR_TITLE)
 
-        editor_frame = ConfigEditorFrame(config_editor_window)
+        editor_frame = ConfigEditorFrame(self.config_editor_window)
         editor_frame.pack(expand=True, fill="both")
 
     def _show_history(self):
         """Show a chart consisting of past calculations."""
+        if self.price_history_window is None or not self.price_history_window.winfo_exists():
+            self._open_history_window()
+        else:
+            self.price_history_window.lift()
+            self.price_history_window.focus_set()
+
+    def _open_history_window(self):
+        """Open a new window with a price history GUI."""
         if PriceLogs.empty():
             return
 
-        price_history_window = tk.Toplevel(self.parent)
-        price_history_window.geometry(centered(price_history_window, PRICE_HISTORY_SIZE))
-        price_history_window.minsize(*size_info(PRICE_HISTORY_SIZE))
-        price_history_window.title(PRICE_HISTORY_TITLE)
+        self.price_history_window = tk.Toplevel(self.parent)
+        self.price_history_window.geometry(centered(self.price_history_window, PRICE_HISTORY_SIZE))
+        self.price_history_window.minsize(*size_info(PRICE_HISTORY_SIZE))
+        self.price_history_window.title(PRICE_HISTORY_TITLE)
 
-        history_frame = PriceHistoryFrame(price_history_window)
+        history_frame = PriceHistoryFrame(self.price_history_window)
         history_frame.pack(expand=True, fill="both")
 
     def _export_log_file(self):
@@ -239,8 +270,10 @@ class MainFrame(ttk.Frame):
             filetypes=[("CSV files", "*.csv")],
         )
         if not PriceLogs.validate_file(import_path):
+            console.error("Invalid log file format.")
             return
         copy(import_path, OUTPUT_FILE)
+        console.info("Log file imported successfully.")
 
     def _toggle_background_task(self, enabled: bool):
         """Toggle whether a daily price calculation should run in the background."""

{cs2tracker-2.1.16 → cs2tracker-2.1.18}/cs2tracker/app/editor_frame.py

@@ -8,7 +8,7 @@ from tkinter import messagebox, ttk
 from nodejs import node
 from ttk_text import ThemedText
 
-from cs2tracker.config import get_config
+from cs2tracker.config import CUSTOM_SECTIONS, get_config
 from cs2tracker.constants import (
     CONFIG_FILE,
     CONFIG_FILE_BACKUP,
@@ -131,7 +131,7 @@ class ConfigEditorFrame(ttk.Frame):
         if selected:
             item = selected[0]
             section_name = self.tree.parent(item)
-            if section_name in ("Stickers", "Skins"):
+            if section_name in CUSTOM_SECTIONS:
                 next_option = self.tree.next(item)
                 self.tree.delete(item)
                 self.save_config()
@@ -169,31 +169,19 @@ class ConfigEditorFrame(ttk.Frame):
                 continue
 
             section_level = self.tree.insert("", "end", iid=section, text=section)
-
-            # Items in the Stickers, Cases, and Skins sections should be displayed alphabetically sorted
-            section_items = config.items(section)
-            if section in ("Stickers", "Cases", "Skins"):
-                section_items = sorted(section_items)
-
-            for config_option, value in section_items:
+            sorted_section_items = sorted(config.items(section))
+            for config_option, value in sorted_section_items:
                 if section not in ("User Settings", "App Settings"):
                     option_name = config.option_to_name(config_option, href=True)
-                    self.tree.insert(
-                        section_level,
-                        "end",
-                        iid=f"{section}-{option_name}",
-                        text=option_name,
-                        values=[value],
-                    )
                 else:
                     option_name = config.option_to_name(config_option)
-                    self.tree.insert(
-                        section_level,
-                        "end",
-                        iid=f"{section}-{option_name}",
-                        text=option_name,
-                        values=[value],
-                    )
+                self.tree.insert(
+                    section_level,
+                    "end",
+                    iid=f"{section}-{option_name}",
+                    text=option_name,
+                    values=[value],
+                )
 
         self.tree.focus("User Settings")
         self.tree.selection_set("User Settings")
@@ -253,6 +241,8 @@ class ConfigEditorButtonFrame(ttk.Frame):
         self.editor_frame = editor_frame
         self.custom_item_dialog = None
 
+        self.custom_item_window = None
+        self.steam_inventory_window = None
         self._add_widgets()
 
     def _add_widgets(self):
@@ -265,6 +255,25 @@ class ConfigEditorButtonFrame(ttk.Frame):
         custom_item_button = ttk.Button(self, text="Add Item", command=self._add_custom_item)
         custom_item_button.pack(side="left", expand=True, padx=5)
 
+        def open_custom_enter(_):
+            selected = self.editor_frame.tree.selection()
+            if selected and not self.editor_frame.tree.parent(selected[0]):
+                selected_section = self.editor_frame.tree.item(selected[0], "text")
+                if selected_section in CUSTOM_SECTIONS and not self.editor_frame.tree.get_children(
+                    selected_section
+                ):
+                    custom_item_button.invoke()
+
+        def open_custom_click(event):
+            selected_section = self.editor_frame.tree.identify_row(event.y)
+            if selected_section in CUSTOM_SECTIONS and not self.editor_frame.tree.get_children(
+                selected_section
+            ):
+                custom_item_button.invoke()
+
+        self.editor_frame.tree.bind("<Return>", open_custom_enter, add="+")
+        self.editor_frame.tree.bind("<Double-1>", open_custom_click, add="+")
+
         import_inventory_button = ttk.Button(
             self, text="Import Steam Inventory", command=self._import_steam_inventory
         )
@@ -285,37 +294,59 @@ class ConfigEditorButtonFrame(ttk.Frame):
         self.editor_frame.tree.focus_set()
 
     def _add_custom_item(self):
+        """Open a window to add a new custom item or lift the existing one if it is
+        already open.
+        """
+        if self.custom_item_window is None or not self.custom_item_window.winfo_exists():
+            self._open_custom_item_window()
+        else:
+            self.custom_item_window.lift()
+            self.custom_item_window.focus_set()
+
+    def _open_custom_item_window(self):
         """Open a window to add a new custom item."""
-        custom_item_window = tk.Toplevel(self.editor_frame)
-        custom_item_window.title(ADD_CUSTOM_ITEM_TITLE)
-        custom_item_window.geometry(centered(custom_item_window, ADD_CUSTOM_ITEM_SIZE))
-        custom_item_window.minsize(*size_info(ADD_CUSTOM_ITEM_SIZE))
-        custom_item_window.focus_set()
+        self.custom_item_window = tk.Toplevel(self.editor_frame)
+        self.custom_item_window.title(ADD_CUSTOM_ITEM_TITLE)
+        self.custom_item_window.geometry(centered(self.custom_item_window, ADD_CUSTOM_ITEM_SIZE))
+        self.custom_item_window.minsize(*size_info(ADD_CUSTOM_ITEM_SIZE))
+        self.custom_item_window.focus_set()
 
         def on_close():
-            custom_item_window.destroy()
+            self.custom_item_window.destroy()  # type: ignore
             self.editor_frame.tree.focus_set()
 
-        custom_item_window.protocol("WM_DELETE_WINDOW", on_close)
+        self.custom_item_window.protocol("WM_DELETE_WINDOW", on_close)
 
-        custom_item_frame = CustomItemFrame(custom_item_window, self.editor_frame)
+        custom_item_frame = CustomItemFrame(self.custom_item_window, self.editor_frame)
         custom_item_frame.pack(expand=True, fill="both", padx=15, pady=15)
 
     def _import_steam_inventory(self):
+        """Open a window to import the user's Steam inventory or lift the existing one
+        if it is already open.
+        """
+        if self.steam_inventory_window is None or not self.steam_inventory_window.winfo_exists():
+            self._open_steam_inventory_window()
+        else:
+            self.steam_inventory_window.lift()
+            self.steam_inventory_window.focus_set()
+
+    def _open_steam_inventory_window(self):
         """Open a window to import the user's Steam inventory."""
-        steam_inventory_window = tk.Toplevel(self.editor_frame)
-        steam_inventory_window.title(IMPORT_INVENTORY_TITLE)
-        steam_inventory_window.geometry(centered(steam_inventory_window, IMPORT_INVENTORY_SIZE))
-        steam_inventory_window.minsize(*size_info(IMPORT_INVENTORY_SIZE))
-        steam_inventory_window.focus_set()
+        self.steam_inventory_window = tk.Toplevel(self.editor_frame)
+        self.steam_inventory_window.title(IMPORT_INVENTORY_TITLE)
+        self.steam_inventory_window.geometry(
+            centered(self.steam_inventory_window, IMPORT_INVENTORY_SIZE)
+        )
+        self.steam_inventory_window.minsize(*size_info(IMPORT_INVENTORY_SIZE))
+        self.steam_inventory_window.focus_set()
 
         def on_close():
-            steam_inventory_window.destroy()
+            self.steam_inventory_window.destroy()  # type: ignore
             self.editor_frame.tree.focus_set()
 
-        steam_inventory_window.protocol("WM_DELETE_WINDOW", on_close)
+        self.steam_inventory_window.protocol("WM_DELETE_WINDOW", on_close)
 
-        steam_inventory_frame = InventoryImportFrame(steam_inventory_window, self.editor_frame)
+        steam_inventory_frame = InventoryImportFrame(self.steam_inventory_window, self.editor_frame)
         steam_inventory_frame.pack(expand=True, fill="both", padx=15, pady=15)
 
 
@@ -373,6 +404,30 @@ class CustomItemFrame(ttk.Frame):
                 break
         return insert_index
 
+    def _identify_custom_section(self, item_name):
+        # pylint: disable=too-many-return-statements
+        """Given an item name, identify the custom section it belongs to."""
+        if "Patch Pack" in item_name or "Patch Collection" in item_name:
+            return "Patch Packs"
+        elif "Patch |" in item_name:
+            return "Patches"
+        elif "Sticker |" in item_name:
+            return "Stickers"
+        elif "Charm |" in item_name:
+            return "Charms"
+        elif "Souvenir" in item_name and "|" not in item_name:
+            return "Souvenirs"
+        elif "★ " in item_name:
+            return "Special Items"
+        elif " | " in item_name and "(" in item_name and ")" in item_name:
+            return "Skins"
+        elif "Music Kit |" in item_name:
+            return "Others"
+        elif " | " in item_name:
+            return "Agents"
+        else:
+            return "Others"
+
     def _add_custom_item(self, item_href, item_owned):
         """Add a custom item to the configuration."""
         if not item_href or not item_owned:
@@ -380,7 +435,7 @@ class CustomItemFrame(ttk.Frame):
                 "Input Error", "All fields must be filled out.", parent=self.window
             )
             return
-        if config.option_exists(item_href, exclude_sections=("Stickers", "Skins")):
+        if config.option_exists(item_href, exclude_sections=CUSTOM_SECTIONS):
             messagebox.showerror(
                 "Item Exists", "This item already exists in another section.", parent=self.window
             )
@@ -392,12 +447,11 @@ class CustomItemFrame(ttk.Frame):
             messagebox.showerror("Invalid URL", str(error), parent=self.window)
             return
 
-        if self._update_existing("Stickers", item_name, item_owned):
-            return
-        if self._update_existing("Skins", item_name, item_owned):
-            return
+        for section in CUSTOM_SECTIONS:
+            if self._update_existing(section, item_name, item_owned):
+                return
 
-        section = "Stickers" if item_name.startswith("Sticker") else "Skins"
+        section = self._identify_custom_section(item_name)
         insert_index = self._get_insert_index(item_name, section)
         self.editor_frame.tree.insert(
             section,

{cs2tracker-2.1.16 → cs2tracker-2.1.18}/cs2tracker/config.py

@@ -3,12 +3,53 @@ import re
 from configparser import ConfigParser, ParsingError
 from urllib.parse import quote, unquote
 
-from cs2tracker.constants import CAPSULE_PAGES, CONFIG_FILE, INVENTORY_IMPORT_FILE
+from cs2tracker.constants import (
+    CONFIG_FILE,
+    INVENTORY_IMPORT_FILE,
+)
 from cs2tracker.util.padded_console import get_console
 
 STEAM_MARKET_LISTING_BASEURL_CS2 = "https://steamcommunity.com/market/listings/730/"
 STEAM_MARKET_LISTING_REGEX = r"^https://steamcommunity.com/market/listings/\d+/.+$"
 
+CUSTOM_SECTIONS = [
+    "Skins",
+    "Special Items",
+    "Agents",
+    "Charms",
+    "Patches",
+    "Patch Packs",
+    "Stickers",
+    "Souvenirs",
+    "Others",
+]
+
+PREEXISTING_SECTIONS = [
+    "Cases",
+    "Katowice 2014 Sticker Capsule",
+    "Cologne 2014 Sticker Capsule",
+    "DreamHack 2014 Sticker Capsule",
+    "Katowice 2015 Sticker Capsule",
+    "Cologne 2015 Sticker Capsule",
+    "Cluj-Napoca 2015 Sticker Capsule",
+    "Columbus 2016 Sticker Capsule",
+    "Cologne 2016 Sticker Capsule",
+    "Atlanta 2017 Sticker Capsule",
+    "Krakow 2017 Sticker Capsule",
+    "Boston 2018 Sticker Capsule",
+    "London 2018 Sticker Capsule",
+    "Katowice 2019 Sticker Capsule",
+    "Berlin 2019 Sticker Capsule",
+    "2020 RMR Sticker Capsule",
+    "Stockholm 2021 Sticker Capsule",
+    "Antwerp 2022 Sticker Capsule",
+    "Rio 2022 Sticker Capsule",
+    "Paris 2023 Sticker Capsule",
+    "Copenhagen 2024 Sticker Capsule",
+    "Shanghai 2024 Sticker Capsule",
+    "Austin 2025 Sticker Capsule",
+]
+
 console = get_console()
 
 
@@ -46,19 +87,12 @@ class ValidatedConfig(ConfigParser):
 
     def _validate_config_sections(self):
         """Validate that the configuration file has all required sections."""
-        if not self.has_section("User Settings"):
-            raise ValueError("Missing 'User Settings' section in the configuration file.")
-        if not self.has_section("App Settings"):
-            raise ValueError("Missing 'App Settings' section in the configuration file.")
-        if not self.has_section("Stickers"):
-            raise ValueError("Missing 'Stickers' section in the configuration file.")
-        if not self.has_section("Cases"):
-            raise ValueError("Missing 'Cases' section in the configuration file.")
-        if not self.has_section("Skins"):
-            raise ValueError("Missing 'Skins' section in the configuration file.")
-        for capsule_section in CAPSULE_PAGES:
-            if not self.has_section(capsule_section):
-                raise ValueError(f"Missing '{capsule_section}' section in the configuration file.")
+        for section in CUSTOM_SECTIONS:
+            if not self.has_section(section):
+                raise ValueError(f"Missing '{section}' section in the configuration file.")
+        for section in PREEXISTING_SECTIONS:
+            if not self.has_section(section):
+                raise ValueError(f"Missing '{section}' section in the configuration file.")
 
     def _validate_config_values(self):
         # pylint: disable=too-many-branches
@@ -136,23 +170,22 @@ class ValidatedConfig(ConfigParser):
         try:
             with open(INVENTORY_IMPORT_FILE, "r", encoding="utf-8") as inventory_file:
                 inventory_data = json.load(inventory_file)
-                sorted_inventory_data = dict(sorted(inventory_data.items()))
 
                 added_to_config = set()
-                for item_name, item_owned in sorted_inventory_data.items():
-                    option = self.name_to_option(item_name, href=True)
-                    for section in self.sections():
-                        if option in self.options(section):
-                            self.set(section, option, str(item_owned))
-                            added_to_config.add(item_name)
-
-                for item_name, item_owned in sorted_inventory_data.items():
-                    if item_name not in added_to_config:
+                for _, item_infos in inventory_data.items():
+                    for item_name, item_owned in item_infos.items():
                         option = self.name_to_option(item_name, href=True)
-                        if item_name.startswith("Sticker"):
-                            self.set("Stickers", option, str(item_owned))
-                        else:
-                            self.set("Skins", option, str(item_owned))
+                        for section in self.sections():
+                            if option in self.options(section):
+                                self.set(section, option, str(item_owned))
+                                added_to_config.add(item_name)
+
+                for section, item_infos in inventory_data.items():
+                    sorted_item_infos = dict(sorted(item_infos.items()))
+                    for item_name, item_owned in sorted_item_infos.items():
+                        if item_name not in added_to_config:
+                            option = self.name_to_option(item_name, href=True)
+                            self.set(section, option, str(item_owned))
 
             self.write_to_file()
         except (FileNotFoundError, json.JSONDecodeError) as error:

{cs2tracker-2.1.16 → cs2tracker-2.1.18}/cs2tracker/constants.py

@@ -1,12 +1,18 @@
+import ctypes
 import enum
 import os
 import sys
+import tkinter as tk
 from datetime import datetime
-from shutil import copy
+from shutil import copy, copytree
 from subprocess import DEVNULL
+from tkinter import ttk
 
+import sv_ttk
 from nodejs import npm
 
+from cs2tracker.util.tkinter import centered
+
 try:
     from cs2tracker._version import version  # pylint: disable=E0611
 
@@ -48,33 +54,86 @@ if RUNNING_IN_EXE:
     else:
         raise NotImplementedError(f"Unsupported OS: {OS}")
 
-    DATA_DIR = os.path.join(APP_DATA_DIR, "cs2tracker", "data")
-    os.makedirs(DATA_DIR, exist_ok=True)
-
     CONFIG_FILE_SOURCE = os.path.join(MODULE_DIR, "data", "config.ini")
     OUTPUT_FILE_SOURCE = os.path.join(MODULE_DIR, "data", "output.csv")
-    IVENTORY_CONVERT_SCRIPT_SOURCE = os.path.join(MODULE_DIR, "data", "convert_inventory.js")
+    INVENTORY_CONVERT_SCRIPT_SOURCE = os.path.join(MODULE_DIR, "data", "convert_inventory.js")
     INVENTORY_IMPORT_SCRIPT_SOURCE = os.path.join(MODULE_DIR, "data", "get_inventory.js")
+    NODE_MODULES_SOURCE = os.path.join(MODULE_DIR, "data", "node_modules")
 
+    DATA_DIR = os.path.join(APP_DATA_DIR, "cs2tracker", "data")
     CONFIG_FILE = os.path.join(DATA_DIR, "config.ini")
     CONFIG_FILE_BACKUP = os.path.join(DATA_DIR, "config.ini.bak")
     OUTPUT_FILE = os.path.join(DATA_DIR, "output.csv")
-    IVENTORY_CONVERT_SCRIPT = os.path.join(DATA_DIR, "convert_inventory.js")
+    INVENTORY_CONVERT_SCRIPT = os.path.join(DATA_DIR, "convert_inventory.js")
     INVENTORY_IMPORT_SCRIPT = os.path.join(DATA_DIR, "get_inventory.js")
+    NODE_MODULES = os.path.join(DATA_DIR, "node_modules")
+
+    ICON_FILE = os.path.join(PROJECT_DIR, "assets", "icon.png")
+    BATCH_FILE = os.path.join(DATA_DIR, "cs2tracker_scraper.bat")
+    INVENTORY_IMPORT_FILE = os.path.join(DATA_DIR, "inventory.json")
+    INVENTORY_IMPORT_SCRIPT_DEPENDENCIES = [
+        "steam-user",
+        "globaloffensive",
+        "@node-steam/vdf",
+        "axios",
+    ]
+
+    def show_temp_popup():
+        """Show a temporary popup window while copying initial files."""
+        popup = tk.Tk()
+        popup.title("Please wait")
+        popup.geometry(centered(popup, "300x80"))
+        popup.resizable(False, False)
+        if OS == OSType.WINDOWS:
+            app_id = "cs2tracker.unique.id"
+            ctypes.windll.shell32.SetCurrentProcessExplicitAppUserModelID(app_id)
+        icon = tk.PhotoImage(file=ICON_FILE)
+        popup.wm_iconphoto(True, icon)
+
+        label = ttk.Label(popup, text="Setting up the application. Please wait...")
+        label.pack(pady=20)
+
+        sv_ttk.use_dark_theme()
+
+        popup.update()
+        return popup
+
+    def copy_initial_files_with_popup():
+        """Copy initial files to the user data directory with a temporary popup."""
+        popup = show_temp_popup()
+
+        try:
+            if not os.path.exists(DATA_DIR):
+                os.makedirs(DATA_DIR)
+            if not os.path.exists(OUTPUT_FILE):
+                copy(OUTPUT_FILE_SOURCE, OUTPUT_FILE)
+            if not os.path.exists(CONFIG_FILE):
+                copy(CONFIG_FILE_SOURCE, CONFIG_FILE)
+            if not os.path.exists(INVENTORY_CONVERT_SCRIPT):
+                copy(INVENTORY_CONVERT_SCRIPT_SOURCE, INVENTORY_CONVERT_SCRIPT)
+            if not os.path.exists(INVENTORY_IMPORT_SCRIPT):
+                copy(INVENTORY_IMPORT_SCRIPT_SOURCE, INVENTORY_IMPORT_SCRIPT)
+            if not os.path.exists(NODE_MODULES):
+                copytree(NODE_MODULES_SOURCE, NODE_MODULES)
+        finally:
+            popup.destroy()
+
+    # pylint: disable=too-many-boolean-expressions
+    if (
+        not os.path.exists(DATA_DIR)
+        or not os.path.exists(OUTPUT_FILE)
+        or not os.path.exists(CONFIG_FILE)
+        or not os.path.exists(INVENTORY_CONVERT_SCRIPT)
+        or not os.path.exists(INVENTORY_IMPORT_SCRIPT)
+        or not os.path.exists(NODE_MODULES)
+    ):
+        copy_initial_files_with_popup()
 
     # Always copy the source config into the user data directory as a backup
     # and overwrite the existing backup if it exists
     # (This is to ensure that no outdated config backup remains in the user data directory)
     copy(CONFIG_FILE_SOURCE, CONFIG_FILE_BACKUP)
 
-    if not os.path.exists(OUTPUT_FILE):
-        copy(OUTPUT_FILE_SOURCE, OUTPUT_FILE)
-    if not os.path.exists(CONFIG_FILE):
-        copy(CONFIG_FILE_SOURCE, CONFIG_FILE)
-    if not os.path.exists(IVENTORY_CONVERT_SCRIPT):
-        copy(IVENTORY_CONVERT_SCRIPT_SOURCE, IVENTORY_CONVERT_SCRIPT)
-    if not os.path.exists(INVENTORY_IMPORT_SCRIPT):
-        copy(INVENTORY_IMPORT_SCRIPT_SOURCE, INVENTORY_IMPORT_SCRIPT)
 
 else:
     MODULE_DIR = os.path.dirname(os.path.abspath(__file__))
@@ -86,24 +145,25 @@ else:
     OUTPUT_FILE = os.path.join(DATA_DIR, "output.csv")
     INVENTORY_CONVERT_SCRIPT = os.path.join(DATA_DIR, "convert_inventory.js")
     INVENTORY_IMPORT_SCRIPT = os.path.join(DATA_DIR, "get_inventory.js")
+    NODE_MODULES = os.path.join(DATA_DIR, "node_modules")
+
+    ICON_FILE = os.path.join(PROJECT_DIR, "assets", "icon.png")
+    BATCH_FILE = os.path.join(DATA_DIR, "cs2tracker_scraper.bat")
+    INVENTORY_IMPORT_FILE = os.path.join(DATA_DIR, "inventory.json")
+    INVENTORY_IMPORT_SCRIPT_DEPENDENCIES = [
+        "steam-user",
+        "globaloffensive",
+        "@node-steam/vdf",
+        "axios",
+    ]
 
     if not os.path.exists(CONFIG_FILE_BACKUP):
         copy(CONFIG_FILE, CONFIG_FILE_BACKUP)
 
 
-ICON_FILE = os.path.join(PROJECT_DIR, "assets", "icon.png")
-BATCH_FILE = os.path.join(DATA_DIR, "cs2tracker_scraper.bat")
-INVENTORY_IMPORT_FILE = os.path.join(DATA_DIR, "inventory.json")
-INVENTORY_IMPORT_SCRIPT_DEPENDENCIES = [
-    "steam-user",
-    "globaloffensive",
-    "@node-steam/vdf",
-    "axios",
-]
-
 # Ensures that the necessary node modules are installed if a user wants
 # to import their steam inventory via the cs2tracker/data/get_inventory.js Node.js script.
-if not os.path.exists(os.path.join(DATA_DIR, "node_modules")):
+if not os.path.exists(NODE_MODULES):
     npm.Popen(
         ["install", "-g", "--prefix", DATA_DIR] + INVENTORY_IMPORT_SCRIPT_DEPENDENCIES,
         stdout=DEVNULL,
@@ -127,6 +187,7 @@ AUTHOR_STRING = (
     f"Version: {VERSION} - {datetime.today().strftime('%Y/%m/%d')} - Jannik Novak @ashiven\n"
 )
 
+
 CAPSULE_PAGES = {
     "Katowice 2014 Sticker Capsule": "https://steamcommunity.com/market/search?q=katowice+2014+legends+challengers",
     "Cologne 2014 Sticker Capsule": "https://steamcommunity.com/market/search?q=cologne+2014+legends+challengers",

{cs2tracker-2.1.16 → cs2tracker-2.1.18}/cs2tracker/data/config.ini

@@ -9,8 +9,22 @@ discord_webhook_url ~
 
 [Skins]
 
+[Special Items]
+
+[Agents]
+
+[Charms]
+
+[Patches]
+
+[Patch Packs]
+
 [Stickers]
 
+[Souvenirs]
+
+[Others]
+
 [Cases]
 https://steamcommunity.com/market/listings/730/CS%3AGO%20Weapon%20Case ~ 0
 https://steamcommunity.com/market/listings/730/CS%3AGO%20Weapon%20Case%202 ~ 0

{cs2tracker-2.1.16 → cs2tracker-2.1.18}/cs2tracker/data/convert_inventory.js

@@ -11,6 +11,9 @@ const itemsGameLink =
 const translationsCacheFile = path.join(__dirname, "translations.json");
 const itemsCacheFile = path.join(__dirname, "items.json");
 
+const translationRegex = /"(.+?)"\s+"(.+?)"/;
+const souvenirRegex = /^csgo_crate_[a-z0-9]+_promo.*/;
+
 class ItemNameConverter {
   constructor() {
     this.translations = {};
@@ -38,7 +41,7 @@ class ItemNameConverter {
     const res = await axios.get(translationsLink);
     const lines = res.data.split(/\n/);
     for (const line of lines) {
-      const match = line.match(/"(.+?)"\s+"(.+?)"/);
+      const match = line.match(translationRegex);
       if (match) {
         this.translations[match[1].toLowerCase()] = match[2];
       }
@@ -174,7 +177,7 @@ class ItemNameConverter {
 
   getItemType(item) {
     const def = this.items[item.def_index];
-    if (def === undefined) return "unknown";
+    if (def === undefined) return "Unknown";
 
     if (def.item_name !== undefined) {
       let translatedName =
@@ -183,17 +186,48 @@ class ItemNameConverter {
         translatedName.startsWith("csgo_crate_sticker_pack") ||
         translatedName.startsWith("csgo_crate_signature_pack")
       ) {
-        return "sticker capsule";
-      } else if (translatedName.startsWith("csgo_crate_community")) {
-        return "case";
+        return "Sticker Capsules";
+      } else if (translatedName.startsWith("csgo_crate_patch_pack")) {
+        return "Patch Packs";
+      } else if (translatedName.match(souvenirRegex)) {
+        return "Souvenirs";
+      } else if (
+        translatedName.startsWith("csgo_crate_community") ||
+        translatedName.startsWith("csgo_crate_gamma") ||
+        translatedName.startsWith("csgo_crate_valve") ||
+        translatedName.startsWith("csgo_crate_esports") ||
+        translatedName.startsWith("csgo_crate_operation")
+      ) {
+        return "Cases";
       } else if (translatedName.startsWith("csgo_tool_spray")) {
-        return "graffiti kit";
+        return "Graffitis";
       } else if (translatedName.startsWith("csgo_tool_sticker")) {
-        return "sticker";
+        return "Stickers";
+      } else if (translatedName.startsWith("csgo_tool_patch")) {
+        return "Patches";
+      } else if (translatedName.startsWith("csgo_tool_keychain")) {
+        return "Charms";
+      } else if (translatedName.startsWith("csgo_customplayer")) {
+        return "Agents";
       }
     }
 
-    return "other";
+    if (item.quality === 3) {
+      return "Special Items";
+    }
+
+    if (def.prefab !== undefined) {
+      let prefab = this.prefabs[def.prefab];
+      if (
+        prefab !== undefined &&
+        prefab.image_inventory !== undefined &&
+        prefab.image_inventory.startsWith("econ/weapons/base_weapons")
+      ) {
+        return "Skins";
+      }
+    }
+
+    return "Others";
   }
 
   getItemTradable(item) {
@@ -204,11 +238,13 @@ class ItemNameConverter {
       let translatedName =
         def.item_name.replace("#", "").toLowerCase() || def.item_name;
       if (
-        translatedName.startsWith("csgo_collectible") ||
+        (translatedName.startsWith("csgo_collectible") &&
+          !translatedName.startsWith("csgo_collectible_pin")) ||
         translatedName.startsWith("csgo_tournamentpass") ||
         translatedName.startsWith("csgo_tournamentjournal") ||
         translatedName.startsWith("csgo_ticket") ||
-        translatedName.startsWith("csgo_tool_casket_tag")
+        translatedName.startsWith("csgo_tool_casket_tag") ||
+        translatedName.startsWith("sfui_wpnhud_c4")
       ) {
         return false;
       }
@@ -221,14 +257,6 @@ class ItemNameConverter {
       return false;
     }
 
-    // Base weapons with stickers/name tags
-    if (
-      def.image_inventory !== undefined &&
-      def.image_inventory.startsWith("econ/weapons/base_weapons")
-    ) {
-      return false;
-    }
-
     // Base weapons with stickers/name tags
     if (
       item.paint_index === undefined &&
@@ -239,7 +267,10 @@ class ItemNameConverter {
       if (
         prefab !== undefined &&
         prefab.image_inventory !== undefined &&
-        prefab.image_inventory.startsWith("econ/weapons/base_weapons")
+        prefab.image_inventory.startsWith("econ/weapons/base_weapons") &&
+        !prefab.image_inventory.startsWith(
+          "econ/weapons/base_weapons/weapon_knife",
+        )
       ) {
         return false;
       }

{cs2tracker-2.1.16 → cs2tracker-2.1.18}/cs2tracker/data/get_inventory.js

@@ -91,16 +91,12 @@ console.error = (...args) => {
 
     if (importInventory) {
       const inventoryItemCounts = await processInventory();
-      for (const [itemName, count] of Object.entries(inventoryItemCounts)) {
-        finalItemCounts[itemName] = (finalItemCounts[itemName] || 0) + count;
-      }
+      mergeItemCounts(finalItemCounts, inventoryItemCounts);
     }
 
     if (importStorageUnits) {
       const storageUnitItemCounts = await processStorageUnits();
-      for (const [itemName, count] of Object.entries(storageUnitItemCounts)) {
-        finalItemCounts[itemName] = (finalItemCounts[itemName] || 0) + count;
-      }
+      mergeItemCounts(finalItemCounts, storageUnitItemCounts);
     }
 
     paddedLog("Saving config...");
@@ -127,7 +123,7 @@ console.error = (...args) => {
       const convertedItems =
         nameConverter.convertInventory(prefilteredInventory);
       const filteredItems = filterItems(convertedItems);
-      const itemCounts = countItems(filteredItems);
+      const itemCounts = groupAndCountItems(filteredItems);
       paddedLog(`${filteredItems.length} items found in inventory`);
       console.log(itemCounts);
       return itemCounts;
@@ -145,10 +141,8 @@ console.error = (...args) => {
         const items = await getCasketContentsAsync(cs2, unitId);
         const convertedItems = nameConverter.convertInventory(items);
         const filteredItems = filterItems(convertedItems);
-        const itemCounts = countItems(filteredItems);
-        for (const [itemName, count] of Object.entries(itemCounts)) {
-          finalItemCounts[itemName] = (finalItemCounts[itemName] || 0) + count;
-        }
+        const itemCounts = groupAndCountItems(filteredItems);
+        mergeItemCounts(finalItemCounts, itemCounts);
         paddedLog(
           `${filteredItems.length} items found in storage unit: ${unitIndex + 1}/${storageUnitIds.length}`,
         );
@@ -181,16 +175,27 @@ console.error = (...args) => {
   }
 
   function filterItems(items) {
+    const otherItemTypes = [
+      "Skins",
+      "Special Items",
+      "Agents",
+      "Charms",
+      "Patches",
+      "Patch Packs",
+      "Souvenirs",
+      "Others",
+    ];
     let filteredItems = [];
+
     items.forEach((item) => {
       if (!item.item_tradable) {
         return;
       }
       if (
-        (item.item_type === "case" && importCases) ||
-        (item.item_type === "sticker capsule" && importStickerCapsules) ||
-        (item.item_type === "sticker" && importStickers) ||
-        (item.item_type === "other" && importOthers)
+        (item.item_type === "Cases" && importCases) ||
+        (item.item_type === "Sticker Capsules" && importStickerCapsules) ||
+        (item.item_type === "Stickers" && importStickers) ||
+        (otherItemTypes.includes(item.item_type) && importOthers)
       ) {
         filteredItems.push(item);
       }
@@ -198,15 +203,39 @@ console.error = (...args) => {
     return filteredItems;
   }
 
-  function countItems(items) {
-    let itemCounts = {};
-    items.forEach((item) => {
-      if (itemCounts[item.item_name]) {
-        itemCounts[item.item_name]++;
-      } else {
-        itemCounts[item.item_name] = 1;
+  function groupAndCountItems(items) {
+    let groupedItems = items.reduce((acc, item) => {
+      const { item_name, item_type } = item;
+
+      if (!acc[item_type]) {
+        acc[item_type] = {};
       }
-    });
-    return itemCounts;
+
+      if (!acc[item_type][item_name]) {
+        acc[item_type][item_name] = 0;
+      }
+
+      acc[item_type][item_name]++;
+      return acc;
+    }, {});
+
+    return groupedItems;
+  }
+
+  function mergeItemCounts(finalItemCounts, currentItemCounts) {
+    for (const item_type in currentItemCounts) {
+      if (!finalItemCounts[item_type]) {
+        finalItemCounts[item_type] = {};
+      }
+
+      for (const item_name in currentItemCounts[item_type]) {
+        if (!finalItemCounts[item_type][item_name]) {
+          finalItemCounts[item_type][item_name] = 0;
+        }
+
+        finalItemCounts[item_type][item_name] +=
+          currentItemCounts[item_type][item_name];
+      }
+    }
   }
 })();

{cs2tracker-2.1.16 → cs2tracker-2.1.18}/cs2tracker.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cs2tracker
-Version: 2.1.16
+Version: 2.1.18
 Summary: Tracking the steam market prices of CS2 items
 Home-page: https://github.com/ashiven/cs2tracker
 Author: Jannik Novak
@@ -54,6 +54,7 @@ Dynamic: license-file
 - [Usage](#usage)
 - [Configuration](#configuration)
 - [Advanced Features](#advanced-features)
+- [FAQ](#faq)
 - [Contributing](#contributing)
 - [License](#license)
 
@@ -74,8 +75,9 @@ Dynamic: license-file
 #### Method 1: Executable
 
 Simply download the program and run it:
-  - [Windows](https://github.com/ashiven/cs2tracker/releases/latest/download/cs2tracker-windows.zip)
-  - [Linux](https://github.com/ashiven/cs2tracker/releases/latest/download/cs2tracker-linux.zip)
+
+- [Windows](https://github.com/ashiven/cs2tracker/releases/latest/download/cs2tracker-windows.zip)
+- [Linux](https://github.com/ashiven/cs2tracker/releases/latest/download/cs2tracker-linux.zip)
 
 #### Method 2: Install via Pip
 
@@ -90,6 +92,7 @@ Simply download the program and run it:
    ```bash
    cs2tracker
    ```
+
 ### Additional Setup
 
 - Register for the [Crawlbase Smart Proxy API](https://crawlbase.com/) and retrieve your API key. (Optional)
@@ -117,18 +120,36 @@ This will open the config editor where you can change any setting by double clic
 
 - Enable **Daily Background Calculations** to automatically run a daily calculation of your investment in the background.
 - Use **Receive Discord Notifications** to receive a notification on your Discord server whenever the program has finished calculating your investment.
-- You need to set up a [webhook](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks) in your Discord server and enter the webhook url into the `discord_webhook_url` field in the config `User Settings`.
+- You need to set up a [webhook](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks) in your Discord server and enter the webhook URL into the `discord_webhook_url` field in the config `User Settings`.
 - Enable **Proxy Requests** to prevent your requests from being rate limited by the steamcommunity server.
 - You need to register for a free API key on [Crawlbase](crawlbase.com) and enter it into the `proxy_api_key` field in the config `User Settings`.
 
+## FAQ
+
+- **Q: Is it safe to login with my Steam account?**
+- **A:** Yes, the program uses the [SteamUser](https://github.com/DoctorMcKay/node-steam-user?tab=readme-ov-file#methods-) and [Globaloffensive](https://github.com/DoctorMcKay/node-globaloffensive) libraries to sign in and import your Storage Units (the same method is used by [casemove](https://github.com/nombersDev/casemove)) and all of the login-related code is transparently available in [this file](cs2tracker/data/get_inventory.js).
+
+
+- **Q: Do I have to login with my Steam account?**
+- **A:** No, you can also manually specify the number of items you own in the config editor.
+
+
+- **Q: Can I get VAC-banned for using this program?**
+- **A:** No, this program does not interact with the game in any way and only reads your Storage Units.
+
+
+- **Q: Why does Windows Defender flag this program as potentially harmful?**
+- **A:** This is because the program is not signed with a [Code Signing Certificate](https://www.globalsign.com/en/code-signing-certificate/what-is-code-signing-certificate), which Windows uses to verify the identity of publishers. These certificates are very expensive and not something I am willing to invest in for a free and open source project like this.
+
 ## Contributing
 
-Please feel free to submit a pull request or open an issue. See [issues](https://github.com/ashiven/cs2tracker/issues) and [pull requests](https://github.com/ashiven/cs2tracker/pulls) for current work.
+Please feel free to submit a [pull request](https://github.com/ashiven/cs2tracker/pulls) or open an [issue](https://github.com/ashiven/cs2tracker/issues).
 
 1. Fork the repository
-2. Create a new branch
+2. Create a new branch: `git checkout -b feature-name`.
 3. Make your changes
-4. Submit a PR
+4. Push your branch: `git push origin feature-name`.
+5. Submit a PR
 
 ## License