NameSync is a simple Python script that renames Factorio mod folders to match the format required by the game.
When downloading mods especially from third-party sources or manual installations the folder names are often incorrect or inconsistent. This tool was made to automatically fix that by reading each mod's info.json and renaming its folder accordingly.
See Factorio Wiki for details
- Scans the specified mods directory
- Looks for folders containing an
info.jsonfile - Reads the
"name"and"version"fields from each file - Renames the folder to follow the
name_versionformat
By default, the script will try to locate your Factorio mods directory automatically, ussualy:
C:\Users\YourName\AppData\Roaming\Factorio\modsIf it fails for any reason it will ask to manually input a directory.
If you'd like to skip the auto detection, you can run:
python NSmain.py --manualAnd then provide a directory path when prompted.
Script and releases can be found under the Releases section. Use those instead of cloning the whole repository if you only want the script.
For issues or problems, feel free to open a new issue in the issues section.
A simple testing environment is included in the repository (located in the test_environment folder).
This can be used to safely try the script without affecting your real mods.
To use it:
- Run the script with the
--manualoption. - When prompted, enter the path to the
test_environmentdirectory.
Example:
python NSmain.py --manualThis project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0). See LICENSE file for details.