How to Add Custom Characters in DesktopTale
Adding custom characters to DesktopTale is the ultimate way to turn your computer screen into a personal playground. While the base app comes with the Undertale classics, the community has created thousands of new sprites from all over.
This guide is your complete roadmap to downloading, installing, and managing your very own desktop companions from scratch. By following our easy steps, you can transform your boring taskbar into a lively world in just a few minutes.
What are Custom Characters in DesktopTale and Where to Find Them?
Custom characters are essentially “modded” versions of the default sprites that run on the DesktopTale engine. These characters use specialized image files called sprite sheets to tell the app how to move and interact on screen.
Because the app is open source and fan-friendly, adding new faces is as simple as moving a few files to the right spot. Once you learn where to find the best designs, you will never run out of new friends for your desktop.
Finding High-Quality Sprite Sheets on GitHub and Fan Forums
The best places to hunt for new characters are community-driven sites like GitHub, itch.io, and dedicated Undertale fan forums. Many creators share their work for free, providing a folder with all the necessary images.
Always look for “DesktopTale-ready” packs to ensure the animations are already timed perfectly for the app’s movement engine. This saves you from manually editing code or resizing images before you can start using them.
Understanding the Required File Formats for Desktop Pets
To work correctly, your custom characters need to be in a transparent .png format so they blend with your wallpaper. This prevents ugly white or black boxes from appearing around your character as they walk across your screen.
Each character folder must also include a metadata file, usually a .json or .txt file, that serves as the instruction manual. Without this “brain” file, the app won’t know how fast the character should walk or when they should stop moving.
Quick Start Guide to Importing New Characters
If you have already downloaded a cool character pack, you are just a few clicks away from seeing it live on your desktop. Importing characters is a straightforward process that mostly involves some simple file management in your Windows folders.
You don’t need to be a coding expert to get this done, and it won’t mess up your computer if you follow these steps. Let’s get those files into the right place so you can start enjoying your new custom desktop pets.
Locating the DesktopTale Character Assets Folder
First, find where you installed the main DesktopTale application on your hard drive. Most people keep it in their “Downloads” or “Documents” folder, but it could be in any folder you choose to extract the original files.
Inside the main folder, you will see a subfolder labeled “Characters” or “Assets.” This is the secret home where all your pixel-art buddies live, and it is where we will be adding our new custom folders.
Extracting Sprite Files and Folder Organization
When you download a character, it usually comes in a .zip or .rar file that needs to be extracted first. Make sure each character has its own folder inside the main “Characters” directory.
- Right-click your downloaded file and select “Extract All.”
- Open the extracted folder to make sure the .png and .json files are directly inside.
- Move this specific folder into the DesktopTale “Characters” folder and restart the app to see it in the menu.

Configuring Character Metadata and Animation Settings
Sometimes a custom character might walk too fast or look a bit glitchy when they stop. You can fix this by opening the “metadata” file and adjusting a few simple numbers to your preferred settings.
This gives you total control over how your pets behave while you are working or gaming. It is a fun way to experiment and see what works best for different types of character designs and animation styles.
Editing the Character .json File for Custom Movements
The .json file is just a text file you can open in Notepad to see all the characters’ “rules.” You can change things like the character’s name, their scaling size, and even their special interaction phrases.
- Right-click the .json file and choose “Open with Notepad.”
- Look for the “WalkSpeed” or “Scale” values to make quick adjustments.
- Save the file and reload the app to see your changes take effect immediately on your screen.
Setting Walk Speeds and Interaction Triggers
You can also decide how often your character decides to walk, jump, or sit down while you are busy. Increasing the “RandomMovement” value will make your desktop feel more alive and energetic throughout the day.
- Change “IdleTime” to a lower value to make your pet move around more frequently.
- Adjust the “ClickAction” to decide what happens when you tap on the character with your mouse.
- These tiny tweaks make each custom character feel unique and more personal to your specific desktop setup.
Creating Your Own Custom Sprite Sheets for DesktopTale
If you can’t find the character you want, you can actually draw your own using simple pixel art tools. Creating a sprite sheet is like making a tiny comic strip where each frame shows a different part of a movement.
This is a great project for anyone who loves art and wants to see their own creations come to life. Once you understand the grid system, you can turn any character into a walking, talking desktop companion.
Designing Pixel Art Frames for Walk and Idle Cycles
A standard walk cycle usually requires about 4 to 6 frames to look smooth on your screen. You should draw each frame at the same size to prevent the character from jumping or flickering during playback.
Focus on the “Idle” frames first, which are what the character does when they are just standing still. Making them blink or look around occasionally adds a lot of personality to your custom desktop pet designs.
Proper Alignment and Grid Spacing for Smooth Animations
The app reads your sprite sheet as a grid, so every frame must be perfectly aligned within its own “box.” If one frame is even one pixel off, the character will look like they are shaking or vibrating while they walk.
Most pros use a grid size like 32×32 or 64×64 pixels to keep things consistent and easy to manage. Using a dedicated pixel art program like Aseprite can make this alignment process much faster and more accurate.
Troubleshooting Common Custom Character Display Issues
Sometimes a new character won’t show up, or they might have a strange colored box around them. These are common issues that usually come down to a small error in the file format or the folder name.
Don’t panic if things don’t look perfect on the first try, as most of these problems are very easy to solve. Check this comparison table to identify the most common glitches and how to fix them in seconds.
| Invisible Sprite | Missing .json file | Copy a default .json and rename it. |
| Pink Background | Non-transparent PNG | Use a tool to remove the background. |
| Crashing on Select | Huge image file size | Resize the sprite sheet to be smaller. |
Fixing Invisible Sprites and Pink Background Glitches
If your character is invisible, the app usually can’t find the image path mentioned in the metadata file. Open your .json file and make sure the “FileName” exactly matches the name of your .png image, including capitalization.
Pink or white backgrounds happen when the “Alpha Channel” is missing from your image file. Re-saving your sprite sheet as a “Transparent PNG-24” in your art program will usually solve this transparency bug instantly.
Resolving Aspect Ratio and Scaling Conflicts
If your character looks stretched or squished, the “Frame Width” in your metadata might be set incorrectly. The app needs to know exactly how wide each frame is so it can cut the sprite sheet into the right pieces for animation.
Check the image’s total width and divide it by the number of frames to find the correct value. Entering this number into the “FrameWidth” section of your config file will restore the character’s natural proportions.
Advanced Management of Large Character Collections
Once you get hooked on adding characters, your “Characters” folder can become a bit of a mess. Managing a large collection is all about staying organized so you can find the right pet for your current mood.
Keeping your files tidy also helps the app load faster and prevents weird lag when you pick a new character. Here are a few pro tips for handling a massive army of desktop sprites without breaking a sweat.
Creating Custom Sub-Folders for Character Categories
You can organize your pets into sub-folders like “Anime,” “Undertale,” or “Gaming Icons.” This makes the selection menu much easier to navigate when you have dozens of characters to choose from.
Just make sure that the folder structure doesn’t get too deep, or the app might have trouble finding the assets. One level of sub-folders is usually the “sweet spot” for both organization and performance on most computers.
Optimizing Asset Loading to Prevent Launch Lag
If the app takes a long time to open, it might be trying to scan too many large image files at once. You can speed things up by deleting any characters you don’t use often or by shrinking their file sizes.
Using a “PNG Compressor” tool can reduce the file size of your sprite sheets without losing any visual quality. This keeps your DesktopTale experience fast and snappy, even with a large library of custom friends.
Conclusion
Adding custom characters is the best way to make DesktopTale truly yours, and it is a blast to experiment with new designs. By following the steps in this guide, you can download, install, and even create your own pets with total confidence. Whether you want a single buddy or a full screen of sprites, the process is simple once you know the basics of file management. Now that you are a customization pro, go out there and find some awesome new characters to liven up your desktop today!
Frequently Asked Questions (FAQ)
Can I add characters from other games like Hollow Knight?
Yes! As long as you can find or make a sprite sheet for them, you can add any character from any game into DesktopTale. Many fans have already made packs for popular indie games.
Why does the app crash when I select my new character?
This usually means there is a typo in your .json file or the image file is too large for your RAM. Check your spelling and try to keep your sprite sheets under 2048×2048 pixels.
How do I make my character bigger on the screen?
You can change the “Scale” setting in the app’s main menu, or manually change the value in the character’s metadata file. Scaling up by 2.0 or 3.0 is usually perfect for most monitors.
Do I need to restart the app to see new characters?
Yes, DesktopTale scans the “Characters” folder only when it first starts up. If you add a new folder while the app is open, just close it and reopen it to see your new additions.
Can I have two different versions of the same character?
Definitely! Just give each version a different folder name, like “Sans_Blue” and “Sans_Red.” The app will treat them as two separate characters in the selection menu.
Where is the best place to download safe character packs?
GitHub is the most reliable place because you can see the source files and the community ratings. Always avoid sites that look suspicious or try to give you an .exe file instead.
How do I delete a character I no longer want?
Simply go to your “Characters” folder and delete the specific folder for that character. The next time you open the app, they will be gone from your selection list.
Can I share the characters I create with my friends?
Yes, just zip up your character’s folder (containing the .png and .json) and send it over. Your friends can then drop that folder into their own “Characters” directory to use it.
Latest Posts:

