Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

macOS Intel Installation

MediaGit-Core provides native binaries optimized for Intel-based Macs.

Quick Install (Homebrew - Recommended)

brew tap mediagit/tap
brew install mediagit-core

Alternative Installation Methods

Direct Binary Download

# Download latest Intel binary
curl -fsSL https://github.com/winnyboy5/mediagit-core/releases/download/v0.2.6-beta.1/mediagit-0.2.6-beta.1-x86_64-macos.tar.gz \
  | sudo tar xz -C /usr/local/bin

# Verify
mediagit --version

Using Installation Script

curl -fsSL https://raw.githubusercontent.com/winnyboy5/mediagit-core/main/install.sh | sh

macOS Gatekeeper Approval

First run may require security approval:

# If you see "cannot be opened because the developer cannot be verified"
xattr -d com.apple.quarantine /usr/local/bin/mediagit

# Or approve via System Preferences
# System Preferences → Security & Privacy → General → "Allow Anyway"

Post-Installation Setup

Shell Completions

Zsh (default on macOS 10.15+)

mediagit completions zsh > /usr/local/share/zsh/site-functions/_mediagit

Bash

brew install bash-completion
mediagit completions bash > /usr/local/etc/bash_completion.d/mediagit

Environment Variables

Add to ~/.zshrc:

# Optional: Set default backend
export MEDIAGIT_DEFAULT_BACKEND=local

# Optional: Enable debug logging
export MEDIAGIT_LOG=info

System Requirements

  • macOS Version: 10.15 Catalina or later
  • CPU: Intel Core 2 Duo or later
  • RAM: 512MB minimum, 2GB recommended
  • Disk: 100MB for binaries
  • Xcode: Command Line Tools (optional, for some features)

Install Xcode Command Line Tools

xcode-select --install

Verification

# Check version
mediagit --version

# Run self-test
mediagit fsck --self-test

# Create test repo
mkdir ~/test-mediagit
cd ~/test-mediagit
mediagit init

Expected output:

mediagit-core 0.2.6-beta.1
✓ All checks passed
✓ Initialized empty MediaGit repository in .mediagit/

Troubleshooting

“mediagit” cannot be opened

# Remove quarantine attribute
xattr -d com.apple.quarantine /usr/local/bin/mediagit

# If that doesn't work, explicitly allow in System Preferences
open "x-apple.systempreferences:com.apple.preference.security"

Command Not Found

# Check if binary exists
which mediagit

# If not found, check PATH
echo $PATH

# Add /usr/local/bin to PATH
export PATH="/usr/local/bin:$PATH"
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc

Homebrew Not Found

# Install Homebrew first
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Permission Issues

# If brew install fails with permissions
sudo chown -R $(whoami) /usr/local/bin /usr/local/lib /usr/local/share

# Retry installation
brew install mediagit-core

Updating

Via Homebrew

brew update
brew upgrade mediagit-core

Manual Update

curl -fsSL https://github.com/winnyboy5/mediagit-core/releases/download/v0.2.6-beta.1/mediagit-0.2.6-beta.1-x86_64-macos.tar.gz \
  | sudo tar xz -C /usr/local/bin

Uninstalling

Via Homebrew

brew uninstall mediagit-core
brew untap mediagit/tap

Manual Uninstall

sudo rm /usr/local/bin/mediagit
rm -rf ~/.mediagit

Next Steps