https://github.com/itsalphaneon/vrcachemanager
A GUI utility for managing, archiving, and hotswapping worlds for those who hate EAC.
https://github.com/itsalphaneon/vrcachemanager
archive cache gui python vrchat
Last synced: about 2 months ago
JSON representation
A GUI utility for managing, archiving, and hotswapping worlds for those who hate EAC.
- Host: GitHub
- URL: https://github.com/itsalphaneon/vrcachemanager
- Owner: ItsAlphaNeon
- Created: 2024-12-17T02:57:57.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-01-14T19:01:01.000Z (4 months ago)
- Last Synced: 2025-01-14T20:07:41.500Z (4 months ago)
- Topics: archive, cache, gui, python, vrchat
- Language: Python
- Homepage:
- Size: 85 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# VRCacheManager
VRCacheManager is a tool designed to manage VRChat cache files, allowing you to rename, delete, view information, and replace the ErrorWorld.
This project is intended for individuals who wish to view VRChat worlds without running Easy Anti-Cheat (EAC) or those who want to preserve their favorite worlds.
## Features
- **Rename Files**: Rename cache files for better organization.
- **Delete Files**: Delete unwanted cache files.
- **View File Information**: View detailed information about cache files.
- **Replace Error World**: Replace the ErrorWorld with a custom world, allowing you to view worlds without EAC.
- **Monitor Cache Directory**: Automatically detect new files in the VRChat cache directory.
- **Launch VRChat**: Launch VRChat directly from the application.
- **API Integration**: Fetch world data from the VRChat API.
## Releases
Pre-release binaries are available on the [GitHub releases page](https://github.com/ItsAlphaNeon/VRCacheManager/releases).
You can also build your own binaries with the included Batch file in the Repository.
## Installation
1. Clone the repository:
```sh
git clone https://github.com/ItsAlphaNeon/VRCacheManager.git
```
2. Navigate to the project directory:
```sh
cd VRCacheManager
```
3. Install the required dependencies:
```sh
pip install -r requirements.txt
```
## Usage
1. Run the application:
```sh
python main.py
```
2. Use the UI to manage your VRChat cache files.
## Dependencies
- Python 3.10+
- PyQt6
- watchdog
- requests
- BeautifulSoup4
- vrchatapi
## File Structure
- `main.py`: Entry point of the application.
- `archive_manager.py`: Contains the main UI and logic for managing cache files.
- `recordmanager.py`: Handles reading and writing records to a JSON file.
- `cache_event_handler.py`: Monitors the cache directory for new files.
- `asset_bundle_manager.py`: Manages asset bundle files.
- `worlddata.py`: Fetches world data from the web.
- `README.md`: Project documentation.
## Contributing
Contributions are not currently accepted for this project. Sorry!
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Acknowledgements
- [PyQt](https://riverbankcomputing.com/software/pyqt/intro) for the UI framework.
- [watchdog](https://github.com/gorakhargosh/watchdog) for file system event monitoring.
- [vrchatapi](https://github.com/vrchatapi/vrchatapi-python) for interfacing with the VRChat API.