Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/i5ucc/vrcautolaunch

A lightweight program that Automatically launches external programs with VRChat.
https://github.com/i5ucc/vrcautolaunch

automation launcher vrchat vrchat-tool

Last synced: 2 months ago
JSON representation

A lightweight program that Automatically launches external programs with VRChat.

Awesome Lists containing this project

README

        

# VRCAutolaunch [![Github All Releases](https://img.shields.io/github/downloads/i5ucc/VRCAutoLaunch/total.svg)](https://github.com/I5UCC/VRCAutoLaunch/releases/latest)

A lightweight program that Automatically launches external programs with VRChat.

Useful if you use a boatload of different OSC programs and dont want to start them manually every time you start VRChat or you don't want them to start everytime when SteamVR starts.

### [ Discord Support Server](https://discord.gg/rqcWHje3hn)

# Install
## Automatic
1. Download the [newest release](https://github.com/I5UCC/VRCAutolaunch/releases/latest)

2. Unpack the zip somewhere it will stay in. e.g. C:/.

3. Run ***install.bat*** with **Admin Priviliges**.

- On ***non*** Windows Home Edition: ***install.bat*** activates Audit process tracking and creates a Scheduled Task with a custom filter to automatically start with vrchat.

- On Windows Home Edition: ***install.bat*** creates a Scheduled Task that launches on startup.

4. Add all your programs to config.json. look under [#Usage](https://github.com/I5UCC/VRCAutoLaunch#usage) on how to do that.

5. Now all of your programs will run on VRChat startup!

## Manual
1. Download the [newest release](https://github.com/I5UCC/VRCAutolaunch/releases/latest)

2. Unpack the zip somewhere it will stay in. e.g. C:/.

3. Add it to your systems autostart:

- Either place the VRCAutolaunch.exe in the `C:\Users\{UserName}\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup` (shell:startup) folder.
- or create a Scheduled Task that launches VRCAutolaunch on startup.

# Usage
To add a program to your Autolaunch, you need to edit the config.json file.

You can do that by either running the ***Configurator.exe***:
![image](https://user-images.githubusercontent.com/43730681/215346515-f00f2edf-369c-4fb9-b90d-d98e0d12de59.png)

![image](https://user-images.githubusercontent.com/43730681/215346523-f2f574cc-ff7d-4d05-af51-85dcfd788174.png)

Or by editing the config.json manually. It looks as follows:
```
{
"ProgramList": [
{
"FileName": "",
"WorkingDir": "",
"Arguments": "",
"StartMinimized": 1,
"CloseOnQuit": 1,
"VROnly": 1
}
]
}
```

***"FileName":*** full name of the .exe file

***"WorkingDir":*** is the directory of your executable.

***"Arguments":*** if you need any, can leave empty.

***"StartMinimized":*** determines if the program should be started minimized or normally. Values are either 0 (false), 1 (true) or 2(legacy). legacy minimizing waits until the window was opened, then minimizes it. Some programs dont want to work unless it is done this way.

***"CloseOnQuit":*** determines if the program should close whenever the game is closed. Values are either 0 (false) or 1 (true)

***"VROnly":*** determines if the program should be autostarted only in VR or always. Values are either 0 (false) or 1 (true).

All the Entries in that list are seperated by a comma ',' and follow the syntax of json.

### Heres an example on how a configuration might look:

```
{
"ProgramList": [
{
"FileName": "vor.exe",
"WorkingDir": "F:/Program Files/vor/bin/",
"Arguments": "--enable-on-start",
"StartMinimized": 2,
"CloseOnQuit": 1,
"VROnly": 0
},
{
"FileName": "cmd.exe",
"WorkingDir": "C:/Windows/System32/",
"Arguments": "/c start steam://run/1009850/",
"StartMinimized": 1,
"CloseOnQuit": 0,
"VROnly": 1
},
{
"FileName": "HRtoVRChat_OSC.exe",
"WorkingDir": "F:/Program Files/HRtoVRChat/HRtoVRChat_OSC/",
"Arguments": "",
"StartMinimized": 1,
"CloseOnQuit": 1,
"VROnly": 0
},
{
"FileName": "ThumbParamsOSC_NoConsole.exe",
"WorkingDir": "F:/Program Files/ThumbParamsOSC/",
"Arguments": "",
"StartMinimized": 0,
"CloseOnQuit": 1,
"VROnly": 1
},
{
"FileName": "TextboxSTT.exe",
"WorkingDir": "F:/Program Files/TextboxSTT",
"Arguments": "",
"StartMinimized": 1,
"CloseOnQuit": 1,
"VROnly": 0
},
{
"FileName": "VRCDiscordMute_NoConsole.exe",
"WorkingDir": "F:/Program Files/VRCDiscordMute",
"Arguments": "",
"StartMinimized": 0,
"CloseOnQuit": 1,
"VROnly": 0
}
]
}
```