npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@wovin/tranz-cli

v0.1.5

Published

CLI for audio and video transcription

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

tennoxtennoxgotjoshuagotjoshua

Keywords

oclifclitranscription

Readme

@wovin/tranz-cli

CLI for audio and video transcription

JSR oclif

Quick Start

Transcribe an audio file using the Mistral provider with speaker diarization and segment-level timestamps:

tranz scribe --provider mistral --timestamps segment --diarization path/to/audio.file

Setup / Configuration

Installation

# npm
npm install -g @wovin/tranz-cli

# pnpm
pnpm add -g @wovin/tranz-cli

# yarn
yarn global add @wovin/tranz-cli

# deno
deno install -g jsr:@wovin/tranz-cli

# jsr (for any runtime)
npx jsr add -g @wovin/tranz-cli

API Key Configuration

The scribe command supports multiple transcription providers. For API-based providers (Mistral, GreenPT), you need to configure an API key.

Option 1: Environment Variable (Recommended)

export MISTRAL_API_KEY="your-api-key-here"
tranz scribe path/to/audio.mp3

Option 2: Secret File

Create a secret file in the project directory:

mkdir -p secret
echo "your-api-key-here" > secret/mistral

The tool will automatically look for secret/mistral if the MISTRAL_API_KEY environment variable is not set.

Supported Providers

  • whisper (default) - Local Whisper transcription (no API key needed)
  • mistral - Mistral Voxtral transcription API
  • greenpt - GreenPT transcription API

For GreenPT, use the same pattern with GREENPT_API_KEY or secret/greenpt.

Common Examples

Basic transcription with Whisper (local, no API key)

tranz scribe path/to/audio.mp3

Mistral with specific model

tranz scribe path/to/audio.mp3 --provider mistral --model voxtral-mini-latest

Mistral with word-level timestamps and diarization

tranz scribe path/to/audio.mp3 --provider mistral --timestamps word --diarization

Transcribe with preprocessing and normalization

tranz scribe path/to/audio.mp3 --prep --norm

GreenPT with language specification

tranz scribe path/to/audio.mp3 --provider greenpt --language en

Usage

$ npm install -g @wovin/tranz-cli
$ tranz COMMAND
running command...
$ tranz (--version)
@wovin/tranz-cli/0.0.26 linux-x64 node-v22.20.0
$ tranz --help [COMMAND]
USAGE
  $ tranz COMMAND
  ...

Commands

tranz help [COMMANDS]

Display help for tranz.

USAGE
  $ tranz help [COMMANDS] [-n]

ARGUMENTS
  COMMANDS  Command to show help for.

FLAGS
  -n, --nested-commands  Include all nested commands in the output.

DESCRIPTION
  Display help for tranz.

See code: @oclif/plugin-help

tranz plugins

List installed plugins.

USAGE
  $ tranz plugins [--json] [--core]

FLAGS
  --core  Show core plugins.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List installed plugins.

EXAMPLES
  $ tranz plugins

See code: @oclif/plugin-plugins

tranz plugins:install PLUGIN...

Installs a plugin into the CLI.

USAGE
  $ tranz plugins:install PLUGIN...

ARGUMENTS
  PLUGIN  Plugin to install.

FLAGS
  -f, --force    Run yarn install with force flag.
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Installs a plugin into the CLI.
  Can be installed from npm or a git url.

  Installation of a user-installed plugin will override a core plugin.

  e.g. If you have a core plugin that has a 'hello' command, installing a user-installed plugin with a 'hello' command
  will override the core plugin implementation. This is useful if a user needs to update core plugin functionality in
  the CLI without the need to patch and update the whole CLI.


ALIASES
  $ tranz plugins add

EXAMPLES
  $ tranz plugins:install myplugin

  $ tranz plugins:install https://github.com/someuser/someplugin

  $ tranz plugins:install someuser/someplugin

tranz plugins:inspect PLUGIN...

Displays installation properties of a plugin.

USAGE
  $ tranz plugins:inspect PLUGIN...

ARGUMENTS
  PLUGIN  [default: .] Plugin to inspect.

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Displays installation properties of a plugin.

EXAMPLES
  $ tranz plugins:inspect myplugin

See code: @oclif/plugin-plugins

tranz plugins:install PLUGIN...

Installs a plugin into the CLI.

USAGE
  $ tranz plugins:install PLUGIN...

ARGUMENTS
  PLUGIN  Plugin to install.

FLAGS
  -f, --force    Run yarn install with force flag.
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Installs a plugin into the CLI.
  Can be installed from npm or a git url.

  Installation of a user-installed plugin will override a core plugin.

  e.g. If you have a core plugin that has a 'hello' command, installing a user-installed plugin with a 'hello' command
  will override the core plugin implementation. This is useful if a user needs to update core plugin functionality in
  the CLI without the need to patch and update the whole CLI.


ALIASES
  $ tranz plugins add

EXAMPLES
  $ tranz plugins:install myplugin

  $ tranz plugins:install https://github.com/someuser/someplugin

  $ tranz plugins:install someuser/someplugin

See code: @oclif/plugin-plugins

tranz plugins:link PLUGIN

Links a plugin into the CLI for development.

USAGE
  $ tranz plugins:link PLUGIN

ARGUMENTS
  PATH  [default: .] path to plugin

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Links a plugin into the CLI for development.
  Installation of a linked plugin will override a user-installed or core plugin.

  e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
  command will override the user-installed or core plugin implementation. This is useful for development work.


EXAMPLES
  $ tranz plugins:link myplugin

See code: @oclif/plugin-plugins

tranz plugins:uninstall PLUGIN...

Removes a plugin from the CLI.

USAGE
  $ tranz plugins:uninstall PLUGIN...

ARGUMENTS
  PLUGIN  plugin to uninstall

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Removes a plugin from the CLI.

ALIASES
  $ tranz plugins unlink
  $ tranz plugins remove

tranz plugins:uninstall PLUGIN...

Removes a plugin from the CLI.

USAGE
  $ tranz plugins:uninstall PLUGIN...

ARGUMENTS
  PLUGIN  plugin to uninstall

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Removes a plugin from the CLI.

ALIASES
  $ tranz plugins unlink
  $ tranz plugins remove

See code: @oclif/plugin-plugins

tranz plugins:uninstall PLUGIN...

Removes a plugin from the CLI.

USAGE
  $ tranz plugins:uninstall PLUGIN...

ARGUMENTS
  PLUGIN  plugin to uninstall

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Removes a plugin from the CLI.

ALIASES
  $ tranz plugins unlink
  $ tranz plugins remove

tranz plugins update

Update installed plugins.

USAGE
  $ tranz plugins update [-h] [-v]

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Update installed plugins.

See code: @oclif/plugin-plugins

tranz prep INPUT

Prepare audio file - normalize, noise reduce, split on silence

USAGE
  $ tranz prep INPUT [-n] [-o <value>] [-s <value>] [-d <value>]

ARGUMENTS
  INPUT  input file

FLAGS
  -d, --sildur=<value>   [default: 1.1] silence duration
  -n, --norm             do normalization?
  -o, --output=<value>   [default: ./out] output directory
  -s, --silence=<value>  [default: -45dB] silence threshold

DESCRIPTION
  Prepare audio file - normalize, noise reduce, split on silence

EXAMPLES
  $ tranz prep path/to/audio.mp3

See code: src/commands/prep/index.ts

tranz scribe INPUT

Transcribe audio file - optionally prepare first

USAGE
  $ tranz scribe INPUT [-o <value>] [-p] [-n] [-d]

ARGUMENTS
  INPUT  input file

FLAGS
  -d, --separate_speakers  separate via diarization
  -n, --norm               do normalization?
  -o, --output=<value>     [default: ./out] output directory
  -p, --prep               do prep?

DESCRIPTION
  Transcribe audio file - optionally prepare first

EXAMPLES
  $ tranz scribe 'path/to/16khz-audiofile.wav'
  runs whisper and outputs and saves a transcription json

  $ tranz scribe 'path/to/whatever-audiofile.mp3' -p
  first prepares and then runs whisper and outputs and saves a transcription json

See code: src/commands/scribe/index.ts