47 releases (17 stable)

1.8.1 May 13, 2024
1.8.0 Mar 31, 2024
1.7.0 Feb 27, 2024
1.1.2 Jul 8, 2023
0.1.13 Mar 27, 2023

#1 in #companion

MIT license

395KB
10K SLoC

vrc-get

GitHub deployments crates.io deployments Github latest crates.io latest Homebrew Version MacPorts Version Scoop Version AUR Version

Open Source command line client of VRChat Package Manager, the main feature of VRChat Creator Companion (VCC), which supports Windows, Linux, and macOS.

This project is developed by community, not by VRChat.

Goals

Initial goals

  • Provide an open source command line client of VRChat Package Manager.
  • Provide more functionality for VPM than official vpm commands can do.

Additional goals since 2024

  • Provide a better cross-platform Creator Companion

Commands

For more details, please see --help

  • vrc-get install [pkg] [version] (with alias vrc-get i [pkg] [version] and vrc-get resolve) install package to your project
  • vrc-get remove [pkg] (with alias vrc-get rm [pkg]) remove package from your project
  • vrc-get outdated list outdated packages in your project
  • vrc-get upgrade [pkg] [version] upgrade package(s) in your project
  • vrc-get search <query...> search package in installed repositories in your PC
  • vrc-get repo list list installed repositories in your PC
  • vrc-get repo add <url> [NAME] add repository into your PC
  • vrc-get repo remove <name or url> remove repository from your PC
  • vrc-get repo cleanup cleanup repo cache
  • vrc-get repo packages <NAME|url> list packages in specified repository

Installation

Using homebrew

If you're using Homebrew, you can easily install vrc-get.

brew install vrc-get

Using MacPorts

If you're using MacPorts, you can easily install vrc-get with MacPorts.

sudo port install vrc-get

Using winget

If you're using modern Windows, you can install vrc-get with winget.

winget install anatawa12.vrc-get

Using scoop

If you're using scoop, you can install vrc-get from a scoop bucket.

scoop bucket add xrtools "https://github.com/babo4d/scoop-xrtools"
scoop install vrc-get

Using PKGBUILD from AUR

If you're using Arch Linux, you can install vrc-get from Arch User Repository. Please use your favorite AUR helpers.

yay -S vrc-get

Using cargo binstall

If you have cargo binstall, installing with cargo binstall is an easy & fast way to install vrc-get. Cargo binstall will download & install prebuilt vrc-get from GitHub.

cargo binstall vrc-get

Using cargo

If you have cargo, installing with cargo is an easy way to install vrc-get.

cargo install vrc-get

Prebuilt binaries

There are prebuilt binaries on the release page.

Download the executable file for your platform and place it anywhere you want. There are no additional requirements for these binaries. All binaries are compiled statically as possible.

For Linux, it's actually a static linked executable.

For Windows, only bcrypt.dll, ntdll.dll, kernel32.dll, advapi32.dll, ws2_32.dll, secur32.dll, and crypt32.dll, which is builtin dlls, are dynamically linked.

For macOS, only Security.framework, CoreFoundation.framework, libiconv.2.dylibs, and libSystem.B.dylibs, which are macOS-builtin dylibs, are dynamically linked.

For GitHub Actions

To use this tool to resolve(install) vpm dependencies, you have to use anatawa12/sh-actions/resolve-vpm-packages@master.

To use other commands, you have to install vpm-get via anatawa12/sh-actions/setup-vrc-get@master.

For more details, please refer to README for each action.

GUI version of vrc-get

Since late February 2024, an experimental gui version of vrc-get has been available. See README of ALCOM for more details.

Contribution

Dependencies

~12–27MB
~453K SLoC