v6.2.1 Mostly Code Cleanup

The biggest thing you'll notice is that if you save font preferences for the tracker UI it will now take effect on launch. Before due to a small bug, you'd need to go into the settings and then save for the font changes to take effect.

Release Notes

User-Facing Changes

• A fix so that the font changes for the tracker window that are saved in preferences are applied upon startup..

Developer-Facing or API Changes

• cleaned up some duplicate code in call_tracker.py
• cleaned up logging code

Installation/Usage Instructions

tl;dr:

Windows Users

Grab the file below.

Linux users

use PyPi or git clone

Docker or Podman users

docker run -it -v ./extralifedonationtracker:/root/.config/extralifedonationtracker -v ./testoutput:/root/output djotaku/eldonationtracker:latest
or
podman run -it -v ./extralifedonationtracker:/root/.config/extralifedonationtracker:Z -v ./testoutput:/root/output:Z djotaku/eldonationtracker:latest

For more detailed instructions

Installation Instructions: https://eldonationtracker.readthedocs.io/en/latest/installation.html

Usage Instructions: https://eldonationtracker.readthedocs.io/en/latest/usage.html

Please file any bug reports. Pull requests welcome on the devel branch.

v6.2 Some API Updates

Release Notes

User-Facing Changes

• Nothing changes that a user should notice. These changes should make it so that when DonorDrive updates their API, it won't break the program because the API version has been pegged.

Developer-Facing or API Changes

• Move from urllib to requests
• Pegged DonorDrive API version

Installation/Usage Instructions

tl;dr:

Windows Users

Grab the file below.

Linux users

use PyPi or git clone

Docker or Podman users

docker run -it -v ./extralifedonationtracker:/root/.config/extralifedonationtracker -v ./testoutput:/root/output djotaku/eldonationtracker:latest
or
podman run -it -v ./extralifedonationtracker:/root/.config/extralifedonationtracker:Z -v ./testoutput:/root/output:Z djotaku/eldonationtracker:latest

For more detailed instructions

Installation Instructions: https://eldonationtracker.readthedocs.io/en/latest/installation.html

Usage Instructions: https://eldonationtracker.readthedocs.io/en/latest/usage.html

Please file any bug reports. Pull requests welcome on the devel branch.

v6.1.2 Preventing Overwrite of Files when API can't be reached

This release should help prevent your text files from being overwritten if the API can't be reached. Previously it would assume this was your first run and put "no donations yet".

Release Notes

User-Facing Changes

• Should not overwrite your text files if the API can't be reached
• changed many of the print statements to log output using Rich's logging

Developer-Facing or API Changes

-None

Installation/Usage Instructions

tl;dr:

Windows Users

Grab the file below.

Linux users

use PyPi or git clone

Docker or Podman users

docker run -it -v ./extralifedonationtracker:/root/.config/extralifedonationtracker -v ./testoutput:/root/output djotaku/eldonationtracker:latest
or
podman run -it -v ./extralifedonationtracker:/root/.config/extralifedonationtracker:Z -v ./testoutput:/root/output:Z djotaku/eldonationtracker:latest

For more detailed instructions

Installation Instructions: https://eldonationtracker.readthedocs.io/en/latest/installation.html

Usage Instructions: https://eldonationtracker.readthedocs.io/en/latest/usage.html

Please file any bug reports. Pull requests welcome on the devel branch.

v6.1.1 Fixing Bug with Anonymous Only Donations

I thought I dealt with something like this last year, but perhaps the API has changed again. At any rate, if you only have Anonymous donations, the Donor API is not populated and that was causing a crash for some users. Thank you to the user on the Extra Life Discord who reported the bug.

Release Notes

User-Facing Changes

• None

Developer-Facing or API Changes

• Because Donor API is empty if user only has Anonymous donors, changed handling of Donors slightly

Installation/Usage Instructions

tl;dr:

Windows Users

Grab the file below.

Linux users

use PyPi or git clone

Docker or Podman users

docker run -it -v ./extralifedonationtracker:/root/.config/extralifedonationtracker -v ./testoutput:/root/output djotaku/eldonationtracker:latest
or
podman run -it -v ./extralifedonationtracker:/root/.config/extralifedonationtracker:Z -v ./testoutput:/root/output:Z djotaku/eldonationtracker:latest

For more detailed instructions

Installation Instructions: https://eldonationtracker.readthedocs.io/en/latest/installation.html

Usage Instructions: https://eldonationtracker.readthedocs.io/en/latest/usage.html

Please file any bug reports. Pull requests welcome on the devel branch.

v6.1 Added Badges, Incentives, and Milestones!

While looking at the Donor Drive API for the previous release, I noticed they now had endpoints for Milestones, Badges, and Incentives. So I went ahead and added output files to match. Badges have both text and image outputs and you can feel free to mix and match those on your overlay. Incentives may have an image if you upload one. Otherwise they just have text output. The Milestones are text only. Check your output folder to get those files. In an effort to keep the output folder from becoming a mess, I have created folders within that folder for the badges and incentives.

Enjoy!

Installation/Usage Instructions

tl;dr:

Windows Users

Grab the file below.

Linux users

use PyPi or git clone

Docker or Podman users

docker run -it -v ./extralifedonationtracker:/root/.config/extralifedonationtracker -v ./testoutput:/root/output djotaku/eldonationtracker:6.1
or
podman run -it -v ./extralifedonationtracker:/root/.config/extralifedonationtracker:Z -v ./testoutput:/root/output:Z djotaku/eldonationtracker:6.1

For more detailed instructions

Installation Instructions: https://eldonationtracker.readthedocs.io/en/latest/installation.html

Usage Instructions: https://eldonationtracker.readthedocs.io/en/latest/usage.html

Please file any bug reports. Pull requests welcome on the devel branch.

Release Notes

User-Facing Changes

• Badge Output files: See the subfolder badges within your output folder. There is an images folder with HTML so you can display the images.
• Milestone Output files: In your output folder look for text files that start with milestone
• Incentive Output files: In your output folder there will be a subfolder called invencitves. Within there is a folder per incentive you have. There you will find text files and, if you have images, HTML files.

Developer-Facing or API Changes

• Badge API endpoint for both teams and participants now available
• Milestone API now available for participants
• Incentive API now available for participants

v6.0.2 API Change BugFix-Real

The API changed and Donor Direct now provides the "http:" part of the Participant and Team Avatars.

The Podman/Docker images are not up yet, but should be soon.

Installation/Usage Instructions

tl;dr:

Windows Users

Grab the file below.

Linux users

use PyPi or git clone

Docker or Podman users

docker run -it -v ./extralifedonationtracker:/root/.config/extralifedonationtracker -v ./testoutput:/root/output djotaku/eldonationtracker:6.0.2
or
podman run -it -v ./extralifedonationtracker:/root/.config/extralifedonationtracker:Z -v ./testoutput:/root/output:Z djotaku/eldonationtracker:6.0.2

For more detailed instructions

Installation Instructions: https://eldonationtracker.readthedocs.io/en/latest/installation.html

Usage Instructions: https://eldonationtracker.readthedocs.io/en/latest/usage.html

Please file any bug reports. Pull requests welcome on the devel branch.

Release Notes

User-Facing Changes

None

Developer-Facing or API Changes

• The string "http:" is no longer prepended to Particpant and Team Avatar URLs.

v6.0.2 API Change BugFix

The API changed and Donor Direct now provides the "http:" part of the Participant and Team Avatars.

The Podman/Docker images are not up yet, but should be soon.

Installation/Usage Instructions

tl;dr:

Windows Users

Grab the file below.

Linux users

use PyPi or git clone

Docker or Podman users

docker run -it -v ./extralifedonationtracker:/root/.config/extralifedonationtracker -v ./testoutput:/root/output djotaku/eldonationtracker:6.0.2
or
podman run -it -v ./extralifedonationtracker:/root/.config/extralifedonationtracker:Z -v ./testoutput:/root/output:Z djotaku/eldonationtracker:6.0.2

For more detailed instructions

Installation Instructions: https://eldonationtracker.readthedocs.io/en/latest/installation.html

Usage Instructions: https://eldonationtracker.readthedocs.io/en/latest/usage.html

Please file any bug reports. Pull requests welcome on the devel branch.

Release Notes

User-Facing Changes

None

Developer-Facing or API Changes

• The string "http:" is no longer prepended to Particpant and Team Avatar URLs.

v6.0.1 A Minor Library Update

One of the libraries we depend upon was updated for a security update. Nothing major has changed in the way ELDonationTracker works. If you're new to the v6.x series, see https://github.com/djotaku/ELDonationTracker/releases/tag/v6.0

v6.0 Goal Reached

A couple quick things before I get to the meat of my announcement below:

• http://djotaku.github.io/ELDonationTracker/ will soon be updated with the latest links and videos
• There's going to be a lag, hopefully no more than an hour, before the dropbox release that goes along with this version
• There are YouTube tutorials coming. http://djotaku.github.io/ELDonationTracker/ will be updated as I finish rendering and uploading them.

Onto my release announcement:

This release is the culmination of a program I set out to create about five years ago when the Adobe Air program that another Extra Life user had created no longer worked due to Adobe getting rid of it. At the time there was no Streamlabs option. You were on your own to figure out how to get Extra Life data into your livestreams. I started off with a commandline utility because I didn't know how to make GUIs. Then, slowly but surely I started working on (and releasing) what became the GUI you see before you today.

Thank you to all the other Extra Lifers who have helped by filing bug reports whenever things have gone awry. Your support means a lot to me. I created this software to fulfill a need I had, but it's always incredible to have users of software I put out into the world

A lot of the big changes for 6.0 are behind-the-scenes. I wanted to make this software work well as a base for anyone else who would liek to build a Python solution on top of the Donor Drive API. I also wanted to make sure the software would be easier to maintain going forward. But there are a few goodies for the user, including fetching of the Team Avatar, and some new Top Donor and Top Donation output files.

At this point, I'm putting the project mostly into maintenance mode. That is to say, I think I have all the features I need, but if you guys need other outputs, let me know and I can work on making them happen. I'm also going to work on creating better unit tests to prevent bugs from coming out of nowhere.

At some point in the future, I may once again tackle the idea of a Web-based GUI for users who would prefer that to the Qt GUI I'm using now.

Thanks for coming along this journey with me and remember: It's For the Kids!

Installation/Usage Instructions

tl;dr:

Windows Users

Grab the file below.

Linux users

use PyPi or git clone

Docker or Podman users

docker run -it -v ./extralifedonationtracker:/root/.config/extralifedonationtracker -v ./testoutput:/root/output djotaku/eldonationtracker:6.0
or
podman run -it -v ./extralifedonationtracker:/root/.config/extralifedonationtracker:Z -v ./testoutput:/root/output:Z djotaku/eldonationtracker:6.0

For more detailed instructions

Installation Instructions: https://eldonationtracker.readthedocs.io/en/latest/installation.html

Usage Instructions: https://eldonationtracker.readthedocs.io/en/latest/usage.html

Please file any bug reports. Pull requests welcome on the devel branch.

Release Notes

User-Facing Changes

• To launch the command-line version of the program you now run: python -m eldonationtracker.cli

• New output files: LastDonorNameAmnt.txt, lastNDonorNameAmtsHorizontal.txt,lastNDonorNameAmts.txt, TopDonationNameAmnt.txt

Developer-Facing or API Changes

• Created Properties for accessing the variables for the API classes.
  These also replace any "getter" methods that had been in place.
  If there are no "setter" methods, it's because that attribute should
  only be set by internal methods and/or from the Donor Drive API. If you
  believe an attribute without a "setter" should have one -
  file an issue.

• re-organized files into sub-modules to better encapsulate which part of the program they are for. All the Donor Drive API compoments are now found in eldonationtracker.api.

• Now getting all the attributes for the Participant, Team, Donor, and Donation. We aren't currently pushing all of these out to text files for the user, but can be used if you want to use this package as a Python API for your own programs.

v5.3.0 Participant and Team Avatars and container images

This is the final planned release for the 5.x series. We've got 2 new features for users.

First of all, I've added the Participant and Team Avatars as outputs. The program will output them as HTML files that you can set as a web source in either OBS or XSplit. So if you ever wanted to have those team logos or participant avatars, you've got them now!

Second, I've created an OCI image (colloquially known as Docker Images or Podman Images) that you can use if you want to run the program in Docker or Podman. This would not provide you with the GUI portion of the program, but it does allow you to use the command line without having to install anything on your system. I could also see creative users perhaps making use of this on a server or Heroku instance. See instructions at https://eldonationtracker.readthedocs.io/en/latest/usage.html#docker-or-podman-users to learn how to use this new feature.

Installation/Usage Instructions

tl;dr:

Windows Users
Grab one of the 2 files below. You can choose :

• the single-binary (eldonationtracker.for.Windows.v5.3.0.exe): One file that you use to launch the program.
• the zip file (Extra Life Donation Tracker for Windows v5.3.0.zip - which has been the main release method for at least a year now): A folder in which you'll find the executable.

The trade-off is that the single-binary is simpler, but takes a little longer to launch.

Linux users
use PyPi or git clone.

Docker or Podman users*
docker run -it -v ./extralifedonationtracker:/root/.config/extralifedonationtracker -v ./testoutput:/root/output djotaku/eldonationtracker:5.3
or
podman run -it -v ./extralifedonationtracker:/root/.config/extralifedonationtracker:Z -v ./testoutput:/root/output:Z djotaku/eldonationtracker:5.3

For more detailed instructions

Installation Instructions: https://eldonationtracker.readthedocs.io/en/latest/installation.html

Usage Instructions: https://eldonationtracker.readthedocs.io/en/latest/usage.html

Please file any bug reports. Pull requests welcome on the devel branch.

#v5.3.0

Release Notes

User-Facing Changes

• There are two new output files: Participant_Avatar.html and Team_Avatar.html. Feel free to use them in OBS, XSplit, or anywhere else to make your overlay more personalized.
• added Participant Avatar to the GUI
• Added Docker (or you can use Podman) Container

Developer-Facing or API Changes

• Updated the version of PyQt and associated libraries.