Download media from the fortellergames.com store without installing the application
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Nemo dea906acdb
Update README.md
2 weeks ago
.gitignore Make much more robust. 7 months ago
LICENSE Initial Commit 8 months ago
README.md Update README.md 2 weeks ago
config.sample.php Make much more robust. 7 months ago
run.php Make much more robust. 7 months ago

README.md

forteller-dl

Download media from the https://www.fortellergames.com/ store without installing the application. The script behaves the same way as the application, and it can only download media that you will have access to, so please purchase the media from fortellergames.com before you run this script.

Tested mainly against "Gloomhaven: Jaws of the Lion".

Why?

I didn't like the application UX, so wrote this script instead to download the files. The app stretches the play/pause button on my iPhone SE and it looked very ugly. Plus, I can uninstall the app now and play the files anywhere. Kudos for Forteller for having a clean API and no DRM.

How to use

You'll need php, php-curl installed, and replace {SKU} with a valid SKU. Valid SKUs are:

  • ceph_gh (Gloomhaven)
  • ceph_jaws (Gloomhaven: Jaws of the Lion)
  • suc_mid1
  • ceph_fh (Frosthaven)
  • skg_iso
  • theisofarianguard (The Isofarian Guard)
  • middara (Middara: Act 1)
  • chroniclesofdrunagor (Chronicles of Drunagor)
  • nearandfar (Near and Far)
  • forgottencircles (Gloomhaven: Forgotten Circles)

Not all of the above are available however.

git clone https://github.com/captn3m0/fortller-dl.git
cd forteller-dl
cp config.sample.php config.php
// Edit the config.php file to put your credentials
php run.php {SKU}

TODO

The script is functional enough for me, so this will likely never get done. But ideas:

  • Run with Docker
  • Cleanup code
  • API Documentation?
  • Tag the MP3 files as they are saved

License

Licensed under the MIT License. See LICENSE file for details.