terrADBsync v1.0-beta

TerrADBsyncDemo.mp4

Easy synchronization of Terraria save files between Windows/Linux and Android using ADB (Android Debug Bridge).

Compatible with Terraria versions what?

Android Terraria v1.4.4.9.2 == PC Terraria v1.4.4.9

What it does

• In terms of your Terraria Players and Worlds, it treats your PC and android device as one.
• Files that are chosen to be synced are based on md5 hashing and their latest modification date.

Concerns

• In my 90 hours of playing Terraria using this program, I have never encountered any issues.
• If Windows flags the program not recommended to run or is malicious, you can review the code.
• For further concerns, open an issue.

Warning

• It does not handle file conflicts. The program cannot yet take action if same files from different platforms gets modified, it will just base on the latest modified date.

That means you can simultaneously play Terraria on your phone and PC as long as both play on different Players and Worlds.

Bundled Features

• Backups
  • Located in the Terraria folder.
  • Has backup limitation maximum of 5 backups at a time.
• Terraria custom path support
  • Limited only to Windows and Linux

Installation

Android Setup

1. Enable Developer options (Locations may vary).
   • Go to Settings and find About phone.
   • Once there, find and press Build number seven times or until it notifies you that You are now a developer!
   • If Build number doesn't show up immediately, it might be in Software information.
2. Plug the phone to the computer.
3. Set the Media Transfer Protocol(MTP)
   • Once plugged, there will be a notification in a form of Use USB for.
   • On default it is set to Charge only, therefore set it to Transfer files.
4. Enable USB debugging.
   • Back to Settings, find Developer options.
   • In developer options, enable USB debugging option located in the DEBUGGING section.

It's important to note the order of step 3 and 4, otherwise, USB debugging will turn off and have to be enabled again. For more precise info, consider following this guide.

TerrADBsync Installation

In the repository, press the green < > Code button and Download ZIP. Thereafter, extract it.

PC setup and program execution

Make sure the Android Setup is finished and waiting.

For Windows

There are two options:

1. Run via terradbsync.exe (No manual dependency install required)

• Double click the terradbysnc.exe file

2. Run via terradbsync.py (requires Python that is set to PATH environment)

• Open command-line(cmd) and change directory to TerrADBsync-main directory in the extracted zip file
  • cd path/to/TerrADBsync-main
• Run the .py file using Python (Compatible with Python versions 3.9, 3.10, or 3.11):
  • Enter python terradbysync.py
  • If the above command doesn't work, try python3 terradbsync.py

For Linux

1. Run via terradbsync.py (requires Python that is set to PATH environment)

• Launch terminal and change directory to TerrADBsync-main directory in the extracted zip file
  • cd path/to/TerrADBsync-main
• Run the .py file using Python (Compatible with Python versions 3.9, 3.10, or 3.11):
  • Enter python terradbysync.py or alternatively ./terradbsync.py
  • If the above command doesn't work, try python3 terradbsync.py

Credits

• Terraria icon by Icons8