diff --git a/CHANGELOG.md b/CHANGELOG.md index 23d9000..407f25d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,5 @@ -# 1.1.7 (ğre-release) -- Added MPS GPU acceleration support for Silicon Mac, mentioned in https://github.com/denizsafak/abogen/issues/32#issuecomment-3155902040 by @jefro108 +# 1.1.7 +- Added MPS GPU acceleration support for Silicon Mac, mentioned in https://github.com/denizsafak/abogen/issues/32#issuecomment-3155902040 by @jefro108. **Please read the [Mac](https://github.com/denizsafak/abogen?tab=readme-ov-file#mac) section in the documentation again, as it requires additional configuration.** - Added word-by-word karaoke highlighting feature by @robmckinnon in PR #65 - Fixed sleep inhibition error occurring on some Linux systems that do not use systemd, mentioned in #67 by @hendrack - Improvements in code and documentation. diff --git a/README.md b/README.md index cea925a..36c4014 100644 --- a/README.md +++ b/README.md @@ -61,6 +61,10 @@ source venv/bin/activate # Install abogen pip3 install abogen + +# For Silicon Mac (M1, M2 etc.) +# After installing abogen, we need to install Kokoro's development version which includes MPS support. +pip3 install git+https://github.com/hexgrad/kokoro.git ``` ### Linux ```bash @@ -130,7 +134,7 @@ Here’s Abogen in action: in this demo, it processes ∼3,000 characters of tex | **Select Voice** | First letter of the language code (e.g., `a` for American English, `b` for British English, etc.), second letter is for `m` for male and `f` for female. | | **Voice mixer** | Create custom voices by mixing different voice models with a profile system. See [Voice Mixer](#voice-mixer) for more details. | | **Voice preview** | Listen to the selected voice before processing. | -| **Generate subtitles** | `Disabled`, `Sentence`, `Sentence + Comma`, `1 word`, `2 words`, `3 words`, etc. (Represents the number of words in each subtitle entry) | +| **Generate subtitles** | `Disabled`, `Sentence`, `Sentence + Comma`, `Sentence + Highlighting`, `1 word`, `2 words`, `3 words`, etc. (Represents the number of words in each subtitle entry) | | **Output voice format** | `.WAV`, `.FLAC`, `.MP3`, `.OPUS (best compression)` and `M4B (with chapters)` (Special thanks to [@jborza](https://github.com/jborza) for chapter support in PR [#10](https://github.com/denizsafak/abogen/pull/10)) | | **Output subtitle format** | Configures the subtitle format as `SRT (standard)`, `ASS (wide)`, `ASS (narrow)`, `ASS (centered wide)`, or `ASS (centered narrow)`. | | **Replace single newlines with spaces** | Replaces single newlines with spaces in the text. This is useful for texts that have imaginary line breaks. | @@ -157,6 +161,8 @@ Here’s Abogen in action: in this demo, it processes ∼3,000 characters of tex | **Disable Kokoro's internet access** | Prevents Kokoro from downloading models or voices from HuggingFace Hub, useful for offline use. | | **Reset to default settings** | Resets all settings to their default values. | +> Special thanks to [@robmckinnon](https://github.com/robmckinnon) for adding Sentence + Highlighting feature in PR [#65](https://github.com/denizsafak/abogen/pull/65) + ## `Voice Mixer` @@ -222,6 +228,9 @@ Similar to chapter markers, it is possible to add metadata tags for `M4B` files. ``` For a complete list of supported languages and voices, refer to Kokoro's [VOICES.md](https://huggingface.co/hexgrad/Kokoro-82M/blob/main/VOICES.md). To listen to sample audio outputs, see [SAMPLES.md](https://huggingface.co/hexgrad/Kokoro-82M/blob/main/SAMPLES.md). +> [!NOTE] +> Japanese audio may require additional configuration. Please check [#56](https://github.com/denizsafak/abogen/issues/56) for more information. + ## `MPV Config` I highly recommend using [MPV](https://mpv.io/installation/) to play your audio files, as it supports displaying subtitles even without a video track. Here's my `mpv.conf`: ``` diff --git a/abogen/VERSION b/abogen/VERSION index ab67981..a5ba932 100644 --- a/abogen/VERSION +++ b/abogen/VERSION @@ -1 +1 @@ -1.1.6 \ No newline at end of file +1.1.7 \ No newline at end of file