Skip to content
This repository has been archived by the owner on Apr 4, 2023. It is now read-only.

ESV Text/Audio Aligner to programmatically obtain the timings for each word in the corresponding audio

Notifications You must be signed in to change notification settings

westonruter/esv-text-audio-aligner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ESV Text/Audio Aligner

Pulls down the ESV text and audio from the ESV API, then aligns the text and audio chapter-by-chapter by means of CMU Sphinx and generates {book}.{chapter}.timings.json timing files in the data/ directory (see output for John 3). The audio and text for each chapter is also saved in this directory. Previously-aligned chapters are skipped unless --forced. There is an ongoing discussion on the CMU Sphinx forums on the quality of the alignment data it provides.


Author: Weston Ruter (@westonruter)
GitHub: https://github.com/westonruter/esv-text-audio-aligner
Dependencies: Python 2.7, java, ant, sox, svn

The ESV Text and MP3 data downloaded by this script is subject to copyright:

The Holy Bible, English Standard Version copyright (c)2001 by Crossway Bibles, a publishing ministry of Good News Publishers. All rights reserved.

ESV API usage terms (see full conditions):

You can access the ESV text using the key "IP" (without the quotes). This key limits you to 5,000 queries per day from a single IP address. You are bound by the below conditions of use, including the non-commercial aspects.

Background

This project was birthed out of a desire to realize the read-along app, where the currently-spoken word in the audio is higlighted in the text on the screen. I made an HTML5 Audio Read-Along prototype (includes writeup) featuring a passage from Luke 2 of the ESV, but the actual audio timing data for the Luke 2 sample I had to obtain manually (read: painstakingly). This project aims to generate the audio word timings automatically so that the entire Bible can be used in a read-along app.

Usage

$ python align.py [-f|--force] [osisBook [[chapter], [chapter]...]]...

Examples

Align Genesis 1:

$ python align.py Gen 1

Align John 3, overridding any existing timings:

$ python align.py -f John 3

Align Genesis 1-3, Psalm 1, and all of Colossians:

$ python align.py Gen 1 2 3 Ps 1 Col

License

Dual licensed under the MIT or GPL Version 2 licenses.
MIT License: http://creativecommons.org/licenses/MIT/
GPL 2.0 license: http://creativecommons.org/licenses/GPL/2.0/

About

ESV Text/Audio Aligner to programmatically obtain the timings for each word in the corresponding audio

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published