https://github.com/ryancollingwood/diablo_4_armory_fetcher
Collect your Diablo 4 character changes from https://d4armory.io/ automatically using github actions
https://github.com/ryancollingwood/diablo_4_armory_fetcher
diablo4
Last synced: about 2 months ago
JSON representation
Collect your Diablo 4 character changes from https://d4armory.io/ automatically using github actions
- Host: GitHub
- URL: https://github.com/ryancollingwood/diablo_4_armory_fetcher
- Owner: ryancollingwood
- License: mit
- Created: 2023-06-10T04:14:55.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-06T22:30:19.000Z (8 months ago)
- Last Synced: 2024-11-07T16:44:13.491Z (7 months ago)
- Topics: diablo4
- Language: Python
- Homepage:
- Size: 53.7 KB
- Stars: 18
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-d4 - Diablo 4 Armory Fetcher - Fetch and store your character profiles using [D4 Armory](https://d4armory.io/) and Github Actions (Tools / Profile and Leaderboard Trackers)
README
# 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](https://github.com/ryancollingwood/diablo_4_armory_fetcher/generate) 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