Skip to content

Manual Rollback Guide

If an upgrade fails or causes issues, follow these steps to restore WhisperJAV to a working state.

Quick Reference

Scenario Solution
Upgrade failed mid-way Option A: Reinstall specific version
New version has bugs Option A: Reinstall specific version
Complete corruption Option B: Fresh install
Can't run Python at all Option B: Fresh install

Option A: Reinstall Specific Version

Use this if Python still works but WhisperJAV is broken.

Step 1: Open Command Prompt

  1. Press Win + R
  2. Type cmd and press Enter

Step 2: Navigate to WhisperJAV

cd %LOCALAPPDATA%\WhisperJAV

Step 3: Reinstall the version you want

To reinstall latest stable: 

python.exe -m pip install --force-reinstall git+https://github.com/meizhong986/whisperjav.git@main

To install a specific version (e.g., v1.7.3): 

python.exe -m pip install --force-reinstall git+https://github.com/meizhong986/whisperjav.git@v1.7.3

Available version tags: - v1.7.4 - Latest - v1.7.3 - Previous stable - v1.7.2, v1.7.1, v1.7.0 - Older versions

Step 4: Verify installation

python.exe -c "from whisperjav import __version__; print(__version__)"

Option B: Fresh Install

Use this if the Python environment is completely broken.

Step 1: Uninstall WhisperJAV

  1. Open Settings → Apps → Apps & features
  2. Search for "WhisperJAV"
  3. Click Uninstall

Or manually delete: 

rmdir /s /q "%LOCALAPPDATA%\WhisperJAV"

Step 2: Download fresh installer

Go to WhisperJAV Releases and download the latest .exe installer.

Step 3: Run the installer

The installer will create a fresh environment with all dependencies.

Preserving Your Data

Your AI models and cache are stored separately and survive reinstallation:

Data Location Preserved?
Whisper models ~/.cache/whisper/ Yes
HuggingFace models ~/.cache/huggingface/ Yes
WhisperJAV config %LOCALAPPDATA%\WhisperJAV\whisperjav_config.json Deleted on uninstall

To preserve config before uninstall: 

copy "%LOCALAPPDATA%\WhisperJAV\whisperjav_config.json" "%USERPROFILE%\Desktop\"

Common Issues

"pip is not recognized"

Your PATH is not set correctly. Use the full path: 

%LOCALAPPDATA%\WhisperJAV\python.exe -m pip install ...

"Permission denied"

Close all WhisperJAV windows and try again. If still failing: 1. Open Task Manager (Ctrl+Shift+Esc) 2. End any python.exe or pythonw.exe processes from WhisperJAV 3. Try the command again

"Network error"

Check your internet connection. If behind a proxy: 

set HTTPS_PROXY=http://your-proxy:port
python.exe -m pip install ...

Getting Help

If none of the above works:

  1. Open an issue at GitHub Issues
  2. Include:
  3. What you were doing when it broke
  4. Error messages (screenshot or copy-paste)
  5. Windows version
  6. Output of: python.exe --version