Speedy S4CC - Sims 4 CC file extraction/organizing tool

Overview

Speedy S4CC is a cross-platform tool for organizing Sims 4 Custom Content. It automatically extracts ZIP files, sorts .package files into your Mods folder, and moves tray items to your Tray folder.

System Requirements

macOS

• macOS 10.14 (Mojave) or later
• Intel or Apple Silicon Mac
• The Sims 4 installed

Windows

• Windows 10 or later (64-bit recommended)
• The Sims 4 installed

Linux

• Modern Linux distribution (Ubuntu 18.04+, Fedora 30+, etc.)
• Python 3.8+ and Tkinter support
• The Sims 4 installed (via Steam/Lutris/Wine)

Default Folder Locations

macOS & Windows

• SimsCC Source: ~/Downloads/SimsCC
• Mods Destination: ~/Documents/Electronic Arts/The Sims 4/Mods
• Tray Destination: ~/Documents/Electronic Arts/The Sims 4/Tray

Linux

• SimsCC Source: ~/Downloads/SimsCC
• Mods Destination: ~/.local/share/Sims4CC/Mods
• Tray Destination: ~/.local/share/Sims4CC/Tray

Building from Source

Prerequisites

1. Install Python 3.8 or later
2. Clone this repository
3. Navigate to the project directory

macOS Build

chmod +x build_macos.sh
./build_macos.sh

Windows Build

build_windows.bat

Linux Build

chmod +x build_linux.sh
./build_linux.sh

Usage

First Time Setup

1. Create the SimsCC folder in your Downloads directory
2. Organize your CC files in the SimsCC folder:
   • Put ZIP files directly in ~/Downloads/SimsCC/
   • Put loose .package files in ~/Downloads/SimsCC/
   • Put .blueprint/.bpi/.trayitem files in ~/Downloads/SimsCC/

Running the Application

GUI Mode (Default)

• macOS: Double-click Sims4SpeedyCC.app or run ./run_speedy_s4cc_macos.sh
• Windows: Double-click Sims4SpeedyCC.exe or run run_speedy_s4cc_windows.bat
• Linux: Run ./run_speedy_s4cc_linux.sh or execute the binary directly

Command Line Mode

# macOS/Linux
./Sims4SpeedyCC --help

# Windows
Sims4SpeedyCC.exe --help

Supported File Types

• ZIP Archives: Automatically extracted and processed
• Package Files: .package files moved to Mods folder
• Tray Items: .blueprint, .bpi, .trayitem files moved to Tray folder

Platform-Specific Notes

macOS

• The app creates a standard macOS application bundle
• Supports both Intel and Apple Silicon Macs
• May require "Allow apps downloaded from anywhere" in Security settings

Windows

• Built as a standalone executable
• No installation required - just run the .exe file
• Windows Defender may show a warning for unsigned executables

Linux

• Requires Tkinter for GUI support
• Built as a portable executable
• Can be packaged as AppImage, Flatpak, or Snap for easier distribution

Troubleshooting

Common Issues

1. Folder not found: The app will create missing folders automatically
2. Permission errors: Run as administrator (Windows) or check file permissions (Linux/macOS)
3. GUI not starting: Check that Tkinter is installed and working

Platform-Specific Issues

macOS

• If app won't open: Right-click → Open, then click "Open" in the security dialog

Windows

• If antivirus blocks the app: Add an exception for the executable

Linux

• If GUI doesn't work: Install python3-tk package
• Ubuntu/Debian: sudo apt install python3-tk
• Fedora: sudo dnf install python3-tkinter
• Arch: sudo pacman -S tk

Development

Project Structure

speedy-s4cc/
├── src/speedy_s4cc/          # Source code
│   ├── main.py               # Main application
│   ├── config.py             # Cross-platform configuration
│   ├── gui.py                # GUI interface
│   └── ...                   # Other modules
├── build_macos.sh            # macOS build script
├── build_windows.bat         # Windows build script
├── build_linux.sh           # Linux build script
└── README.md                 # This file

Contributing

1. Fork the repository
2. Create a feature branch
3. Test on your target platform(s)
4. Submit a pull request

License

Copyright (c) 2025, Dani Wibbenmeyer. All Rights Reserved.

Support

For issues or questions:

1. Check the troubleshooting section above
2. Create an issue on GitHub
3. Include your platform and Python version in bug reports

Acknowledgments

Built with ❤️ for my wife, and for The Sims 4 community. This tool respects user privacy and security while making CC management effortless.