View Source YoutubeCaptions
An elixir library for fetching Youtube Captions without API key. Uses Req under the hood.
Installation
The package can be installed by adding youtube_captions
to your list of dependencies in mix.exs
:
def deps do
[
{:youtube_captions, "~> 0.1.0"}
]
end
And run mix deps.get
.
Usage
First find video identifier. You can find it in the YouTube URL ?v=VIDEO_ID
.
Then you can download captions by calling YoutubeCaptions.get_subtitles(video_id, language)
. Language is optional and defaults to en
.
If successfull, you'll get list of subtitles in format %{start: float(), duration: float(), text: String.t()}
Examples
YoutubeCaptions.get_subtitles("JvBT4XBdoUE", "en")
#=> {:ok,
#=> [
#=> %{start: 0.99, text: "[Music]", duration: 6.87},
#=> %{start: 14.42, text: "thank you so hello everyone and thank", duration: 3.66},
#=> ...
#=> ]}
# You can customize Req options by passing third parameter
YoutubeCaptions.get_subtitles("JvBT4XBdoUE", "en", receive_timeout: 10_000)
Credits
Heavily inspired by youtube-captions-scraper.
License
Copyright © 2023-present Jakub Skałecki
This work is free. You can redistribute it and/or modify it under the
terms of the MIT License. See the LICENSE.md file for more details.