VRChat Log Parser and Automation tool to help moderators manage trouble makers in VRChat since VRChat Management Team is not taking moderation seriously; ever.
Tailgrab will read the VRChat Local Game Log files in real time, parse them for events and then trigger actions based on the configuration of the application. The application is designed to be flexible and allow for a wide range of actions to be triggered based on the events that are parsed from the VRChat logs and alert the user to elements that may be less than honest.
- Shows a live feed of user in the current instance with their VRChat Avatar and UserID
- When in Furry Hideout, shows user's usage of Furry Hideout Pens
- Quick view of the user's historical avatar, pen, print, emoji and sticker usage in the current instance.
- AI powered insights on user Profile content.
- Quick reporting of User's Profile to the in game moderation instance
- AI powered insights on user Image Assets used.
- Quick reporting of User's Images to the in game moderation instance
- Copy Button that copies the user's VRChat User Id, Display name, Instance Stats and historical activity for pasting into your favorite moderation toolset.
- Avatar Flagging based on user directed database.
- Group Flagging based on user directed database.
- Historical tracking of User elapsed time seen from your usage of the application.
- Trigger actions based on VRChat log events of "Vote To Kick" or "Group Moderation Action (Kick/Warn)", such as sending OSC Avatar Parameters, sending keystrokes to other applications, etc.
Note
I am learing how to build a Installer for the appliction, but for now you will need to download the latest release and extract the zip file to a location of your choice on your Windows machine. Then you can run the tailgrab.exe application to start monitoring your VRChat instance.
- Download the latest release of TailGrab from the Latest Release page.
- Extract the downloaded zip file to a location of your choice on your Windows machine.
- Run the
tailgrab.exeapplication to start monitoring your VRChat instance.
- Download the latest release of TailGrab from the Latest Release page.
- Extract the downloaded zip file to a location of your choice on your Windows machine, but avoid overwriting your existing configuration & data files. ./config.json ./pen-network-id.csv ./sounds/* ./data/*
- Run the
tailgrab.exe -upgradeapplication to start any database upgrades. - Configure any new Secrets and other configuration values that may be needed for new features added since your last version.
- Restart the application with
tailgrab.exeto start monitoring your VRChat instance with the new version of TailGrab.
Application Config for details on how to configure the application to connect to API services.
Config Line Handlers for details on how to configure the application to respond to VRChat local game log events.
Click the windows application or open a Powershell or Command Line prompt in your windows host, change directory to where tailgrab.exe has been extracted to and start it with:
.\tailgrab.exe
Or if you have moved where the VR Chat output_log_*.txt are located; then:
.\tailgrab.exe -l {full path to VR Chat logs ending with a \}
If you need to clear all registry settings stored for TailGrab, you can run:
.\tailgrab.exe -clear
This will remove all stored configuration and secret values from the Windows Registry for TailGrab, you can then reconfigure the application as needed, save them, restart and get back to watching the instance.
By default TailGrab will look for VRChat log files in the default location of:
YourUserHome\AppData\LocalLow\VRChat\VRChat\
This can be overridden by passing the full path to the VRChat log files as the first argument to the application.
.\\tailgrab.exe D:\MyVRChatLogs\
The TailGrab application will log it's internal operations to the ./logs folder in the same directory as the application executable. Each run of the application will create a new log file with a timestamp in the filename.
If you want to watch the application logs in real time, you can use a tool like tail from Git Bash or Get-Content from Powershell session with the log filename.
Get-Content -Path .\logs\tailgrab-2026-01-26.log -wait
DB Browser for SQLite - https://sqlitebrowser.org/
Active Players Current Players in the Instance.
Past Players Players that have been in the instance since you started TailGrab for the last 15 minutes.
Prints Shows Prints that have been spawned into the instance by time/user id.
Emojis & Stickers Shows Emojis and Stickers that have been spawned into the instance by time/user id.
Config Tab, Avatars Mark Avatars for Alerting and Blocking.
Config Tab, Groups Mark Groups for Alerting and Blocking.
Config Tab, Users See user activity you have encountered.
Config Tab, Line Handlers Configure Actions to Trigger based on VRChat Log Events.
Config Tab, Secrets Configure API Keys and other application settings.