versabin

VersaBin

A versatile binary package manager for downloading and managing executables from various sources.

Features

• Download binaries from GitHub releases, URLs, Git repositories, and custom sources
• Support for multiple platforms (Windows, macOS, Linux) and architectures (x64, ARM)
• Version management for installed binaries
• Dependency resolution
• Security verification (checksum and signature verification)
• Flexible storage strategies
• Simple CLI and programmatic API

Installation

npm install -g versabin

CLI Usage

Install a binary

versabin install ripgrep

Install a specific version

versabin install ripgrep@13.0.0

List installed binaries

versabin list

List available versions for a binary

versabin versions ripgrep

Switch to a different version

versabin use ripgrep 13.0.0

Execute a binary

versabin exec ripgrep --version

API Usage

import { VersaBin } from 'versabin';

const versabin = new VersaBin();

// Install a binary
await versabin.install({
  name: 'ripgrep',
  source: {
    type: 'github',
    config: {
      owner: 'BurntSushi',
      repo: 'ripgrep',
      assetPattern: 'ripgrep-.*-{platform}-{arch}.{ext}'
    }
  }
});

// Execute a binary
const result = await versabin.execute('ripgrep', ['--version']);
console.log(result.stdout);

// Get binary path
const binaryPath = versabin.getBinaryPath('ripgrep');

// List installed versions
const versions = await versabin.listVersions('ripgrep');

// Switch version
await versabin.use('ripgrep', '13.0.0');

Configuration

Create a versabin.config.json file in your project or home directory:

{
  "storage": {
    "strategy": "user",
    "symlink": true
  },
  "packages": [
    {
      "name": "ffmpeg",
      "description": "A complete solution to record, convert and stream audio and video",
      "source": {
        "type": "github",
        "config": {
          "owner": "FFmpeg",
          "repo": "FFmpeg",
          "assetPattern": "ffmpeg-.*-{platform}-{arch}.{ext}"
        }
      },
      "binaryPath": "bin/ffmpeg",
      "platforms": ["win32", "darwin", "linux"],
      "architectures": ["x64", "arm64"],
      "env": {
        "FFMPEG_PATH": "{binPath}"
      }
    }
  ]
}

License

MIT