Skip to content

v0.1.4-dev

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 24 Dec 10:43
· 145 commits to main since this release
v0.1.4-dev
8804acc

Weave - MayaFlux One-Stop Installer

Version: 0.1.4-dev

Weave is the complete installation and project creation system for MayaFlux. It handles everything:

  • Downloads and installs the latest MayaFlux framework
  • Installs all required dependencies
  • Provides both GUI and CLI tools for creating new projects

Choose your platform below:

macOS Installer

macos-section.md

Platform: macOS 14.0+ (Sonoma or later)
Architecture: Universal Binary (arm64 + x86_64)

Click to expand

Installation

Double-click the .pkg file to start installation.

The installer will:

  1. Install Weave.app to /Applications
  2. Copy templates and CLI tool to /Library/Weave
  3. Open a Terminal window showing real-time installation progress
  4. Download and install MayaFlux framework (~100 MB)
  5. Install dependencies via Homebrew (takes 10-30 minutes)

Command-line alternative:

sudo installer -pkg Weave-0.1.4-dev.pkg -target /

What Gets Installed

  • Weave.app - Universal GUI application in /Applications
  • CLI Tool - Command-line tool at ~/.local/bin/weave
  • Project Templates - Located at /Library/Weave/templates
  • MayaFlux Framework - Downloaded to /Library/MayaFlux
  • Dependencies - Installed via Homebrew (ffmpeg, rtaudio, glfw, eigen, vulkan-sdk, etc.)

Environment Setup

Environment variables are added to ~/.zshenv automatically:

  • MAYAFLUX_ROOT - Points to MayaFlux installation
  • CMAKE_PREFIX_PATH - For CMake package discovery
  • PATH - Updated with MayaFlux tools

Restart your terminal or run source ~/.zshenv to activate immediately.

Creating Your First Project

Using Weave.app (GUI):

  1. Open /Applications/Weave.app or find it in Spotlight
  2. Enter project name and select location
  3. Click "Create Project"

Using CLI:

weave new MyProject ~/Projects/
weave new MyProject ~/Projects/ --with-lila     # With live coding
weave new MyProject ~/Projects/ --no-vscode    # Without VS Code config

Note: The standalone app requires the Weave files and templates to be already installed via the full installer.

Installation:

  1. Download and open `Weave-${VERSION}.pkg`
  2. Follow the installer prompts (installs Weave.app and files)
  3. Terminal will open automatically with installation progress
  4. Watch real-time progress for MayaFlux download and dependency installation

What's installed:

  • Weave.app in `/Applications` (GUI project creator)
  • Project templates and CLI tool in `/Library/Weave`
  • MayaFlux framework to `/Library/MayaFlux` (via post-install script)
  • Dependencies via Homebrew (via post-install script)

SHA256: a4d2bd998ab7b7488f3433686bc1791a66a1d249832c544671bdf20eb20d05bc

Linux Distribution Package

SHA256: 600412772ce7ba1b9629a17792c07ea02f4f97bba6b3c9724a73333fd942e131

Windows Installer

windows-section.md

Platform: Windows 10/11 (64-bit)
Architecture: x86_64

Click to expand

Installation

Double-click Weave-0.1.4-dev.exe to launch the installer.

The installer will:

  1. Show a mode selection dialog (Install MayaFlux or Create Project)
  2. Run step-by-step installation with progress tracking
  3. Download MayaFlux framework (~100 MB)
  4. Install dependencies (CMake, Vulkan SDK, FFmpeg, LLVM, etc.)
  5. Configure environment variables
  6. Extract project templates

Total time: 15-30 minutes (depends on internet and system)

Installation Steps

  1. Mode Selection - Choose "Install MayaFlux"
  2. System Check - Verifies Windows 64-bit, 7-Zip availability, admin privileges
  3. Download MayaFlux - Fetches latest framework from GitHub, shows progress bar
  4. Install Dependencies - Runs PowerShell script to install build tools and libraries
  5. Environment Setup - Sets system environment variables
  6. Templates - Extracts project templates
  7. Complete - Shows summary with log file location

What Gets Installed

  • Weave.exe - Single GUI application for all operations
  • MayaFlux Framework - Downloaded to C:\MayaFlux\ (default)
  • Build Tools - CMake, Git, Ninja, 7-Zip
  • Graphics Stack - Vulkan SDK, GLFW, GLM
  • Audio Stack - FFmpeg, RtAudio
  • Development Libraries - LLVM, Eigen3, STB, MagicEnum, oneDPL

Environment Setup

After installation, your system has:

  • MAYAFLUX_ROOT - Points to installation directory
  • PATH - Updated with MayaFlux and build tools
  • CMAKE_PREFIX_PATH - For CMake discovery

Restart your terminal/PowerShell for changes to take effect.

Creating Your First Project

  1. Run Weave.exe again (or click in Start Menu)
  2. Select "Create Project" mode
  3. Enter project name and select location
  4. (Optional) Enable Lila or VS Code configuration
  5. Click "Create Project"

The GUI shows real-time output of project generation.

SHA256: BB31CD200E46586152D01240EA3AF6A39602E0CCFE0ADC8C56E84B8A813ABB14

Creating Your First Project

Using the GUI:

  1. Weave launches automatically after installation
  2. Enter your project name and select a location
  3. Click "Create Project"

Using the CLI:

# macOS/Linux
weave new MyProject ~/Projects/

# Windows  
weave new MyProject C:\Projects\

Documentation

Assets 5
Loading