Download and Installation#

Current version: 0.8

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 (M-series)#

Intel Macs#

Because we cannot sign the packages for Intel Macs, you will see a warning that noScribe and noScribeEdit come from unidentified developers. You must manually allow both programs to run if 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:

The following commands are intended for Debian/Ubuntu and require Python 3.11 or 3.12.

# Stop on any error
set -e

# System dependencies
sudo apt update
sudo apt install git python3 python3-venv python3-pip python3-tk

# Check that this is Python 3.11 or 3.12
python3 --version

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

# Replace the editor placeholder in this fresh checkout
rm -rf noScribeEdit/
git clone https://github.com/kaixxx/noScribeEditor.git noScribeEdit

# Python environment
python3 -m venv noscribe
source noscribe/bin/activate
python -m pip install --upgrade pip

# Resolve both applications' dependencies together
python -m pip install \
    -r environments/requirements_linux.txt \
    -r noScribeEdit/environments/requirements.txt \
    huggingface_hub
python -m pip check

# Download the fast model
hf download mukowaty/faster-whisper-int8 \
    --include "faster-whisper-large-v3-turbo-int8/*" \
    --local-dir model-downloads

mkdir -p models/fast
cp -a model-downloads/faster-whisper-large-v3-turbo-int8/. models/fast/

# Precise model
hf download dropbox-dash/faster-whisper-large-v3-turbo \
    --local-dir models/precise

# Confirm both model weights are present
test -s models/fast/model.bin
test -s models/precise/model.bin

# Start from the repository root
python -m noScribe

Old Versions#

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

Usage Forward