stewartlynch/xcodeprojectrenamer

🚀 What Does It Do?

Renaming an Xcode project isn't just renaming a folder — it often involves:

• Renaming the .xcodeproj file
• Renaming the .xcworkspace file (if present)
• Renaming scheme names
• Renaming directory names
• Updating internal references to the old name in:

- project.pbxproj - workspace data files - .swift or .plist files (if desired)

xprename automates all of this safely and quickly in a single command.

📦 Option 1: Installation via Homebrew

You can install the command-line tool using Homebrew:

brew install stewartlynch/tap/xprename

🛠 Option 2: Manual Build & Install locally via SwiftPM

If you prefer to build it yourself, you can clone the repo and install the tool manually using Swift Package Manager.

Clone the Repository

git clone https://github.com/StewartLynch/XcodeProjectRenamer.git
cd XcodeProjectRenamer

Build with SwiftPM

swift build -c release
sudo cp .build/release/xprename /usr/local/bin/

🧪 How to use

Once installed:

1. Open Terminal
2. Change the directory to your project directory
3. Issue the following command:

xprename MyOldAppName MyNewAppName

This will:

• Rename all references of MyOldAppName to MyNewAppName
• Rename .xcodeproj and .xcworkspace files
• Update folder names and scheme names accordingly

Other commands

version

To display the current version

xprename --version

help

To show help information

xprename -h

License

This code is released under the MIT license. See LICENSE for details.

Package Metadata

Repository: stewartlynch/xcodeprojectrenamer

Default branch: main

README: README.md