{"id":29423752,"url":"https://github.com/ravmda/vrc-manager","last_synced_at":"2025-07-12T08:02:14.446Z","repository":{"id":303945371,"uuid":"994341976","full_name":"RavMda/vrc-manager","owner":"RavMda","description":"Automatic VRChat Group Management Utility","archived":false,"fork":false,"pushed_at":"2025-07-10T08:36:44.000Z","size":37,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-10T17:04:42.082Z","etag":null,"topics":["discord-webhook","serenity-rs","vrchat","vrchat-api","vrchat-tool","vrchatapi"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RavMda.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-01T18:25:27.000Z","updated_at":"2025-07-10T09:00:44.000Z","dependencies_parsed_at":"2025-07-10T17:05:02.799Z","dependency_job_id":"b3a578bf-7f94-4da3-93cc-418a191ca611","html_url":"https://github.com/RavMda/vrc-manager","commit_stats":null,"previous_names":["ravmda/vrc-manager"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/RavMda/vrc-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RavMda%2Fvrc-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RavMda%2Fvrc-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RavMda%2Fvrc-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RavMda%2Fvrc-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RavMda","download_url":"https://codeload.github.com/RavMda/vrc-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RavMda%2Fvrc-manager/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264958584,"owners_count":23689035,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["discord-webhook","serenity-rs","vrchat","vrchat-api","vrchat-tool","vrchatapi"],"created_at":"2025-07-12T08:00:42.223Z","updated_at":"2025-07-12T08:02:14.425Z","avatar_url":"https://github.com/RavMda.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VRCManager - Automated VRChat Group Management Utility\n\n![License](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg)\n\nAutomate group moderation and management tasks in VRChat through real-time log monitoring.\n\n## Key Features\n\n- 🕵️‍♂️ Real-time monitoring of VRChat log files\n- 🔒 Secure authentication with 2FA support\n- 🧾 Persistent cookie storage for seamless logins\n- 🚫 Automatic group banning of users with prohibited avatars\n- 📬 Automatic group invites\n- ⚙️ Customizable through a simple configuration file\n- 🎮 Discord webhook integration for real-time notifications\n\n## How Automatic Bans Work\n\n1. Monitors VRChat's latest log file for player join events\n2. Extracts user IDs from log entries\n3. Fetches user's current avatar via VRChat API\n4. Checks avatar against your blocklist (`avatars.txt`)\n5. Automatically bans users with prohibited avatars from your group\n\n## Download Pre-Built Binaries\n\nPre-built binaries are available for download on the [Releases page](https://github.com/RavMda/vrc-manager/releases).\n\n## Configuration\n\n### 1. Create config file (`config.toml`)\n```toml\ngroup_id = \"grp_f0db2b50-9440-4e8f-bd09-75870a423dd7\"\nlog_avatar_id = true\navatars_file = \"avatars.txt\"                          # optional\ncustom_log_dir = \"/home/whatever/something/vrchat\"    # optional\n\n[auto_invite]\nenabled = true\ndelay_min = 240  # seconds\ndelay_max = 360 # seconds\n\n[auto_ban]\nenabled = true\n\n[discord_webhook]\nenabled = true\nusername = \"github.com/RavMda/vrc-manager\"\navatar_url = \"https://i.imgur.com/KTs6whd.jpg\"\nurl = \"https://discord.com/api/webhooks/01234567890123456789/ABCDEFGHIJKLMNOPQRSTUVWXYZ012345\"\nlog_on_player_joined = true\nlog_on_player_left = true\nlog_on_avatar_changed = true\nlog_on_auto_invite = true\nlog_on_auto_ban = true\n```\n\n### 2. Create avatar file id blocklist (if automatic banning is used)\nModify existing `avatars.txt` (or your custom-named file) with one avatar file ID per line:\n```\nfile_12345678-90ab-cdef-1234-567890abcdef\nfile_aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee\n```\n\n## Building from Source\n\n```bash\n# Clone the repository\ngit clone https://github.com/RavMda/vrc-manager.git    \ncd vrc-manager\n\n# Build the project\ncargo build --release\n\n# The binary will be available at \"target/release\" folder\n\n# Or, you can just simply run it\ncargo run --release\n```\n\n## Important Notes\n- **Rate Limits**: VRChat API has rate limits - use responsibly\n- **Log Format**: Depends on VRChat's current log format (may need updates)\n\n## Contributing 🤝\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/fooBar`)\n3. Commit your changes (`git commit -am 'Add some fooBar'`)\n4. Push to the branch (`git push origin feature/fooBar`)\n5. Create a new Pull Request\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fravmda%2Fvrc-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fravmda%2Fvrc-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fravmda%2Fvrc-manager/lists"}