Skip to content

Commit 218b670

Browse files
committed
Update readme and versions for 0.6.1 and build generic MacOS variant again
1 parent 4936aea commit 218b670

4 files changed

Lines changed: 39 additions & 11 deletions

File tree

.github/workflows/build-project.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ jobs:
7878
strategy:
7979
matrix:
8080
architecture: [x86_64, arm64]
81-
macos_version: [12, 13, 14, 15]
81+
macos_version: [12, 13, 14, 15, embedded]
8282
defaults:
8383
run:
8484
shell: zsh --no-rcs --errexit --pipefail {0}

README.md

Lines changed: 36 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -12,13 +12,36 @@ If you’re looking for a hosted desktop recording API, consider checking out [R
1212
[![GitHub release (latest by date)](https://img.shields.io/github/v/release/locaal-ai/obs-localvocal)](https://github.com/locaal-ai/obs-localvocal/releases)
1313
[![GitHub stars](https://badgen.net/github/stars/locaal-ai/obs-localvocal)](https://GitHub.com/locaal-ai/obs-localvocal/stargazers/)
1414
<br/>
15-
Download:</br>
16-
[![Static Badge](https://img.shields.io/badge/Windows%20(generic)-0078d6?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.5.3/obs-localvocal-0.5.3-windows-x64-generic-Installer.exe) [![Static Badge](https://img.shields.io/badge/Windows%20(NVidia)-0078d6?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.5.3/obs-localvocal-0.5.3-windows-x64-nvidia-Installer.exe) [![Static Badge](https://img.shields.io/badge/Windows%20(AMD)-0078d6?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.5.3/obs-localvocal-0.5.3-windows-x64-amd-Installer.exe)
17-
[![Static Badge](https://img.shields.io/badge/mac%20Intel-000000?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.5.3/obs-localvocal-0.5.3-macos-x86_64.pkg) [![Static Badge](https://img.shields.io/badge/mac%20M1/2/3-0a0a0a?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.5.3/obs-localvocal-0.5.3-macos-arm64.pkg)
18-
[![Static Badge](https://img.shields.io/badge/Linux%20(generic)-FCC624?style=for-the-badge&logo=linux&logoColor=black)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.5.3/obs-localvocal-0.5.3-generic-x86_64-linux-gnu.deb) [![Static Badge](https://img.shields.io/badge/Linux%20(NVidia)-FCC624?style=for-the-badge&logo=linux&logoColor=black)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.5.3/obs-localvocal-0.5.3-nvidia-x86_64-linux-gnu.deb) [![Static Badge](https://img.shields.io/badge/Linux%20(AMD)-FCC624?style=for-the-badge&logo=linux&logoColor=black)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.5.3/obs-localvocal-0.5.3-amd-x86_64-linux-gnu.deb)
19-
2015
</div>
2116

17+
## Downloads
18+
19+
### Windows
20+
21+
OS | Generic (x86_64) | NVidia (x86_64) | AMD (x86_64)
22+
:-:|:-------:|:------:|:---:
23+
Windows 10/11 | [![Static Badge](https://img.shields.io/badge/Windows%20(generic)-0078d6?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.6.1/obs-localvocal-0.6.1-windows-x64-generic-Installer.exe) | [![Static Badge](https://img.shields.io/badge/Windows%20(NVidia)-0078d6?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.6.1/obs-localvocal-0.6.1-windows-x64-nvidia-Installer.exe) | [![Static Badge](https://img.shields.io/badge/Windows%20(AMD)-0078d6?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.6.1/obs-localvocal-0.6.1-windows-x64-amd-Installer.exe)
24+
25+
### Linux
26+
27+
OS | Generic (x86_64) | NVidia (x86_64) | AMD (x86_64)
28+
:-:|:-------:|:------:|:---:
29+
Ubuntu 22.04 (Jammy) .deb | [![Static Badge](https://img.shields.io/badge/Ubuntu%20(generic)-FCC624?style=for-the-badge&logo=linux&logoColor=black)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.6.1/obs-localvocal-0.6.1-generic-x86_64-linux-gnu.deb) | [![Static Badge](https://img.shields.io/badge/Ubuntu%20(NVidia)-FCC624?style=for-the-badge&logo=linux&logoColor=black)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.6.1/obs-localvocal-0.6.1-nvidia-x86_64-linux-gnu.deb) | [![Static Badge](https://img.shields.io/badge/Ubuntu%20(AMD)-FCC624?style=for-the-badge&logo=linux&logoColor=black)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.6.1/obs-localvocal-0.6.1-amd-x86_64-linux-gnu.deb)
30+
31+
### MacOS
32+
33+
MacOS | Intel x86_64 | ARM64 (Apple silicon - M1/M2/M3/M4)
34+
:----:|:-----:|:------------------:
35+
Generic* | [![Static Badge](https://img.shields.io/badge/mac%20OS%20Intel-000000?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.6.1/obs-localvocal-0.6.1-macos-embedded-x86_64.pkg) | [![Static Badge](https://img.shields.io/badge/mac%20OS%20ARM64-0a0a0a?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.6.1/obs-localvocal-0.6.1-macos-embedded-arm64.pkg)
36+
12 (Monterey) | [![Static Badge](https://img.shields.io/badge/mac%20OS%2012%20Intel-000000?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.6.1/obs-localvocal-0.6.1-macos-12-x86_64.pkg) | [![Static Badge](https://img.shields.io/badge/mac%20OS%2012%20ARM64-0a0a0a?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.6.1/obs-localvocal-0.6.1-macos-12-arm64.pkg)
37+
13 (Ventura) | [![Static Badge](https://img.shields.io/badge/mac%20OS%2013%20Intel-000000?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.6.1/obs-localvocal-0.6.1-macos-13-x86_64.pkg) | [![Static Badge](https://img.shields.io/badge/mac%20OS%2013%20ARM64-0a0a0a?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.6.1/obs-localvocal-0.6.1-macos-13-arm64.pkg)
38+
14 (Sonoma) | [![Static Badge](https://img.shields.io/badge/mac%20OS%2014%20Intel-000000?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.6.1/obs-localvocal-0.6.1-macos-14-x86_64.pkg) | [![Static Badge](https://img.shields.io/badge/mac%20OS%2014%20ARM64-0a0a0a?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.6.1/obs-localvocal-0.6.1-macos-14-arm64.pkg)
39+
15 (Sequoia) | [![Static Badge](https://img.shields.io/badge/mac%20OS%2015%20Intel-000000?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.6.1/obs-localvocal-0.6.1-macos-15-x86_64.pkg) | [![Static Badge](https://img.shields.io/badge/mac%20OS%2015%20ARM64-0a0a0a?style=for-the-badge&logo=apple&logoColor=white)](https://github.com/locaal-ai/obs-localvocal/releases/download/0.6.1/obs-localvocal-0.6.1-macos-15-arm64.pkg)
40+
41+
*While variants for specific versions of MacOS _may_ work better on that version of MacOS, the Generic variant is likely the best option. See [MacOS Variants](#mac-os-variants) below for more details
42+
43+
Check out the [latest releases](https://github.com/locaal-ai/obs-localvocal/releases) for downloads and install instructions.
44+
2245
## Introduction
2346

2447
LocalVocal lets you transcribe, locally on your machine, speech into text and simultaneously translate to any language. ✅ No GPU required, ✅ no cloud costs, ✅ no network and ✅ no downtime! Privacy first - all data stays on your machine.
@@ -67,9 +90,6 @@ Current Features:
6790
- Partial transcriptions for a streaming-captions experience
6891
- 100s of fine-tuned Whisper models for dozens of languages from HuggingFace
6992

70-
## Download
71-
Check out the [latest releases](https://github.com/locaal-ai/obs-localvocal/releases) for downloads and install instructions.
72-
7393
### Available Versions
7494

7595
LocalVocal is available in multiple versions to cater to different hardware configurations and operating systems. Below is a brief explanation of the different versions you can download:
@@ -139,6 +159,14 @@ These variants come with the following backends available:
139159
* Metal - Uses the system's GPU for accelerated processing
140160
* CoreML - Special backend that uses Apple's CoreML instead of Whisper's normal model processing, running on either the Metal or CPU backends
141161

162+
The Generic MacOS version embeds the Metal shaders into whisper.cpp as intermediate bytecode, which is compiled at runtime for the computer and GPU being used. This is probably the best version to use unless you have a reason to use the others, and may be able to take advantage of newer features in Metal 4 in MacOS Tahoe
163+
164+
Variants with Metal shaders pre-compiled for specific [Metal API versions](https://support.apple.com/en-gb/102894) which may or may not work slightly better on the appropriate version of MacOS:
165+
* MacOS 12 - Metal 2.4
166+
* MacOS 13 - Metal 3.0
167+
* MacOS 14 - Metal 3.1
168+
* MacOS 15 - Metal 3.2
169+
142170
### Models
143171
The plugin ships with the Tiny.en model, and will autonomously download other Whisper models through a dropdown.
144172
There's also an option to select an external GGML Whisper model file if you have it on disk.

buildspec.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@
3535
},
3636
"name": "obs-localvocal",
3737
"displayName": "OBS Localvocal",
38-
"version": "0.6.0",
38+
"version": "0.6.1",
3939
"author": "Roy Shilkrot",
4040
"website": "https://github.com/locaal-ai/obs-localvocal",
4141
"email": "roy.shil@gmail.com",

flatpak/com.obsproject.Studio.Plugin.LocalVocal.metainfo.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@
2626
<metadata_license>CC0-1.0</metadata_license>
2727
<project_license>GPL-2.0-or-later</project_license>
2828
<releases>
29-
<release version="0.6.0" date="2026-01-05">
29+
<release version="0.6.1" date="2026-01-05">
3030
<description>
3131
<p>Experimental release with per-macOS-version Metal builds to fix crashes on older macOS releases.</p>
3232
</description>

0 commit comments

Comments
 (0)