blup

Blender Version Manager 🦀

A cross-platform CLI tool to manage Blender versions (rustup for Blender). Supports .blender-version files, context-aware execution, and script path injection.

Installation

git clone https://github.com/unclepomedev/blup.git
cd blup
cargo install --path .

Quick Start

Basic Usage

blup install 5.0.0                   # Download & Install
blup default 5.0.0                   # Set global default
blup list                            # Check installed versions
blup run                             # Run default version
blup run -- file.blend --background  # Run with arguments

Version Control

# Run specific version
blup run 5.0.0

# Pin version for project (Context Aware)
echo "5.0.0" > .blender-version
blup run  # Auto-detects 5.0.0 from file

For Developers

# Inject add-on scripts path (BLENDER_USER_SCRIPTS)
blup run --scripts ./my_addon

You can set the BLUP_MIRROR_URL environment variable. The URL must point to the directory structure equivalent to https://download.blender.org/release.

# Linux / macOS
export BLUP_MIRROR_URL=https://mirror.example.com/blender/release
# Windows (PowerShell)
$env:BLUP_MIRROR_URL="https://mirror.example.com/blender/release"

Uninstall

blup remove 4.2.0

License

MIT License