detailed-cod-tracker/README.md

[![Python](https://img.shields.io/badge/Python-v3.9.13-3776AB?logo=python&logoColor=yellow&labelColor=blue&color=grey)](https://www.python.org/ftp/python/3.9.13/)
[![Discord](https://img.shields.io/discord/971134884703784960?color=%237289DA&label=members&logo=discord&logoColor=%23FFFFFF)](https://discord.rimmyscorner.com)
[![Release](https://img.shields.io/gitea/v/release/Rim/detailed-cod-tracker?color=green&gitea_url=https%3A%2F%2Fgit.rimmyscorner.com%2F&display_name=release)](https://git.rimmyscorner.com/Rim/detailed-cod-tracker/releases/tag/latest)
[![Website](https://img.shields.io/badge/Developer's-Website-red)](https://rimmyscorner.com/)

# Modern Warfare 2019 Advanced Statistics Tracker

Access comprehensive Call of Duty statistics directly from your command line. No more visiting third-party tracking websites when you can retrieve **every statistic** Call of Duty records in under a minute.

> View example outputs in the `/examples/` directory

## Features

- **Complete Statistics Access**: Download detailed player statistics including lifetime stats, match history, and seasonal rewards
- **Enhanced Sorting**: Sort statistics more effectively than the in-game Barracks
- **Human-Readable Formats**: Convert timestamps and code names to user-friendly formats
- **Detailed Match History**: Split match data into separate files for easier analysis
- **Game Information**: Access lists of all maps and game modes in current rotation

## Prerequisites

- Call of Duty account with API security settings set to "Open"
- Web browser (Tested with Chromium)
- Python 3.x (optional, tested with Python 3.9.13)

## Installation Options

### Option 1: Download the Latest Release (Recommended)

1. Download `cod_api_tool.exe` from the [latest release](https://git.rimmyscorner.com/Rim/detailed-cod-tracker/releases/tag/latest)
2. Run the executable for GUI mode **OR** open a shell in the download directory
3. Execute the tool using the syntax below:

```
cod_api_tool.exe [arguments]
```

### Option 2: Clone the Repository

1. Clone the repository:
```
git clone https://git.rimmyscorner.com/Rim/detailed-cod-tracker.git && cd detailed-cod-tracker
```

2. Run the setup script:
```
python setup.py
```

3. Activate the virtual environment
```
venv/Scripts/activate
```

4. Run the tool
```
python cod_api_tool.py [arguments]
```

## Authentication Setup

### Obtaining your ACT_SSO_COOKIE

1. Log in to [Call of Duty](https://www.callofduty.com)
2. Open developer tools (F12)
3. Navigate to: Application → Storage → Cookies → https://www.callofduty.com/
4. Copy the value of `ACT_SSO_COOKIE`
5. Provide this value when prompted by the tool

### Setting up userInfo.json (Required for Advanced Features)

Due to recent API changes, additional steps are required for certain features:

1. Navigate to `https://profile.callofduty.com/cod/userInfo/{ACT_SSO_COOKIE}` (replace with your actual cookie)
2. Copy the entire content
3. Create a file named `userInfo.json` in the tool's directory
4. Paste the content and remove `userInfo(` from the beginning and `);` from the end
   - Alternatively, use the regex pattern in `sanitize_userInfo_regex.txt`
5. Run the tool with the `-a` flag to access advanced features

## Command Line Reference

```
usage: cod_api_tool.py [-h] [-tz {GMT,EST,CST,PST}] [-p PLAYER_NAME] [-a]
                       [-sl] [-id] [-m] [-i] [-f] [-e] [-cp] [-ca] [-s] [-c]
                       [-sm] [-csd] [-cmd] [-cff] [-cef]
```

### Default Options
| Argument | Description |
|----------|-------------|
| `-h`, `--help` | Show help message and exit |
| `-tz`, `--timezone` | Specify timezone (GMT, EST, CST, PST) |

### Data Fetching Options
| Argument | Description |
|----------|-------------|
| `-p PLAYER_NAME`, `--player_name PLAYER_NAME` | Target player's username (with #1234567) |
| `-a`, `--all_stats` | Fetch all available statistics |
| `-sl`, `--season_loot` | Fetch only seasonal reward data |
| `-id`, `--identities` | Fetch only logged-in identities data |
| `-m`, `--maps` | Fetch only map list data |
| `-i`, `--info` | Fetch only general information |
| `-f`, `--friendFeed` | Fetch only friend feed |
| `-e`, `--eventFeed` | Fetch only event feed |
| `-cp`, `--cod_points` | Fetch only COD Point balance |
| `-ca`, `--connected_accounts` | Fetch only connected accounts data |
| `-s`, `--settings` | Fetch only account settings |

### Data Processing Options
| Argument | Description |
|----------|-------------|
| `-c`, `--clean` | Beautify all data |
| `-sm`, `--split_matches` | Split matches into separate JSON files |
| `-csd`, `--clean_stats_data` | Beautify stats.json data |
| `-cmd`, `--clean_match_data` | Beautify match_info.json data |
| `-cff`, `--clean_friend_feed` | Clean friend feed data |
| `-cef`, `--clean_event_feed` | Clean event feed data |

## Examples

**Basic Usage: Retrieve Player Statistics**
```
python cod_api_tool.py -p YourUsername#1234567
```

**Full Data Collection with Cleaning**
```
python cod_api_tool.py -p YourUsername#1234567 -a -c -sm
```

**Process Existing Data**
```
python cod_api_tool.py -c -sm
```

> All data is saved to the `/stats/` directory

## Advanced Sorting

The tool offers enhanced sorting capabilities:

- Game modes sorted by **Time Played** (descending)
- Weapons sorted by **Kills** (descending)
- Field upgrades sorted by **Uses** (descending)
- Equipment (lethal and tactical) sorted by **Uses** (descending)
- Scorestreaks sorted by **Times Awarded** (descending)
- Accolades sorted in descending order

# Credits
- [Todo Lodo](https://github.com/TodoLodo) - Call of Duty API Python Wrapper / Codebase Developer
- [Engineer15](https://github.com/Engineer152) - Call of Duty API Python Wrapper / Codebase Developer
- [Werseter](https://github.com/Werseter) - Call of Duty API Python Wrapper / Codebase Contributor