Skip to content

v0.1.2-dev

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 04 Dec 07:38
· 157 commits to main since this release
v0.1.2-dev
9577d9c

Weave - MayaFlux One-Stop Installer

Version: 0.1.2-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)

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.2-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

SHA256: 63db7cc1bdbbb9ed12c74ce62fe2675a9bc1d8001317ad07fbed3afc52782725

Standalone Weave.app

For users who want just the GUI application without the full installer, download .

Usage:

  1. Download and unzip
  2. Drag to your folder
  3. Launch from Applications or Spotlight

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

Installation:

  1. Download and open Weave-0.1.2-dev.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)

Linux Distribution Package

Platform: Linux (x86_64)
Requirements: Python 3.8+, GTK4, ~2GB disk space

Installation

Quick Install:

tar -xzf Weave-0.1.2-dev-linux.tar.gz -C ~/.local/
~/.local/Weave-0.1.2-dev/Weave        # GUI mode

What Gets Installed

  1. Weave GUI Application - GTK4-based installer and project creator
  2. Weave CLI Tool - Command-line project creation
  3. Project Templates - CMakeLists.txt, source files, VS Code configuration
  4. Dependency Installer - Automated setup for all required libraries

Supported Distributions

  • Arch Linux (pacman)
  • Fedora (dnf)
  • Ubuntu/Debian (apt)
  • openSUSE (zypper)

Weave automatically detects your distribution and installs dependencies.

SHA256: 66a50556f173e1ecb9c2ce7386277e979ce2cf1998314dc6efd6ce1a3b199062

Windows Installer

windows-section.md

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

Installation

Double-click Weave-0.1.2-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: 741D57188FB9F972491AA79BA0E2E55059ACA55DA29167BA323C09FB413B27CB

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