Skip to content

ScriptX extracts scriptures from the American Sign Language version of the New World Translation Bible.

License

Notifications You must be signed in to change notification settings

JoelMon/scriptx

Repository files navigation

ScriptX

Rust Project Status: Active – The project has reached a stable, usable state and is being actively developed.

ScriptX is a command line tool designed to extract scriptures out of the American Sign Language version of the New World Translation, NWT, Bible published by the Watch Tower Bible and Tract Society of Pennsylvania. It is useful when you need specific scripture(s) in a standalone file. A quick example would be if you need to splice scriptures into another video.

All the meta data stored within the original file is retained even after being extracted, so when extracting a range you will still have access to chapter markers within your extracted video.

Features

  • Extract single or a range of scriptures eg. -v 5-10 extracts verses ranging from 5 to 10
  • Extracts all scriptures into individual files with -a
  • Maintains all metadata from the original file
  • Doesn't transcode so blazing 🔥 fast!

scriptx-demo

Known Issues

Some scripture videos files that can be downloaded from https://www.jw.org do not contain the meta data necessary for ScriptX to process. At the moment there are not work around for this problem. If ScriptX is ran on a file that causes a crash, this is likely the problem.

Dependencies

ffmpeg is required and has to be installed.

Installation

ScriptX hasn't been tested on Windows but it should work. If it doesn't create an issue and I will look into it.

From Source

Use Cargo to install ScriptX.

$ cargo install scriptx

If you prefer to install using the repository instead:

$ cargo install --git https://github.com/JoelMon/scriptx

Package

Ubuntu deb packages for amd64 systems are provided in the releases.

Usage

ScriptX is a command line tool to extract scriptures out of the American Sign Language version of the New World
Translation.

USAGE:
    scriptx [OPTIONS] --file <file> <--all|--verse <verse>>

FLAGS:
    -a, --all        Extracts all scriptures from the file.
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -f, --file <file>             The input video file to process.
    -o, --output <output_path>    The path were to save the output file. [default: output.m4v]
    -v, --verse <verse>           The verse to be extracted out. A single verse or a range of verses can be extracted.
                                  e.g. 2-5

Contributing

Pull requests are welcome. For major changes or if unsure about a contribution, please open an issue first to discuss what you would like to change.

Please, also remember to run tests to make sure everything is okay.

License

MIT

Note

This project, ScriptX, is not made by nor is it associated with the Watch Tower Bible and Tract Society of Pennsylvania.

About

ScriptX extracts scriptures from the American Sign Language version of the New World Translation Bible.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published