DriveThruRPG GUI Downloader

A graphical frontend for the https://github.com/glujan/drpg tool, to download and keep your DriveThruRPG purchases up to date.

Thanks to glujan!

---

Prerequisites

Package	Install (Debian/Ubuntu)
Python 3.9+	sudo apt install python3
tkinter	sudo apt install python3-tk
drpg	Installed automatically

---

Installation

# 1. Make the script executable and install it
chmod +x install.sh
./install.sh
# 2. Start the app
drpg-gui
# – or directly:
python3 drpg_gui.py

---

Getting Started

1. Get an API token:
   DriveThruRPG → Account Settings → Create Application Key

2. Enter the token and select a download folder

3. Click “Save Configuration” (saved to ~/.config/drpg_gui/config.json)

4. Click “Start Synchronization” → all purchases will be downloaded
   Subsequent runs will only download new/modified files

---

Options

Option	Description
Compatibility Mode	Same folder names as the official DriveThruRPG app
Force MD5 Check	Compare files using checksums instead of timestamps (slower)

~/.config/drpg_gui/config.json   – saved settings
~/.local/share/drpg-gui/         – program directory
~/.local/bin/drpg-gui            – launcher script

---

Troubleshooting

drpg: command not found
→ pip install --user drpg and ensure that ~/.local/bin is in $PATH.

Empty log window / hangs
→ API may be rate-limiting; just wait.

tkinter missing
→ sudo apt install python3-tk