Setting up a custom loading animation in TMWhatsApp

TMWhatsApp is popular among Australians chasing more control over their messaging, particularly those on Telstra and Optus handsets sold through JB Hi-Fi and Officeworks. The mod ships with tweaks well beyond the official client, which is why it shows up on second-hand phones from Perth to Brisbane.

One underrated customisation is swapping the splash screen for a custom loading animation that plays when the app first opens. Instead of seeing the standard green-and-white logo flash for a second, you can have a short looping clip or a quirky graphic greet you each launch. The swap is handled locally with no root required, making it safe to try on a stock Galaxy or Pixel.

Modders in Sydney and Melbourne already use the mod for privacy tools and theme options, and a personalised loader is a natural next step. Australian Telegram groups typically carry a "TMWhatsApp loader pack" ready to grab. Anything sourced from a third party should be scanned before installation.

Before starting, know which file types work, where to place them inside the package folder, and how to clear cached graphics so the new animation actually appears. The process takes a few minutes once the steps make sense, and you can grab verified builds from WhatsApp Mods as a clean starting point.

What you'll need before swapping the loader

Gather a few essentials first. You'll want a file manager that can reach the Android data folder, such as the stock Files app on a Samsung or X-plore on a Pixel. TMWhatsApp must be side-loaded from an APK, so enable "Install unknown apps" for the browser or manager you'll use.

A suitable animation file is the next requirement. TMWhatsApp accepts MP4 clips, WebM loops and APNG sequences under roughly 8MB, ideally at 480 by 854. Anything over 10MB tends to hang on the Galaxy A series, while clips under two seconds loop in a choppy way that draws attention for the wrong reasons.

Take a full backup of your chats before changing anything visual. TMWhatsApp stores data in a separate folder from the official client, so the standard backup won't cover it. Manually copy the relevant folder to internal storage for a clean restore point if anything goes sideways.

Locating and prepping the file

The loader asset lives in a folder most users never see, which is why enabling hidden files in your manager matters. On a stock device, the path is /Android/data/com.whatsapp.tm/files/Themes/Splash/, containing a default loader.webm and a small JSON document telling the app which clip to play.

Rename your custom animation to loader.webm (or loader.mp4) so the manifest recognises it. If working with a GIF, rename it to loader.gif in the same folder, although not every build reads GIFs reliably. Convert the file with HandBrake to a web-friendly MP4 for the broadest compatibility across versions.

After placing the file, clear the cached loader through your phone's app settings, finding TMWhatsApp and tapping "Clear cache" while leaving data intact. This forces the app to re-read the splash folder on the next launch rather than pulling a stale image from storage.

Applying the animation through TM settings

Open the freshly cached TMWhatsApp and tap the three-dot menu, then choose "TM Settings" followed by "Universal". The Splash Screen option sits halfway down the second page, and tapping it shows a short preview of the current loader.

Pick "Custom Loader", point the picker at your file, and confirm. The preview only plays for two seconds, which is enough to spot resolution mismatches. Save the selection and back out to the chat screen, force-stop the app from settings and reopen it; the new animation should greet you full-screen during the loading phase.

Troubleshooting when the loader won't play

A silent loader usually means the wrong file name, even when the clip is fine. Check the spelling including casing, since Android's file system is case-sensitive and "Loader.webm" won't be picked up the same way as "loader.webm". A black screen often points to a codec issue, so re-encoding with H.264 and AAC audio usually fixes it.

Some animations stall at the first frame because they're set higher than TMWhatsApp expects. The app downsizes anything above 720p, but on older handsets the downsizing takes longer than the launch itself. Drop the resolution to 540p and the loader should sail through in under a second.

Permissions can also get in the way, particularly when the loader sits on an SD card formatted on a Windows PC. Move the file to internal storage and re-test. For more on how the asset folders behave, the sticker guide tips cover similar ground.

Pairing the loader with themes and privacy tools

Once the loader is humming, build the rest of the theme around it. The same splash folder accepts a wallpaper.png as the default chat background, and matching colours through TMWhatsApp's Universal theme picker gives the app a consistent feel from the loading screen through to the inbox.

Privacy tools pair well with a custom loader. Hide online status, anti-delete messages and locked chats sit behind the same settings panel, so it makes sense to switch them on in the same sitting. Anyone running the mod on a work-supplied phone should keep these tweaks behind a PIN, since some Brisbane corporate IT teams flag modified clients during routine audits.

Loader feature	Default WhatsApp	TMWhatsApp	GBWhatsApp
Custom MP4	Not supported	Supported	Supported
Custom WebM	Not supported	Supported	Limited
Custom GIF	Not supported	Limited	Supported
Image splash	Supported	Supported	Supported
Per-account loader	Not supported	Supported	Not supported

Handy habits when working with TMWhatsApp loaders:

• Keep the file under 8MB so it loads in one second on a mid-range Android.
• Match the phone's aspect ratio to avoid letterboxing on rare screen shapes.
• Re-encode any clip pulled from social media to H.264 before swapping it in.
• Always clear the app cache between loader swaps to avoid stale overrides.
• Run an antivirus scan on files sourced from Telegram groups before installation.
• Keep a copy of the original loader.webm backed up in case you want to revert later.

Pick a loader pack that suits the personality you want the app to project, drop it into the splash folder, fire up TMWhatsApp and watch the new animation greet you on launch. Once you've matched the rest of the theme and the privacy tools to it, the app stops feeling like a stock messenger and starts looking like something you've built yourself, splash screen to chat screen. Grab the verified builds direct from the resource hub so you're not chasing random forum links across the web.