Community:VRCX: Difference between revisions

From VRChat Wiki
DAG-XR (talk | contribs)
Marked for deletion; no content.
Hackebein (talk | contribs)
move 3th party api use message, add os info, sort features
 
(34 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{delete|Created; not started in over one month.|[[User:Usr 8ee44c1a-f905-4e08-bb61-e1cd34e09fc0|Usr 8ee44c1a-f905-4e08-bb61-e1cd34e09fc0]] ([[User talk:Usr 8ee44c1a-f905-4e08-bb61-e1cd34e09fc0|talk]]) 02:19, 22 September 2024 (UTC)}}
{{Noticebox/Community}}
[[Category:Empty]]
{{Noticebox/Third-party API usage}}
<infobox type="App" theme="community">
<group>
<title source="name"><default>VRCX</default></title>
<image source="image"><default>[[File:VRCX_Logo.webp|VRCX]]</default></image>
<data source="author"><label>Author</label><default>VRCX Team</default></data>
    <data source="platforms"><label>Platforms</label><default>Windows, Linux, macOS</default></data>
    <data source="languages"><label>Languages</label><default>English, French, Japanese, Simplified Chinese, Italian, Russian, Spanish, Polish</default></data>
    <data source="url"><label>URL</label>
          <default>[https://github.com/vrcx-team/VRCX GitHub]</default>
          </data>
        <header>App history</header>
        <data source="published"><label>Published</label><default>August 16, 2019</default></data>
  </group>
</infobox>
'''VRCX''' is a VRChat-focused [[wikipedia:Open source|open-source]] third-party application for Windows, Linux, and macOS, which provides a [[wikipedia:Graphical_user_interface|graphical user interface (GUI)]] for interacting with VRChat via the [[VRChat API]].
 
==Features==
 
===Friends and social===
*Manage friends list and organize friend lists outside of VRChat.
*Track friends' online status, world activities, and avatar changes.
*Log when friends were added, when last seen, and time spent together in worlds.
*Monitor name changes and store personal notes to remember how you met.
*View mutual friends and groups on user profiles, with an interactive graph visualization.
*Invite multiple friends to an instance at once using a searchable dialog that shows who is already present.
 
===Worlds and instances===
*Organize world and group lists outside of VRChat.
*Search for worlds by name, ID, or URL.
*Create and manage a custom local list of favorite worlds (unrestricted).
*View statistics and player details for the current instance.
 
===Avatars===
*Search for avatars using configurable external databases.
*Upload and edit images for avatars and worlds without Unity.
*Edit and update uploaded avatar or world details (name, description, tags) directly through VRCX, without Unity.
 
===Groups===
*Create group instances (Group, Group+, Group Public) with role-based access, queue, and age gate options.
*Create and browse group posts with role-based visibility.
*Browse group photo galleries.
*Manage group members, roles, and moderation actions.
*Export group moderation logs as CSV.
*Export or import favorite groups.
*Browse upcoming events in a monthly group calendar view.
 
===Profile===
*Edit status with saved presets for quick switching between status and description combinations.
*Edit bio, social links, and pronouns.
*Change profile picture via image upload.
 
===Notifications===
*Send and receive invites and friend requests directly from VRCX.
*View instance details of invitations received.
 
===Media and photos===
*Keep track of the worlds where in-game photos were taken.
 
===Integration and utilities===
*Automatically open companion apps (e.g. OSC tools, voice changers) when VRChat launches.
*Store settings, saved states, inventories, and other persistent data for supported worlds (World Persistence / PWI).
**'''Note''': VRCX's world persistence is unrelated to VRChat's official world persistence. Requires "Allow [[Untrusted URLs]]" in VRChat settings. For developers, see [https://github.com/vrcx-team/VRCX/wiki/World-Persistence-(PWI) World Persistence (PWI)] by VRCX.
*Display detailed information about the current instance in Discord, including thumbnails, names, instance IDs, player counts, and a join button for public lobbies (Enhanced Discord Rich Presence).
**Integrates with [[Community:PyPyDance|PyPyDance]], [[Community:LSMedia|LSMedia]], [[Community:Popcorn Palace|Popcorn Palace]], [[Community:Idle Home|Idle Home]] and [[Community:VRDancing|VRDancing]].
*Access a configurable VR overlay with live notifications and supported event feeds.
*Automatically re-launch VRChat and rejoin the last instance if it crashes.
*View video links and related data for videos playing in the current world.
 
==Keyboard shortcuts==
 
*Ctrl + Shift + I open Chromium DevTools.
* Ctrl + R restart VRCX.
*Shift + Alt + R reload custom css.
 
==Getting started==
Using outdated versions of VRCX may expose you to security vulnerabilities, including [[wikipedia:Arbitrary_code_execution|remote code execution]]<ref>[https://github.com/vrcx-team/VRCX/security/advisories/GHSA-j98g-mgjm-wqph VR Overlay RCE] on GitHub; retrieved September 23, 2024</ref>. Always update to the latest version.
 
# Download and install the latest installer (VRCX_Setup.exe) from [https://github.com/vrcx-team/VRCX/releases/latest here].
# Beta/nightly build available [https://vrcx.app/github/nightly here,] or in-app: Settings -> General -> Change build.
# Linux users can read a guide to run a compatible version on their operating system, [https://github.com/vrcx-team/VRCX/wiki/Running-VRCX-on-Linux here].
# For Android users, there are similar alternatives for VRCX available, such as [https://github.com/Nyabsi/VRCAA VRCAA].
 
==Configuration and launch parameters==
===Launch parameters===
{| class="wikitable"
|-
| --debug
|Launch Chromium DevTools with VRCX.
|-
| --config="C:\VRCX"
|Set a custom path for VRCX's config folder. Default: %appdata%\VRCX
|-
| --proxy-server="127.0.0.1:8080"
|Set a HTTP/SOCKS proxy server for VRCX to use.
|}
 
===Protocol/Launch commands===
{| class="wikitable"
|-
|vrcx://user/usr_id
|Open VRCX user dialog.
|-
|vrcx://avatar/avtr_id
|Open VRCX avatar dialog.
|-
| vrcx://group/grp_id
|Open VRCX group dialog.
|-
|vrcx://world/wrld_id
|Open VRCX world dialog.
|-
|vrcx://world/wrld_id:12345
|Open VRCX world dialog with instance.
|-
|vrcx://world/https://vrch.at/0gmbxjpj<nowiki/>
|Open VRCX world dialog with unlocked instance.
|-
|vrcx://import/avatar/avtr_id,avtr_id...
|Open VRCX avatar favorites import dialog.
|-
| vrcx://import/world/wrld_id,wrld_id...
|Open VRCX world favorites import dialog.
|-
|vrcx://import/friend/usr_id,usr_id...
|Open VRCX friend favorites import dialog.
|-
|vrcx://addavatardb/https://website/vrcx_search.php<nowiki/>
|Open VRCX remote avatar database provider dialog.
|}
 
===VRCX.json===
 
* VRCX_DatabaseLocation set a custom path for SQLite database, e.g. C:\\VRCX.sqlite3
**NOTE when moving your VRCX.sqlite3 database be sure to move VRCX.sqlite3-shm and VRCX.sqlite3-wal as well, if they exist.
** NOTE be sure to replace every backslash in the path with 2 backslashes to insure the JSON is valid.
* VRCX_ProxyServer set a HTTP/SOCKS proxy server for VRCX to use, e.g. 127.0.0.1:8080
 
==Gallery==
<gallery widths="225" heights="170">
File:VRCX_Login1.webp|Login Screen
File:VRCX_Login2.webp|2FA Supported
File:VRCX_Feed.webp|Feed Screen
File:VRCX_GameLogs.webp|Game Log Screen
File:VRCX_User_Info.webp|User Info (Own)
File:VRCX_Friend_Info.webp|User Info (Friends)
File:VRCX_World1.webp|World Info (Instance Tab)
File:VRCX_World2.webp|World Info (Info Tab)
File:VRCX_Favorite_Friend.webp|Favorite (Friends)
File:VRCX_Favorite_World.webp|Favorite (Worlds)
File:VRCX_Favorite_Avatar.webp|Favorite (Avatars)
File:VRCX_Friend_Log.webp|Friend Log
File:VRCX_discord_presence.webp|Discord Rich Presence
</gallery>
 
==See also==
*[[Community:VRCNext|VRCNext]]
*[[Community:Manage VRChat|Manage VRChat]]
*[[VRChat API]]
 
==References==
{{reflist}}
 
[[Category:English]]
[[Category:French]]
[[Category:Japanese]]
[[Category:Chinese]]
[[Category:Italian]]
[[Category:Russian]]
[[Category:Spanish]]
[[Category:Polish]]
[[Category:Third-party applications]]
[[Category:Resources]]
[[Category:Assets available via GitHub]]

Latest revision as of 01:12, 6 April 2026

V · ECommunity-written content
The following was created by the community. It may contain material not directly endorsed by the VRChat team. To learn more, consider reading Contributing to the VRChat Wiki.
V · EThird-party API application
This application uses the VRChat API and may require your VRChat account credentials. VRChat, Inc. advises against sharing credentials with third-party applications that do not use official SSO authentication. See VRChat's Creator Guidelines for details.

VRCX is a VRChat-focused open-source third-party application for Windows, Linux, and macOS, which provides a graphical user interface (GUI) for interacting with VRChat via the VRChat API.

Features

Friends and social

  • Manage friends list and organize friend lists outside of VRChat.
  • Track friends' online status, world activities, and avatar changes.
  • Log when friends were added, when last seen, and time spent together in worlds.
  • Monitor name changes and store personal notes to remember how you met.
  • View mutual friends and groups on user profiles, with an interactive graph visualization.
  • Invite multiple friends to an instance at once using a searchable dialog that shows who is already present.

Worlds and instances

  • Organize world and group lists outside of VRChat.
  • Search for worlds by name, ID, or URL.
  • Create and manage a custom local list of favorite worlds (unrestricted).
  • View statistics and player details for the current instance.

Avatars

  • Search for avatars using configurable external databases.
  • Upload and edit images for avatars and worlds without Unity.
  • Edit and update uploaded avatar or world details (name, description, tags) directly through VRCX, without Unity.

Groups

  • Create group instances (Group, Group+, Group Public) with role-based access, queue, and age gate options.
  • Create and browse group posts with role-based visibility.
  • Browse group photo galleries.
  • Manage group members, roles, and moderation actions.
  • Export group moderation logs as CSV.
  • Export or import favorite groups.
  • Browse upcoming events in a monthly group calendar view.

Profile

  • Edit status with saved presets for quick switching between status and description combinations.
  • Edit bio, social links, and pronouns.
  • Change profile picture via image upload.

Notifications

  • Send and receive invites and friend requests directly from VRCX.
  • View instance details of invitations received.

Media and photos

  • Keep track of the worlds where in-game photos were taken.

Integration and utilities

  • Automatically open companion apps (e.g. OSC tools, voice changers) when VRChat launches.
  • Store settings, saved states, inventories, and other persistent data for supported worlds (World Persistence / PWI).
    • Note: VRCX's world persistence is unrelated to VRChat's official world persistence. Requires "Allow Untrusted URLs" in VRChat settings. For developers, see World Persistence (PWI) by VRCX.
  • Display detailed information about the current instance in Discord, including thumbnails, names, instance IDs, player counts, and a join button for public lobbies (Enhanced Discord Rich Presence).
  • Access a configurable VR overlay with live notifications and supported event feeds.
  • Automatically re-launch VRChat and rejoin the last instance if it crashes.
  • View video links and related data for videos playing in the current world.

Keyboard shortcuts

  • Ctrl + Shift + I open Chromium DevTools.
  • Ctrl + R restart VRCX.
  • Shift + Alt + R reload custom css.

Getting started

Using outdated versions of VRCX may expose you to security vulnerabilities, including remote code execution[1]. Always update to the latest version.

  1. Download and install the latest installer (VRCX_Setup.exe) from here.
  2. Beta/nightly build available here, or in-app: Settings -> General -> Change build.
  3. Linux users can read a guide to run a compatible version on their operating system, here.
  4. For Android users, there are similar alternatives for VRCX available, such as VRCAA.

Configuration and launch parameters

Launch parameters

--debug Launch Chromium DevTools with VRCX.
--config="C:\VRCX" Set a custom path for VRCX's config folder. Default: %appdata%\VRCX
--proxy-server="127.0.0.1:8080" Set a HTTP/SOCKS proxy server for VRCX to use.

Protocol/Launch commands

vrcx://user/usr_id Open VRCX user dialog.
vrcx://avatar/avtr_id Open VRCX avatar dialog.
vrcx://group/grp_id Open VRCX group dialog.
vrcx://world/wrld_id Open VRCX world dialog.
vrcx://world/wrld_id:12345 Open VRCX world dialog with instance.
vrcx://world/https://vrch.at/0gmbxjpj Open VRCX world dialog with unlocked instance.
vrcx://import/avatar/avtr_id,avtr_id... Open VRCX avatar favorites import dialog.
vrcx://import/world/wrld_id,wrld_id... Open VRCX world favorites import dialog.
vrcx://import/friend/usr_id,usr_id... Open VRCX friend favorites import dialog.
vrcx://addavatardb/https://website/vrcx_search.php Open VRCX remote avatar database provider dialog.

VRCX.json

  • VRCX_DatabaseLocation set a custom path for SQLite database, e.g. C:\\VRCX.sqlite3
    • NOTE when moving your VRCX.sqlite3 database be sure to move VRCX.sqlite3-shm and VRCX.sqlite3-wal as well, if they exist.
    • NOTE be sure to replace every backslash in the path with 2 backslashes to insure the JSON is valid.
  • VRCX_ProxyServer set a HTTP/SOCKS proxy server for VRCX to use, e.g. 127.0.0.1:8080

Gallery

See also

References

  1. VR Overlay RCE on GitHub; retrieved September 23, 2024