Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/samdutton/transcripter

Create readable transcripts from YouTube caption files
https://github.com/samdutton/transcripter

Last synced: 28 days ago
JSON representation

Create readable transcripts from YouTube caption files

Awesome Lists containing this project

README

        

# Create readable transcripts from YouTube captions

This is a Node application that processes caption files from Google, Android
and Chrome Developer channels to create readable transcripts.

The code could easily be adapted to work with caption files from other playlists.

Try it out at [devsearch.me/search](https://devsearch.me/search).

---

## Installation and usage

1. Clone or download the code.
2. Add your SRT caption files to the [_input_](src/input) directory.
3. From a terminal `cd` to the `src` directory and run `node index.js`,
optionally setting flags (see below).
4. Progress updates and errors will be logged to the console.
5. When conversion is complete, view the results from
[index.html](docs/index.html) in the [_output_](docs) directory, the directory
used for GitHub Pages. This directory includes a [CSS file](docs/css/main.css)
and a [JavaScript file](docs/js/main.js) to style the transcripts and
enable interaction.

### Input and output directories

* When you clone the repo, the [_input_](src/input) and [_output_](docs)
directories contain sample files.
* You can customize _input_ and _output_ directories — see flags below.

## Error handling

Check for errors in _error-log.txt_.

## Command line options

```
-a, --append Append output to existing files in output directory
-c, --index Create index page linking to standalone transcripts
-h, --help Show help
-i, --input Input directory, default is [_input_](src/input)
-o, --output Output directory, default is [_output_](src/docs)
-s, --search Create search index
```

## Feedback, feature requests and bug reports

- Please [file an issue](https://github.com/samdutton/transcripter/issues/new)
including input files where relevant.
- See the [TODO](TODO) file for work in progress.

## Known issues

### Google Translate widget

This widget is [no longer supported](https://translate.google.com/intl/en/about/website)
and the language selection popup is not laid out responsively.

Probably best to remove unless the layout can be fixed (others have tried!)

---

Please note that this is not an official Google product.