Review unused builds in ADT Hub (Windows and macOS)
Overview
Find the builds you have not used for a while and uninstall the ones you no longer need, from My Builds or from the weekly unused-build reminder.
This guide uses AccelByte Development Toolkit (ADT) Hub on Windows. The steps are the same on macOS.
Prerequisites
- ADT Hub 1.12.4 or later, on Windows or macOS.
- At least one build installed through ADT Hub.
- The weekly reminder needs Remind me on Monday about unused builds to be on (the default) and auto-uninstall to be off (the default). Unused-build reminder in Application Settings > Notifications is the same setting. If auto-uninstall is on, you get the removal reminder instead. See Turn on auto-uninstall for unused builds in ADT Hub (Windows and macOS).
- The weekly reminder starts 30 days after you first run this Hub version. Until then, My Builds already shows the last-used dates.
Steps
Step 1: See when each build was last used
- Open ADT Hub and go to your game.
- Go to My Builds. The Installed builds tab opens.
- Check these columns for each build:
- Last used: the date you last launched the build from Hub. If you never launched it, the column says Installed on with the install date.
- Unused: how many days the build has been unused, for example Unused for 42 days. If the count starts from another date, a short line says why, for example "Counting since 15 October, when a newer build replaced it as head build".
- Size: the size of the build. A second line shows the size of its
Savedfolder, or No Saved folder.
- To see the least used builds first, open Sort by and select Least recently used. To see the largest builds first, select Largest file size.
Builds with a Kept tag or a Head build, followed track tag are never listed in a reminder.
Step 2: Open the weekly reminder
At the start of each week, Hub lists the builds that passed your unused-days limit, or will pass it by Thursday. The default limit is 30 days.
- Click the system notification Builds you have not used for a while, or open the notification panel and select the Activity tab.
- Find the card Builds you have not used for a while. It names how many builds are past your limit and says Nothing will be removed automatically.
- Check each listed build. Each row shows the build name, how long it has been unused, and its size.
The card lists builds of the game you have open. If other games in the same namespace have unused builds, the card shows them under Other games:. Click a game to open its unused builds.
Step 3: Keep any build you still need
For a build you still need, click Keep build on its row. Hub stops listing it and never removes it automatically. See Keep a build in ADT Hub (Windows and macOS).
Step 4: Uninstall builds from the reminder
- Select the builds to uninstall, or click Select all.
- Click Uninstall selected (N). To uninstall every listed build, click Uninstall all instead.
- In the Uninstall Build dialog, check the list of builds and the total size.
- To keep the logs and traces of these builds, tick Keep logs and traces (Saved folder, size). The checkbox appears only when a selected build has a
Savedfolder. See Keep the Saved folder when you uninstall a build in ADT Hub (Windows and macOS). - Click Uninstall.
The dialog closes at once and the builds uninstall in the background. Hub shows "Uninstalling N build(s) in the background. You can keep using Hub." You can keep working in Hub.
Step 5: Uninstall builds from My Builds
You can also uninstall builds at any time from My Builds.
- In My Builds, tick the checkbox of each build to uninstall.
- In the bar above the list, click Uninstall.
- In the Uninstall Build dialog, choose whether to keep the
Savedfolder, then click Uninstall.
Leave the rest alone. Any listed build you do not keep or uninstall is listed again next week if it is still unused.
Validation
- The uninstalled builds disappear from My Builds.
- Hub shows "Uninstalled N build(s). X freed." for an uninstall from the reminder, or "Uninstall finished!" for an uninstall from My Builds.
- On the reminder card, each uninstalled or kept build leaves the list. When nothing is left, the card says Nothing left to review this week.
- If you kept the
Savedfolder, a Saved folder kept card appears in the notification panel with the folder's location.
Troubleshooting
- Symptom: No weekly reminder appears. Fix: Check that no build is past your limit yet and that Remind me on Monday about unused builds is on in Application Settings > Downloads. Unused-build reminder in Application Settings > Notifications is the same setting. Within 30 days of the Hub update, no reminder is sent.
- Symptom: A build you use every day is listed as unused. Fix: Only launches from Hub count. Launch the build from Hub, or choose Keep build for it.
- Symptom: A build you expected is not listed. Fix: Check whether it is kept, is the head build of a track you follow, or is running, installing or updating. These builds are never listed.
- Symptom: "Build name could not be uninstalled. Try again from My Builds." Fix: Close the game and any program that uses files in the build folder, then uninstall the build again from My Builds.
- Symptom: The reminder arrived later than Monday. Fix: Hub creates the week's reminder the first time it runs that week. If Hub was closed on Monday, the reminder appears when you next open Hub.