Skip to content

CacheCopiator is a toolkit to record and restore web sessions using Chrome. It saves cookies, localStorage, and sessionStorage into a .json file and allows you to replay that session at any time.

Notifications You must be signed in to change notification settings

Jjponvv/cacheCopiator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

14 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ’Ύ CacheCopiator

CacheCopiator is a toolkit to record and restore web sessions using Chrome. It saves cookies, localStorage, and sessionStorage into a .json file and allows you to replay that session at any time.

No Python installation required β€” compiled Windows binaries are included!


βš™οΈ Features

  • πŸ“₯ Record session data from any URL (cookies + storage)
  • πŸ“€ Replay session later using the same browser context
  • πŸ–±οΈ CLI or Windows .exe support (no Python setup needed)
  • πŸ—ƒοΈ Saves to a single JSON file

🧾 File Structure

.
β”œβ”€β”€ bin/                 # Precompiled Windows binaries
β”‚   β”œβ”€β”€ cachr.exe            # Session recorder
β”‚   └── sesp.exe   # Session restorer
β”œβ”€β”€ cachr.py             # Python source (optional)
β”œβ”€β”€ sesp.py    # Python source (optional)
└── README.md

πŸš€ Quick Start (Windows .exe)

1.Download the latest release (CacheCopiatorUtility.zip) and unzip it to any folder.

  1. Add to PATH (optional, for easy access)
    To run cachr.exe and sesp.exe from any terminal window, you can add the bin folder to your system PATH:
  • πŸ”§ How to do it (Windows):
  1. Press Win + R, type sysdm.cpl, press Enter.
  2. Go to Advanced β†’ Environment Variables.
  3. Under System variables, find and select Path, then click Edit.
  4. Click New and paste the full path to the bin folder (e.g., C:\Users\YourName\CacheCopiatorUtility\bin).
  5. Click OK to save.

Now you can run the tools directly from cmd or PowerShell:

cachr --url https://example.com --out session_example.json
sesp --url https://example.com --cache session_example.json

🐍 Running with Python (Optional)

Install requirements:

pip install selenium webdriver-manager

Then:

python cachr.py --url https://example.com --out session_example.json
python sesp.py --url https://example.com --cache session_example.json

πŸ“„ Output Format

Each session is saved as a .json file like this:

{
  "url": "https://example.com",
  "cookies": [ ... ],
  "localStorage": { ... },
  "sessionStorage": { ... }
}

πŸ” Security Note

Session files may contain sensitive authentication tokens. Do not share them. Also in newest update I added incognito mode for pages that pop-up in process.

🀝 Contributing

Pull requests and suggestions are welcome! Fork it and improve it.

πŸ“„ License

MIT License

Made by Jjponvv

About

CacheCopiator is a toolkit to record and restore web sessions using Chrome. It saves cookies, localStorage, and sessionStorage into a .json file and allows you to replay that session at any time.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages