Download and Installation#

Current version: 0.7

All installation files are hosted on SWITCHdrive.ch, a secure data-sharing platform for Swiss universities. The source code is available on GitHub, also for the noScribe Editor.

Windows Installation macOS Installation Linux Installation

Windows#

Download#

Two versions are available. Most users should choose the standard version. If you have an NVIDIA graphics card (RTX 20XX or newer) with at least 6 GB VRAM, you can benefit from CUDA acceleration, which can drastically reduce transcription time.

Installation#

  1. Start the installer (may take a few minutes).
  2. If Windows warns about an “unknown publisher”, choose “More info > Run anyway”. Unfortunately, this warning is hard to avoid for free software.
  3. If you want to install noScribe silently on multiple machines: start the setup with /S.

Known Issues (Windows)#

  • RTX/GTX-1xxx cards are often no longer supported by CUDA - in this case use the standard version.
  • If you see the error “Transcription worker exited unexpectedly (code 3221226505)”, it can help to force CPU usage:
    1. Quit noScribe.
    2. Open the file C:\Users\<USERNAME>\AppData\Local\noScribe\noScribe\config.yml.
    3. Set force_whisper_cpu to 'True' (keep the quotes).
    4. Restart noScribe.

macOS#

Apple Silicon (M1-M4, macOS 14+)#

Intel Macs#

Unfortunately we cannot sign the packages correctly for Intel Macs, so you will see a warning that noScribe and noScribeEdit come from unidentified developers. You must manually allow both programs to run if your Gatekeeper is enabled. Follow these steps:

  • Double-click the downloaded DMG file.
  • Drag noScribe and noScribeEdit into the link to your Applications folder (labeled “drag both here to install”).
  • Start noScribe by double-clicking the app in your Applications folder. You will get an error that noScribe is from an unidentified developer. Do the same for noScribe Editor.
  • Go to Settings -> Privacy & Security -> scroll down until you see a message that noScribe was blocked from starting, and click “Open Anyway”. Do the same again for the noScribe Editor.
  • From now on, both programs should start without issues.

Linux#

Executable Version#

Installation:

  1. Extract the archive: tar -xzvf noScribe_0.7.0_cpu_linux_amd64.tar.gz or tar -xzvf noScribe_0.7.0_cuda_linux_amd64.tar.gz
  2. Change into the folder and start: ./noScribe
  3. Optional: adjust noScribe.desktop and noScribeEdit.desktop (path in Exec=/Icon=).

Manual Installation from Source Code#

Discussion and details: https://github.com/kaixxx/noScribe/discussions/83

Quick overview:

git clone https://github.com/kaixxx/noScribe.git
cd noScribe

# noScribeEdit
rm -rf noScribeEdit/
git clone https://github.com/kaixxx/noScribeEditor.git noScribeEdit

# Python environment
python3 -m venv venv
source venv/bin/activate

# Dependencies
pip install -r environments/requirements_linux.txt
pip install -r noScribeEdit/environments/requirements.txt

# Models
rm -rf models/fast
rm -rf models/precise
git clone https://huggingface.co/mukowaty/faster-whisper-int8 models/fast
git clone https://huggingface.co/mobiuslabsgmbh/faster-whisper-large-v3-turbo models/precise

# Start
python3 ./noScribe.py

Old Versions#

https://drive.switch.ch/index.php/s/EIVup04qkSHb54j

Usage Forward