diablo_4_armory_fetcher

Use the unofficial Diablo 4 Armory https://d4armory.io/ to snapshot your characters data, combined with Github actions to fetch and store the data on a schedule

Using this you can track your characters until/if Blizzard create an official API.

Details

Based off of https://github.com/patrickloeber/python-github-action-template for using Github actions to run on a schedule
By default the script is run every twelve hours as specified in .github/workflows/actions.yml. I'd caution against running this too often as it would put a load on the kind folks at d4armory.io

Setup

Find Your Account ID

To find your account id:

Open Diablo IV install directory
Open FenrisDebug.txt
Search for 'account_id'

Register your characters on d4armory.io

Head to https://d4armory.io/
Search for your account using the account_id you fetched from FenrisDebug.txt
Confirm you can see your characters, there may be some latency

Setup your Clone of this Repo

Fork or Create a copy of this repo using the Use this template button

Setup Repo Secrets

In your repo on github head to settings -> secrets -> actions
Click New repository secret
Name your secret: ACCOUNT_ID
Enter the value of the account_id you fetched from FenrisDebug.txt

Setup Repo Write Permissions

In your repo on github head to settings -> actions
Under Workflow permissions select Read and write permissions
Click save

Constructing Data History

Clone the repo to your local computer
(Optional, but recommended) Create an python environment and activate it
Install the requirements - e.g. pip install requirements.txt
Run the following terminal command in the repo folder python reconstruct_historical_data.py
Your characters changes will be written by default as JSON line format to data_history directory

TODO:

Check the status endpoint before proceeding with fetching chars