Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Nyxall's VRCX — a companion app for VRChat

Run VRChat groups without living on the website.

Everything upstream VRCX does — friends, worlds, game log, VR overlay — plus thirteen group-moderation tools built for people who actually run instances.

Latest release Downloads Platform License

Windows installer · portable zip · Linux AppImage · macOS dmg Signing in requires an access key — see Access

Who it's for · What you get · Install · Docs · Changelog · Support


This is not official VRCX

Nyxall's VRCX is an independently maintained, heavily customized derivative of VRCX (MIT). It is not affiliated with, endorsed by, or supported by the VRCX project or the VRCX team — they did not build it and cannot support it, so please report issues here, never on their tracker or their Discord.

Upstream VRCX is excellent software and this project would not exist without it — full credit in Upstream attribution.


What you get

Thirteen tools, added on top of everything upstream VRCX already does, shipped together in a single Nyxall's Tools folder in the sidebar:

Diagram of the thirteen Nyxall's Tools, grouped into instances, groups, people, accounts, and maintenance

Who it's for

If you don't run a VRChat group, you probably want upstream VRCX instead — it is open to everyone, supported by a team, and tested far more widely. This project exists for one specific job.

It's for you if you run groups or instances and you are tired of:

The problem What this does about it
Alt-tabbing to the VRChat website to manage every group post, role, event or ban Group Manager — do all of it in the app
Inviting hundreds of members by hand, hitting rate limits, losing your place Group Invitation Manager — a real queue with membership pre-checks, permission awareness, retries and rate limiting
Banning raiders one at a time while an instance is actively being disrupted Group Ban Manager — bulk import, role grouping, and same-avatar filtering to catch a ban-evading group at once
Not knowing who just walked into your instance until something goes wrong Instance Monitor — live roster with trust ranks, join times, platform, moderation history and avatar-blacklist alerts
Logging in and out repeatedly to run moderation from a second account Account Launcher + bulk importer — handles inline 2FA and never interrupts your active session
Digging through raw logs to reconstruct what happened Logs Dashboard — searchable and structured

What you give up

  • No upstream support. The VRCX team did not build this and cannot help you with it.
  • One maintainer, no SLA. Upstream has a team and a far larger user base finding bugs.
  • Fewer eyes on the code. A fork this heavily modified carries more risk than its upstream.

If those matter more to you than the tools above, use upstream. That is a legitimate answer.

Compared with upstream VRCX

Upstream VRCX Nyxall's VRCX
Friends, worlds, game log, VR overlay, Discord Rich Presence, notifications, crash recovery
The thirteen group-moderation tools above
Mobile companion app 🚧 in development
Windows runtime CefSharp CefSharp
Linux · macOS builds ✅ less tested
Open registration ❌ access key required

"—" means outside upstream's scope, not a shortcoming. Upstream is a general-purpose tool and is deliberately broader; these rows describe this fork's additions, not gaps in upstream's design.

The full list of inherited upstream features
  • Friend, world, group and avatar list management outside the game
  • Friend activity and online-status monitoring; first-seen / last-seen tracking; time-together statistics; name-change history; per-friend notes
  • Search across avatars, users, worlds and groups
  • Unrestricted local world favorites
  • World metadata written into in-game screenshots
  • Notification monitoring and response — send and receive invites and friend requests
  • Current-instance statistics and player list
  • Configurable VR overlay with a live event feed
  • Enhanced Discord Rich Presence
  • Auto-launch of companion applications when VRChat starts
  • Auto-restart and rejoin after a VRChat crash

Download and install

Every release publishes six assets on the Releases page. Grab the one for your platform, run it, and launch Nyxall's VRCX.

Important

An access key is required to sign in. This build is not open-registration — installing it without a key gets you as far as the login screen and no further. See Access.

Platform Asset Notes
Windows VRCX_<version>_Setup.exe Recommended
Windows (portable) VRCX_<version>.zip No installer — unzip and run
Linux VRCX_<version>_x64.AppImage
VRCX_<version>_arm64.AppImage
chmod +x, then run
macOS VRCX_<version>_x64.dmg
VRCX_<version>_arm64.dmg
Pick the build matching your chip

Caution

This application shares its data directory (%APPDATA%\VRCX) and its vrcx:// protocol registration with upstream VRCX. Running both on the same machine is not supported — install one or the other.

Windows is the primary platform; Linux and macOS are published every release but receive less testing. If Windows SmartScreen shows an "unrecognized publisher" prompt, choose More info → Run anyway only if you trust where you got the file.

Access

Signing in requires an access key issued by the maintainer. If you do not already have one, or do not already know how to request one, this build is not currently open to you.

Access keys are not issued through the issue tracker — please don't open an issue asking for one.

Requirements

Operating system Windows 10 or 11 (x64) · Linux (x64 / arm64) · macOS (x64 / arm64)
VRChat An active VRChat account
Access key Required to sign in — see Access
Runtime Bundled — no separate .NET or Node.js installation is needed to run the app
Disk ~1 GB for the application; the local database grows with your history
VR overlay SteamVR (optional — the app runs fine in desktop-only mode)

Updating

The application checks for new releases on startup and tells you when one is available. Updates are downloaded from this repository's Releases page and installed in place; your data is preserved.

If an update fails, download the latest installer manually from the Releases page and run it over your existing installation.

Troubleshooting

The app won't start, or shows a blank window

Check the log in %APPDATA%\VRCX\. Attach it to a bug report — after removing your account email and your friends' names and user IDs.

Login fails with a 401 or "connection issues"

This usually means VRChat's API rejected the session. Log out fully, close the app, and log in again. If it persists, check whether you can log in at vrchat.com.

Two-factor codes are rejected

Confirm your system clock is accurate — TOTP is time-sensitive.

Friend list or game log is empty

The game log is parsed from VRChat's own output logs. If VRChat is installed somewhere non-default, set the correct path in Settings.

The VR overlay does not appear

Start SteamVR before the app, and confirm the overlay is enabled in Settings.

Something else

Open an issue with your version number (Settings → System), your OS, and the relevant log. Please do not open it on the upstream VRCX repository.

Project status

Actively maintained. Releases are cut from this repository on a rolling, date-stamped version scheme — for example 2026.08.11b, where a higher version is always the newer one.

Area Status
Windows Primary platform — built and tested first; ships as an installer and a portable zip
Linux · macOS Published every release, but receive less testing
VR overlay Supported; SteamVR optional
Mobile companion app In development — pairs with the desktop app over your LAN. Not finished, not yet recommended for general use
Registration Closed — see Access
Source code Closed — this repository distributes compiled builds only

This is a personal project, not a commercial product, and it is not open source — the source code and build system are private. This repository distributes the compiled application, its documentation, and its issue tracker. There is no SLA. See SUPPORT.md for what support looks like in practice.

Documentation

Guide For
Documentation index Start here — everything below, organized
Support Where to ask, and what to include
Security policy Reporting a vulnerability privately
Code of conduct Everyone
Changelog What changed, per release

Releases and changelog

Every release is published on the Releases page with notes describing what changed for you, not for the code. The same history — in more detail, and further back — lives in CHANGELOG.md.

Entries are grouped Added / Changed / Fixed / Removed, newest first, and each one leads with a plain-language summary of what it means in the app. If a release requires you to do something differently, that is called out in its entry.

Issues and feedback

Bug reports and feature requests are very welcome — use the issue forms.

Nyxall's VRCX is not open source, and this repository distributes compiled builds only. Source code is maintained privately, so pull requests cannot be accepted — there is nothing here to patch against. That is not a reflection on anyone offering.

Support questions are covered by SUPPORT.md; security reports by SECURITY.md.

By participating you agree to the Code of Conduct.

Upstream attribution

This project is derived from VRCX, created by pypy and maintained by the VRCX team and its contributors, licensed under the MIT License.

Substantial portions of this codebase are upstream VRCX code, retained under that license. The original copyright notice is preserved verbatim in LICENSE and is reproduced in every distributed build. Third-party component licenses are listed in Dotnet/build-tools/LICENSES.txt.

Upstream is also credited inside the application itself, in Settings → System, which links to the upstream repository and its contributor list.

Please direct thanks, stars, and support to the upstream project.

License

See LICENSE for the terms covering this application, the retained upstream VRCX MIT notice, and the third-party components redistributed with it.

Disclaimers

Nyxall's VRCX is not affiliated with, endorsed by, or supported by the VRCX project or the VRCX team.

Nyxall's VRCX is not endorsed by VRChat and does not reflect the views or opinions of VRChat or anyone officially involved in producing or managing VRChat. VRChat and all associated properties are trademarks or registered trademarks of VRChat Inc. VRChat © VRChat Inc.

This application is an external tool. It uses the VRChat API and does not modify the game.

Translations

Note

These translations were inherited from upstream and describe upstream VRCX. They have not been updated for this project, and nothing in them should be taken as describing this application.

Español · Français · Magyar · Italiano · 日本語 · Polski · Русский · ไทย · 简体中文

About

An independently maintained, heavily customized VRCX-derived companion app for VRChat — friend tracking, instance monitoring, and group-moderation tooling. Not affiliated with upstream VRCX.

Topics

Resources

Code of conduct

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors