Spacesuit MSUK Supertool

Small application to convert image descriptions (both IPTC and XMP) from Spacesuit Media's to Motorsport-UK's preferred format.

Note

Update 02/03/2025

This now includes a tool to create a csv based on a rally's entry list (from rallies.info)

macOS Installation

1. Download the latest release from releases
2. Extract the zip
3. Run the installation script (installer.app)
4. Run the .dmg file and drag to "Applications"
5. Select and run "MSUK-Description-Fixer" from launchpad, spotlight, RayCast etc

Important

macOS Security Notices

When running the application for the first time, you may see security warnings. This is normal for applications not from the App Store. Here's how to handle them:

Method 1: Right-click to Open (Recommended)

1. In Finder, right-click (or Control-click) the app
2. Select "Open" from the context menu
3. Click "Open" in the security dialog
4. Only needs to be done once

Method 2: Terminal Command

xattr -d com.apple.quarantine "/Applications/MSUK-Description-Fixer.app"

For the Installation Script

The same process applies to the installer:

1. Right-click installer.app
2. Select "Open"
3. Click "Open" in the security dialog Note: These steps are necessary because this is an open-source application not signed with an Apple Developer certificate.

Development

If you're me (jamesmpigott) or otherwise insane, here's how you can get this repo setup for local development.

Prerequisites

• Python 3.7+
• pip (Python package manager)
• Homebrew
  • (if you don't have this installed, the installer script will install this for you)
• exempi
• create-dmg

Initial Setup

# Install system-level dependencies via homebrew
brew install exempi create-dmg

# Clone repo
git clone https://github.com/jamesmpigott/iptc.git

# Create and activate virtual environment
python3 -m venv venv
source venv/bin/activate

# Install Python dependencies
pip install -r requirements.txt

# Optional - if you need to run create_dmg.sh locally
chmod +x create_dmg.sh

From this point, you've got a few files of note:

• terminal.py: Terminal-based version of the application
• gui.py: GUI-based version of the application
• install_deps.py: Installer script
• create_dmg.sh: Script to create .dmg file, based on Kevin Marville's setup_and_package.sh script.

Compiling

# compile .py files
pyinstaller gui.spec 
pyinstaller installer.spec

# Create .dmg file
./create_dmg.sh

Releasing a new version

push to main, with a tag in the following format: v{version}, i.e v.1.2.5. Please use Semantic Versioning for the version string. The build-release.yml action should take care of the rest.