Skip to content

Installation fails on macOS (arm64) due to Linux-only native dependencies #32

@arnlaugsson

Description

@arnlaugsson

Problem

Installation via the install script fails on macOS (Apple Silicon) because package.json includes platform-specific Linux dependencies as hard requirements:

  • @remotion/compositor-linux-x64-gnu (v4.0.432) — listed in dependencies
  • @rspack/binding-linux-x64-gnu (v1.7.7) — listed in dependencies

These packages declare "os": "linux" and "cpu": "x64", so npm correctly refuses to install them on darwin/arm64.

Steps to Reproduce

  1. On macOS (Apple Silicon / arm64), run:

    curl -fsSL https://raw.githubusercontent.com/Ark0N/Codeman/master/install.sh | bash
  2. Installation fails at npm install with:

    npm error code EBADPLATFORM
    npm error notsup Unsupported platform for @remotion/compositor-linux-x64-gnu@4.0.432:
    wanted {"os":"linux","cpu":"x64"} (current: {"os":"darwin","cpu":"arm64"})
    

Environment

  • OS: macOS (Darwin 24.6.0, arm64 / Apple Silicon)
  • Node.js: v22.17.0
  • npm: bundled with Node

Expected Behavior

Installation should succeed on macOS, as it is listed as a supported platform in the README.

Suggested Fix

Move the platform-specific native binaries to optionalDependencies instead of dependencies. This way npm will skip them gracefully on unsupported platforms:

"optionalDependencies": {
  "@remotion/compositor-linux-x64-gnu": "4.0.432",
  "@rspack/binding-linux-x64-gnu": "1.7.7"
}

Alternatively, use Remotion's built-in platform detection which automatically pulls the correct compositor for the current OS/arch.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions