Skip to content

Commit e4f9b52

Browse files
meizhong986claude
andcommitted
docs: add v1.8.11 release notes
Release notes for WhisperJAV v1.8.11, modeled on the v1.8.10 GitHub release body for consistency with recent releases. Content summary: - Subtitle Sanitization: single-line mention of Japanese SRT sanitizer hardening (#287). Developer-level detail (root cause regex slice syntax, symbol-only residue drop, CPS newline handling, SDH patterns) is intentionally omitted per user feedback — users are not developers. - Ollama: curated model list update replacing a chain-of-thought model that broke translation format, and new --ollama-max-tokens flag for output-length tuning (#271). - Colab: --provider local translation fix — missing [llm] extra in install_colab.sh was causing ModuleNotFoundError starlette_context on startup (#291). - Known Issue: Windows standalone installer does not add its bundled Library\bin (with ffmpeg 7.1) to the user PATH, so a third-party ffmpeg on PATH (e.g. 8.x) may be resolved instead of the bundled build when subprocesses run outside the GUI launcher. Workaround and planned v1.8.12 fix are documented. - Compatibility table, What's Next section, and install instructions for Windows .exe / macOS / Linux / Windows source mirror the v1.8.10 structure so existing users follow a familiar upgrade path. Saved to installer/RELEASE_NOTES_v*.md following the convention used for v1.8.7 through v1.8.10.post3. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 10f5b13 commit e4f9b52

1 file changed

Lines changed: 141 additions & 0 deletions

File tree

installer/RELEASE_NOTES_v1.8.11.md

Lines changed: 141 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,141 @@
1+
**Sanitizer hardening + small fixes**
2+
The Japanese SRT sanitizer is more robust. Two smaller issues with Colab
3+
install and Ollama translation are also fixed.
4+
5+
---
6+
7+
8+
Subtitle Sanitization
9+
10+
- Hardening of the Japanese SRT sanitization. (#287)
11+
12+
13+
Ollama
14+
15+
- **Curated model list + output length control** — one model in the
16+
curated list emitted chain-of-thought text that broke the translation
17+
format; replaced with an instruct-tuned equivalent. Also added
18+
`--ollama-max-tokens` so output length can be tuned for setups that
19+
need a different default. (#271)
20+
21+
22+
Colab
23+
24+
- **`--provider local` translation on Colab** — the `[llm]` extra was
25+
missing from `install_colab.sh`, causing
26+
`ModuleNotFoundError: starlette_context` when starting local LLM
27+
translation. The extra is now installed. (#291)
28+
29+
---
30+
31+
### How to Upgrade or Install
32+
33+
**Upgrade from 1.8.10:**
34+
35+
```
36+
pip install -U --no-deps "whisperjav @ git+https://github.com/meizhong986/whisperjav.git@v1.8.11"
37+
```
38+
39+
**Fresh Install:**
40+
41+
### Windows — Standalone Installer (.exe)
42+
43+
44+
1. Download **WhisperJAV-1.8.11-Windows-x86_64.exe** from the Assets below
45+
2. Run the installer (no admin rights required)
46+
3. Wait 10-20 minutes for setup to complete
47+
4. Launch from the Desktop shortcut
48+
49+
Installs to `%LOCALAPPDATA%\WhisperJAV`. A desktop shortcut is created automatically. Your GPU is detected automatically.
50+
51+
### macOS
52+
53+
Requires [Git](https://git-scm.com/downloads). The install script checks for everything else (Xcode CLI Tools, Python, FFmpeg, PortAudio) and tells you exactly what to install if anything is missing. Open Terminal and run:
54+
55+
```bash
56+
cd ~
57+
git clone https://github.com/meizhong986/whisperjav.git
58+
cd whisperjav
59+
git checkout v1.8.11
60+
installer/install_mac.sh
61+
```
62+
63+
After installation, open the `whisperjav` folder in Finder and double-click **WhisperJAV.command** to launch the GUI.
64+
65+
### Linux
66+
67+
Requires Git and Python 3.10-3.12. The install script handles PEP 668 (externally-managed) environments on Debian 12+ / Ubuntu 24.04+. Open a terminal and run:
68+
69+
```bash
70+
cd ~
71+
git clone https://github.com/meizhong986/whisperjav.git
72+
cd whisperjav
73+
git checkout v1.8.11
74+
installer/install_linux.sh
75+
```
76+
77+
After installation, launch the GUI with `./WhisperJAV.sh`.
78+
79+
### Windows — Source Install
80+
81+
Requires [Git](https://git-scm.com/downloads) and [Python 3.10-3.12](https://www.python.org/downloads/). Open a terminal and run:
82+
83+
```
84+
cd %USERPROFILE%
85+
git clone https://github.com/meizhong986/whisperjav.git
86+
cd whisperjav
87+
git checkout v1.8.11
88+
installer\install_windows.bat
89+
```
90+
91+
After installation, double-click **WhisperJAV.bat** to launch the GUI.
92+
93+
94+
95+
96+
## Compatibility
97+
98+
Same as v1.8.10 — no dependency changes.
99+
100+
| Component | Supported Versions |
101+
|-----------|-------------------|
102+
| Python | 3.10, 3.11, 3.12 |
103+
| PyTorch | 2.4.0 - 2.10.x |
104+
| CUDA | 11.8+ (12.4+ recommended) |
105+
| Ollama | 0.3.0+ recommended |
106+
107+
## Known Issues
108+
109+
- **Windows standalone installer does not add its bundled tools to user PATH.**
110+
WhisperJAV ships its own ffmpeg 7.1 (pinned `>=6,<8`) inside the install
111+
directory's `Library\bin`, but the installer does not persistently add
112+
that folder to the user's PATH. If you have a separate ffmpeg on your
113+
PATH — especially ffmpeg 8.x — WhisperJAV subprocesses that run outside
114+
the GUI launcher may resolve to that other ffmpeg instead of the bundled
115+
one. Behavior can be unexpected if the third-party ffmpeg has different
116+
default flags or filter names. Workaround: launch via the Desktop
117+
shortcut (which activates the environment) or manually add
118+
`<install-dir>\Library\bin` to your user PATH. A proper fix is planned
119+
for v1.8.12.
120+
121+
- **Apple Silicon MPS + whisper-large-v3-turbo** — produces garbage output
122+
on MPS for this specific model. Use `--hf-device cpu` or the default
123+
kotoba model. (#198, #227)
124+
125+
- **Ollama download progress** — the download progress bar in the popup is
126+
indeterminate (pulsing). Real progress is shown in the terminal. A hint
127+
in the popup directs you to check there.
128+
129+
## What's Next
130+
131+
**v1.8.12** — installer PATH fix (above), a ZipEnhancer Colab init bug
132+
(#290), Qwen3-ASR `transformers` version pin (#280), and verification of
133+
the Colab fix in this release.
134+
135+
**v1.9.0** — full Ollama migration (remove llama-cpp-python), standalone
136+
subtitle merge CLI (#230), Chinese GUI partial i18n (#175, #180), speaker
137+
diarization (#248, #252).
138+
139+
---
140+
141+
Thanks to everyone who reported issues and tested on their own material.

0 commit comments

Comments
 (0)