🌀 RotationUpdater v1.0.0

A simple Python GUI tool to update all 360 images rotation values in deeply nested images.json files.

RotationUpdater is a Python GUI tool that allows users to update all rotation fields in a nested images.json file. It recursively finds and replaces all list-type rotation values with user-defined values via a simple Tkinter-based interface.

This tool is ideal for anyone working with 3D configurations, AR/VR metadata, or batch JSON updates. Lightweight, beginner-friendly, and easily extendable. No external libraries required.

Developed by P. Naveen Kumar Reddy

---

📜 Features

• Easy-to-use Tkinter GUI
• Select and update images.json with new rotation values
• Detects and replaces all list-type rotation keys recursively
• Handles complex nested JSON structures
• Shows user-friendly error and success popups

---

📅 Installation

1. Clone the repository

git clone https://github.com/NaveenKumarReddy21/360-images-Rotation-Updater.git
cd 360-images-Rotation-Updater

2. Ensure Python is installed

Verify Python 3.x is available:

python --version

3. Install dependencies (if any)

This tool uses Python standard libraries, but for future compatibility:

pip install -r requirements.txt

On Linux systems, you may need to install tkinter manually:

sudo apt-get install python3-tk

---

💥 Screenshots

Main UI

File Selected

Rotation Applied

Success Message

---

⚙️ How to Use

1. Run the script:

python rotation_updater.py

2. In the GUI:

   • Click Browse to choose your images.json
   • Enter new X, Y, Z rotation values
   • Click Apply Rotation

3. The tool will recursively search for and update all rotation arrays in the file.

---

📁 Project Structure

RotationUpdater/
├── rotation_updater.py
├── requirements.txt
├── README.md
├── screenshots/
│   ├── main_ui.png
│   ├── file_selected.png
│   ├── rotation_applied.png
│   └── success_message.png
└── .github/
    └── workflows/
        └── python-lint.yml

---

🖒 What's Coming Next?

• Preview JSON content before updating
• Dark mode theme
• Drag-and-drop JSON file support
• Custom rotation key input
• 📆 One-click .exe builder with PyInstaller
• 🚀 Automatic release packaging via GitHub Actions

---

🤖 GitHub Actions (CI/CD)

This project uses GitHub Actions to check for Python syntax errors on every push:

# .github/workflows/python-lint.yml
python -m py_compile rotation_updater.py

✅ Helps catch bugs early and maintain clean code.

---

📝 Feedback

Have a suggestion or found a bug?

• 📧 Email: naveenreddy.puthi@gmail.com
• 📝 Open an issue: GitHub Issues
• ⭐ Star the repo if it helped you!

---

👨‍💼 Developer

P. Naveen Kumar Reddy 📧 naveenreddy.puthi@gmail.com 📍 Hyderabad, India

---

📄 License

This project is licensed under the MIT License.