https://github.com/lowerquality/gentle

gentle forced aligner
https://github.com/lowerquality/gentle

Last synced: about 2 months ago
JSON representation

gentle forced aligner

• Host: GitHub
• URL: https://github.com/lowerquality/gentle
• Owner: lowerquality
• License: mit
• Created: 2015-10-23T10:00:45.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2024-04-25T16:54:38.000Z (5 months ago)
• Last Synced: 2024-04-29T09:31:19.239Z (5 months ago)
• Language: Python
• Homepage: https://lowerquality.com/gentle/
• Size: 1.44 MB
• Stars: 1,385
• Watchers: 45
• Forks: 290
• Open Issues: 162
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Awesome Lists containing this project

README

        
# Gentle

**Robust yet lenient forced-aligner built on Kaldi. A tool for aligning speech with text.**

## Getting Started

There are three ways to install Gentle.

1. Download the [pre-built Mac application](https://github.com/lowerquality/gentle/releases/latest). This package includes a GUI that will start the server and a browser. It only works on Mac OS.

2. Use the [Docker](https://www.docker.com/) image. Just run ```docker run -P lowerquality/gentle```. This works on all platforms supported by Docker.

3. Download the source code and run ```./install.sh```. Then run ```python3 serve.py``` to start the server. This works on Mac and Linux.

## Using Gentle

By default, the aligner listens at http://localhost:8765. That page has a graphical interface for transcribing audio, viewing results, and downloading data.

There is also a REST API so you can use Gentle in your programs. Here's an example of how to use the API with CURL:

```bash

curl -F "[email protected]" -F "[email protected]" "http://localhost:8765/transcriptions?async=false"

```

If you've downloaded the source code you can also run the aligner as a command line program:

```bash

git clone https://github.com/lowerquality/gentle.git

cd gentle

./install.sh

python3 align.py audio.mp3 words.txt

```

The default behaviour outputs the JSON to stdout.  See `python3 align.py --help` for options.