Talmyric Avatar Recovery

Beta Talmyric Avatar Recovery Beta 1.2.2

No permission to download
Compatible XF 2.x versions
  1. 2.3
License
https://xf.talmyric.com/pages/lic-agree/
Updates duration
Free
Visible branding
No
This did recover a few on one of my live forums. After running it and reopening the forum, the avatars were working as they should.

Be sure to backup!

Sometimes an avatar animates when opened directly from a member’s profile, while the smaller versions beside posts appear static. If XenForo still has an animated GIF original, Avatar Recovery can rebuild the affected sizes without members uploading their avatars again.

Features
  • AdminCP recovery tool — Scan one member or all accounts with local custom avatars.
  • Dry-run preview — Review affected user IDs and the sizes needing repair before approving changes.
  • Selective rebuilding — Regenerate static or missing small, medium, large, and high-DPI avatars from the stored original.
  • Original preservation — Retain the original file and existing animated derivatives.
  • Stored cropping — Apply the member’s saved avatar crop.
  • Batch processing — Process manageable batches and resume saved runs.
  • Recovery results — View repaired accounts, skipped accounts, and errors.
  • GIF processor detection — Use PHP Imagick when available, with Gifsicle as a fallback.
  • Bundled Gifsicle — Include builds for Windows x64 and Linux x64/ARM64.
  • CLI support — Scan, inspect results, and rebuild from the command line.
  • Results navigation — Numbered pages, Previous/Next, First/Last, and a page jump box.
Requirements
  • XenForo 2.3+. Development and testing targeted XenForo 2.3.13.
  • PHP Imagick with GIF support, or a compatible Gifsicle executable that PHP can run.
  • PHP 7.4+ when using Gifsicle.
  • Write access to avatar storage.
The included Linux Gifsicle builds require glibc 2.38 or newer. Older Linux systems, Alpine/musl, and other platforms may require a compatible system copy or PHP Imagick.

Getting started
  1. Back up your database and avatar storage.
  2. Install the beta through AdminCP → Add-ons.
  3. Open Tools → Data maintenance → Avatar recovery.
  4. Enter a known affected member’s user ID for a pilot scan, or use 0 to scan all custom avatars.
  5. Process the scan batches and review the candidates.
  6. Close the board, approve the rebuild, and process the repair batches.
  7. Check the repaired avatars beside posts and on member profiles.
Use a staging copy for your first run.

## Command line

Run these from the XenForo root. Replace 123 with the test user's numeric ID and RUN_ID with the number printed by the scan. The CLI works through the same persisted runs as the AdminCP. It processes consecutive batches automatically.

Code:
php cmd.php talmyric:avatar-recovery scan --user=123
php cmd.php talmyric:avatar-recovery status --run=RUN_ID
php cmd.php talmyric:avatar-recovery rebuild --run=RUN_ID --confirm

Omit --user for a full scan, or use scan --run=RUN_ID to resume an interrupted scan. Reissue the rebuild command to resume a run in repair. It returns a nonzero exit code if the run contains scan or repair errors.
image1.webpimage2.webpimage3.webp
Author
fords8
Downloads
1
Views
23
First release
Last update

Ratings

0.00 star(s) 0 ratings

More resources from fords8

Back
Top Bottom