2026-02-16
This commit is contained in:
@@ -0,0 +1,53 @@
|
||||
# SheepIt Project Submitter
|
||||
|
||||
A Blender addon for packing projects for the SheepIt render farm with automatic asset packing and intelligent workflow management.
|
||||
|
||||
## Features
|
||||
|
||||
| Automatic Asset Packing | Frame Range Control | Multiple Packing Methods |
|
||||
|--|--|--|
|
||||
| Automatically packs all linked blend files, textures, images, and external assets into your project. Supports both ZIP and packed blend file workflows. | Configure custom frame ranges directly in Blender without saving your file. Frame ranges are automatically applied to packed files. | Pack as current blend file, packed ZIP archive, or packed blend file. Choose the method that best fits your project. |
|
||||
|
||||
| Cache Management | Size Validation | Progress Tracking |
|
||||
|--|--|--|
|
||||
| Automatically truncates cache files to match your selected frame range, reducing file sizes significantly. | Validates file sizes before packing (2GB limit) with helpful suggestions for optimization. | Real-time progress bars and status messages for all operations. All steps are cancellable. |
|
||||
|
||||
| Path Remapping | Missing File Detection | Error Reporting |
|
||||
|--|--|--|
|
||||
| Intelligently remaps all asset paths to work correctly on the render farm. Handles textures, images, videos, and linked blend files. | Detects and reports missing linked files and oversized files (>2GB) that cannot be packed. | Comprehensive error messages with actionable suggestions for resolving issues. |
|
||||
|
||||
### Additional Features:
|
||||
- Works with unsaved blend files (operates on in-memory state)
|
||||
- Automatic backup file cleanup (`.blend1` through `.blend32`)
|
||||
- Compressed blend file saves for optimal file sizes
|
||||
- File browser for selecting output location
|
||||
|
||||
## Installation
|
||||
|
||||
1. Download the latest release from [GitHub Releases](https://github.com/RaincloudTheDragon/sheepit-project-submitter/releases)
|
||||
2. In Blender, go to `Edit > Preferences > Add-ons`
|
||||
3. Click `Install...` and select the downloaded ZIP file
|
||||
4. Enable the addon by checking the box next to "SheepIt Project Submitter"
|
||||
|
||||
## Usage
|
||||
|
||||
1. **Set Frame Range**: In the Output properties panel, configure your frame range (full range or custom)
|
||||
2. **Pack Project**: Choose your packing method:
|
||||
- **Pack Current Blend**: Saves the current blend file with frame range applied
|
||||
- **Pack as ZIP**: Packs all assets and creates a ZIP archive (recommended for scenes with caches)
|
||||
- **Pack as Blend**: Packs all assets directly into the blend file
|
||||
3. **Select Output Location**: A file browser will open to select where to save the packed file
|
||||
4. **Upload Manually**: Upload the packed file to SheepIt via the website and configure your project settings
|
||||
|
||||
## Requirements
|
||||
|
||||
- Blender 3.0.0 or later
|
||||
|
||||
## License
|
||||
|
||||
GPL-3.0-or-later
|
||||
|
||||
## Links
|
||||
|
||||
- **GitHub Repository**: [https://github.com/RaincloudTheDragon/sheepit-project-submitter](https://github.com/RaincloudTheDragon/sheepit-project-submitter)
|
||||
- **SheepIt Render Farm**: [https://www.sheepit-renderfarm.com](https://www.sheepit-renderfarm.com)
|
||||
Reference in New Issue
Block a user