Skip to content
This repository was archived by the owner on Sep 10, 2026. It is now read-only.
ourpxiPublic archive

About

Automatically renames Factorio mod folders based on the `name` field inside each mod’s `info.json` file.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

NameSync

NameSync is a simple Python script that renames Factorio mod folders to match the format required by the game.

🧩 Why This Exists

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

⚙️ What It Does

  • Scans the specified mods directory
  • Looks for folders containing an info.json file
  • Reads the "name" and "version" fields from each file
  • Renames the folder to follow the name_version format

🚀 Usage

By default, the script will try to locate your Factorio mods directory automatically, ussualy:

C:\Users\YourName\AppData\Roaming\Factorio\mods

If 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 --manual

And then provide a directory path when prompted.

📦 Downloads

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.

🧪 Testing

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:

  1. Run the script with the --manual option.
  2. When prompted, enter the path to the test_environment directory.

Example:

python NSmain.py --manual

License

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0). See LICENSE file for details.

About

Automatically renames Factorio mod folders based on the `name` field inside each mod’s `info.json` file.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages