Talmyric Avatar Recovery

Beta Talmyric Avatar Recovery Beta 1.2.2

No permission to download
Frequently asked questions

Will this recover every static avatar?


Recovery requires a surviving animated GIF in XenForo’s expected original avatar location. A static original has no animation frames to recover.

What does “Original is missing” mean?

The add-on could not find the member’s file at XenForo’s expected o avatar path. This can occur with older imported avatars. An animated file may survive elsewhere, but this beta scans the expected original location.

Why do some files end in .jpg when they contain GIF animation?

XenForo uses standardized avatar filenames. The add-on examines the file contents to identify GIFs and animation.

Does a dry run change anyone’s avatar?

The scan saves its progress and findings in the add-on’s tables. Avatar rebuilding begins after approval.

Which sizes does it repair?

It checks XenForo’s h, l, m, and s derivatives. During rebuilding, it rechecks each candidate and regenerates the sizes that are missing or static.

Does it change the original or the member’s crop?

The original is preserved. Rebuilt derivatives use the saved crop. Successful repairs update the avatar timestamp so XenForo generates refreshed avatar URLs.

Do members need to do anything?

Administrators perform the recovery. Members can continue using their existing avatars.

Do I need to install Gifsicle separately?

Compatible hosts can use the copy included in the add-on. Detection is automatic. PHP must be allowed to run executables, and the included build must match the server’s platform and runtime.

Can it work if my host blocks PHP from running programs?

PHP Imagick with GIF support provides the other processing option. If both options are unavailable, your host will need to enable a supported processor.

Do I need [UH] GD Gif Animations?

Avatar Recovery operates independently and includes its own Gifsicle integration.

Why must I close the board before rebuilding?

Closing the board reduces the chance of members changing avatars while files are being rebuilt. Pause administrative avatar edits, imports, and other avatar rebuilds during the repair.

Can I stop and resume?

Progress is saved between batches. Reopen the run to continue. In the AdminCP, each click processes the next batch. The CLI processes consecutive batches automatically.

Why is the number of results smaller than the number of accounts checked?

The scan lists candidates, skips, and errors. Accounts needing no action contribute to the checked total.

Can I run it again?

Yes. A new scan rechecks the current files. Successfully repaired derivatives should no longer appear as candidates.

What if an avatar changes after scanning?

The rebuild rechecks the original, avatar timestamp, and crop. A detected change causes that candidate to be skipped for review in a fresh scan.

What happens if a repair fails?

The add-on records an error and attempts to restore files affected by a caught write failure. Check the run results and XenForo’s server error log. Keep backups available for interruptions or storage failures that prevent restoration.

Does it support remote avatar storage or a CDN?

It uses XenForo’s filesystem APIs. Remote storage adapters and production CDN configurations remain untested. A CDN that ignores avatar URL query strings may require a cache purge.

Can I undo a completed repair?

Restore the affected derivative files and avatar timestamps from your backup, then refresh relevant caches. Uninstalling removes the add-on’s run history.

What has been tested?

Testing on a disposable XenForo 2.3.13 installation covered installation and upgrades, AdminCP and CLI recovery, dry runs, GIF frame counts, dimensions, timing, looping, saved cropping, and preservation of original files.

The bundled Windows executable completed a rebuild with Imagick disabled. The bundled Linux executables have not been run in the test environment. Production scale, remote storage, forced interruption, and rollback failure remain untested.

What should I include in a beta bug report?

Include your XenForo and PHP versions, server operating system and architecture, the detected GIF processor, the run status, and relevant server error log details. Describe the expected result and what happened. Remove credentials and other private information before posting.
Back
Top Bottom