Features and Tips
All the features available in TConvert and how they work. TConvert comes in two forms: Window form, with UI and basic console support. And Console form with better console support but no Window.
- Usually able to locate the Terraria Content folder on its own.
- Extract fonts, images, sounds, and sons and convert them into an appropriate file type.
- Convert images and sounds back into Xnb file type Terraria uses.
- Backup or restore your content directory. (Just a glorified file copy)
- Run scripts to rename and move files when you convert or extract them.
- Drop files onto the window or open files with TConvert through windows to process them.
- Comes with command line support.
TConvert is picky with file extensions because it needs that information to determine how to process a file. These are the only file extensions TConvert will pay attention to.
- Extraction: .xnb, .xwb
- Conversion: .png, .bmp, .jpg, .wav
- Scripts: .xml
If TConvert has not been updated for the latest version of Terraria, any new songs added to the wave bank will be labeled ##_Unknown.wav. If you would like to fix this or rename any of the previous output songs, then create the file TrackList.txt and store it in your executable directory, Terraria program directory, or Terraria save directory. The current wave bank list can be found here.
Manually edit the paths in either the Extract or Convert tab and change both of them to just . (This stands for the current directory in filepath).
- Extract Wavs and Pngs from Xnb and Xwb files.
- Select an input with Xnb and/or Xwb files.
- Select an output to store the extracted Wav and Png files.
- Choose to extract either a folder and all its subfolders or a single file.
- For folders, choose which resources to include or exclude from extracting.
- Press Use Terraria to use Terraria's Content folder as the input folder.
- Check Use Input as Output to extract to the same location as the input.
- Convert Wavs and Pngs back into Xnb files. (Does not support font Xnbs or wave bank Xwbs)
- Select an input with Png and/or Wav files.
- Select an output to store the converted Xnb files.
- Choose to convert either a folder and all its subfolders or a single file.
- For folders, choose which resources to include or exclude from converting.
- Press Use Terraria to use Terraria's Content folder as the output folder.
- Check Use Input as Output to convert to the same location as the input.
- A glorified file copy feature for keeping your Terraria content files safe.
- Select a Content folder to make a backup from or restore to.
- Select a Backup folder to send the backup to or restore from.
- Press Use Terraria to use Terraria's Content folder as the Content folder.
Backup will take all files in the directory and copy them over to the Backup directory no matter what. Restore will only copy the file back to the Content directory if the file size or last modified date is different.
- Run a script that can perform any of the above functions but with the ability to control the names of output files.
- Select an Xml script file to run and press Run Script to execute it.
- TConverts file menu comes with two quality of life features.
- You can choose to launch Terraria, assuming your Content folder is a subfolder of the Terraria directory.
- Or you can choose to open the Terraria folder, assuming your Content folder is a subfolder of the Terraria directory.
- Enable or disable image compression. Terraria normally has it's images compressed. The tradeoff is compression takes longer.
- Choose to play a sound when the process has been completed.
- Choose when the progress window should auto-close so that you don't need to close it yourself. The error log window will still open if errors or warnings occur during the process.
- Window Progress auto-closes the progress window when used directly from the TConvert UI.
- File Drop Progress auto-closes the progress window when the process was initiated from files dropped into the TConvert window.
- Cmd Line Progress auto-closes the progress window when the process was initiated through Windows Shell (I.E. Open With) or the command line.
Anytime errors or warnings occur during a process, an error log will appear after the process is finished to tell you what when wrong. The same error log will also be written to TConvert-ErrorLog.txt in the same directory as your executable.