Skip to content
Uses the log.txt file to track item pickups in Binding of Isaac: Rebirth.
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
overlay text reference Made it print */3 for transformations Jan 15, 2017
overlay text Make sure "overlay text" always exists as a directory Aug 26, 2015
scripts new booster pack item images Apr 28, 2018
src add handling for R+ floor reseeding Sep 9, 2018
src_bootstrapper should only be one copy of mind.ico Mar 12, 2017
src_updater point from trackertest back to the real repo Mar 12, 2017
test_logs/run_summary Add __repr__ implementations for debugging Sep 1, 2015
.gitattributes 👾 Added .gitattributes Dec 4, 2014
.gitignore gitignore tracker log and export_state Jan 21, 2016
HOW TO BUILD.txt ask for pygame 1.9.x instead of 1.9.1 Dec 28, 2017
LICENSE.txt add bsd license Jun 14, 2015 readme fixes Apr 28, 2018 Updated view using item_tracker code Sep 14, 2015
items.json daddy's love is really named daddy longlegs Mar 5, 2019
items_custom.json adding new item - Charging Station Oct 19, 2018
mind.ico should only be one copy of mind.ico Mar 12, 2017
options_default.json new option to control how often to check the log Oct 16, 2017 should only be one copy of mind.ico Mar 12, 2017 change the working dir to be inside src/ or dist/ Nov 2, 2015
version.txt 2.0.13 Nov 6, 2018


This uses the log.txt file to track item pickups in The Binding of Isaac: Rebirth, Afterbirth, Afterbirth+, and Antibirth.

The game's built-in item tracker only shows 10 items and the pause screen items are hard to read, so this program offers a more powerful alternative. This is particularly useful for streamers, so their viewers can see their items, but can be used by anyone.

Additionally, the tracker...

  • tells you what an item does when you pick it up.
  • marks items that were picked up during a Curse of the Blind.
  • marks items that were rerolled using D4/_D100/etc.
  • shows what floor items were picked up on.
  • shows the floor the player is currently on.
  • displays the current seed.
  • allows tournament hosts to receive players' item data through a server, so they can fit nicely in a restream layout.

Download it here (get the latest file that doesn't have "source code" in the name).

To use it, first extract that zip file and then run the exe inside. Don't put it inside the same folder as any file \named log.txt.

You can right click anywhere in the window to get an options screen.

You can mouse over items you've picked up to see their stats again, and click on them to open in your browser for more information about that item.

It tries to read log.txt from inside the appropriate game folder, based on which game you select in the tracker options. If something is unexpectedly weird about your game folder and it can't find it, you can put the tracker folder into the folder with your log.txt and it will force it to use the specific one it finds there. (If you do this, you can't change between different isaac games by using the tracker option, and you'd have to have multiple tracker installs to use for Antibirth vs Afterbirth+, for example. Normally this should not have to happen.)

The tracker checks for updates each time you launch it, and will update itself if you allow it. This only works on Windows. You can toggle this in the options window.

The tracker can be used on Linux, but you have to run it from source, and it can't autoupdate. Read "HOW TO BUILD.txt" for instructions.

The tracker doesn't work properly on a Mac.

Status Message Customization

The tracker displays a line of text at the top of its window. This text can be adjusted in the options to contain various different pieces of information.

By default, it shows: "Seed: {seed} / Guppy: {guppy} / Leviathan: {leviathan} / Spun: {spun} / {version_number} / Room: {room_id}"

Where there's a word inside curly braces, it substitutes the value of that variable. Variables that you can use here include:

  • General game info: {seed}, {version_number}, {room_id}

  • Transformations: {guppy}, {bob}, {conjoined}, {funguy}, {leviathan}, {ohcrap}, {seraphim}, {spun}, {yesmother}, {superbum}, {beelzebub}, {bookworm}, {spiderbaby}

  • Stats: {dmg}, {delay}, {speed}, {shot_speed}, {range}, {height}, {tears}

The stats are kind of obsolete now that Found HUD is built into the game. They also don't track changes from things like pills or Experimental Treatment, because those don't say what they do in the game's log file.

Tournament/Restreaming Use

First, each competitor needs to go to the options screen, click "Let Others Watch Me", click "Get an authkey", authorize the application on twitch in the browser window that pops up, and then paste the authkey they receive into the tracker. After getting an authkey once, this step doesn't need to happen again. Don't show the authkey on stream.

If you're in "Let Others Watch Me" mode, indicated by the text "uploading to server" in the title bar, then the host can see your items with the "Watch Someone Else" button.

After closing the tracker, the tournament settings will turn themselves off automatically.

The host needs to run a separate copy of the tracker for each competitor. To compensate for twitch delay, there's a "read delay" setting which makes the tracker wait that many seconds before displaying updates from the player. Ctrl-up and ctrl-down are shortcuts to change the delay, which is also shown in the title bar.

Known issues

  • When using the Glowing Hour Glass right after taking any object, this object will remains in the tracker even if the character doesn't have it anymore.

  • If you want to make a shortcut to the tracker, and you want automatic updates to work, make the shortcut to the file "Rebirth Item Tracker.exe" and not "item_tracker.exe".

  • When playing Antibirth, it doesn't display detailed item information, nor can it keep track of what floor you're on.

  • If you ever save & quit and close the game, the tracker will forget anything that happened during that run when you relaunch the game.

You can’t perform that action at this time.