Windows>> download-youtube-subtitle>> 返回
项目作者： xsthunder

项目描述 ：
download youtube subtitles(closed caption, cc) as txt or json, support translation and proxy. available on PIP 🐍
高级语言： Jupyter Notebook
项目地址: git://github.com/xsthunder/download-youtube-subtitle.git
创建时间： 2020-03-16T08:58:28Z
项目社区：https://github.com/xsthunder/download-youtube-subtitle
开源协议：MIT License
下载


Updates:

3.0.0 fix download error and it finally supports download entire playlist! see Download the caption of entire playlist

Try it now!

try it online with google’s free python runtime! protip: you are able to download the output file from the sidebar! FREE from installation on your machine!

https://colab.research.google.com/drive/1oseD2yEsScx0YYOZ1x1F8GSG9iJ4x3qi?usp=sharing

图片

download-youtube-subtitle

Due to changes of youtube api, you need to UPGRADE to 3.0.0, see Install and Run

Download youtube subtitles(closed caption, cc) or srt as txt or json.

Features

  1. Support exportting translation at the same time which is useful for language study.
  2. Full control. All available caption will be displayed, use --caption_num --caption_num_second to choose the caption which will be displayed as original or translation transcript.
  3. Support proxy for youtube, follow the step at Using Anaconda behind a company proxy by setting environment-variables.
  4. Full test with traivis Build Status to make sure things are on rail.

python version of algolia/youtube-captions-scraper: Fetch youtube user submitted or fallback to auto-generated captions

Example

save as txt

dl-youtube-cc https://www.youtube.com/watch?v=wgNiGj1nGYE --translation 'ru'
or
dl-youtube-cc wgNiGj1nGYE --translation 'ru'

will saved as Version1.5SpecialProgramGenshinImpact.txt

  1. video_link     https://www.youtube.com/watch?v=wgNiGj1nGYE
  2. original     code="zh-Hans" name="Chinese (Simplified)"
  3. translation     ru
  4. ---------00:00----------
  5. 从前，有一对双胞胎结伴在宇宙中旅行
  6. Давным-давно, два близнеца вместе путешествовали по Вселенной.
  8. ---------00:05----------
  9. 但有一天，他们前路遇阻
  10. Однажды путь им преградило неизвестное божество

save as json

dl-youtube-cc wgNiGj1nGYE --translation ru --to_json=True will saved as Version1.5SpecialProgramGenshinImpact.json

  1. {
  2.     "original": [
  3.         {
  4.             "start": "0",
  5.             "dur": "5056",
  6.             "text": "从前，有一对双胞胎结伴在宇宙中旅行"
  7.         },
  8.         // continue
  9.     ],
  10.     "translation": [
  11.         {
  12.             "start": "0",
  13.             "dur": "5056",
  14.             "text": "Давным-давно, два близнеца вместе путешествовали по Вселенной."
  15.         },
  16.         // continue
  17.     ],
  18.     "merged": [
  19.         {
  20.             "start": "0",
  21.             "dur": "5056",
  22.             "text": "从前，有一对双胞胎结伴在宇宙中旅行",
  23.             "translate_text": "Давным-давно, два близнеца вместе путешествовали по Вселенной."
  24.         },
  25.         // continue
  26.     ]

use caption_num caption_num_second to get full control

All available caption will be displayed, use --caption_num --caption_num_second to choose the caption which will be displayed as original or translation transcript.

  1. >> dl-youtube-cc "wgNiGj1nGYE" --caption_num=0 --caption_num_second=3 --output_file="0,3-zh,fr.txt"
  2. INFO:  available caption(s):
  3. INFO:  #0  ✔ as original code="zh-Hans" name="Chinese (Simplified)"
  4. INFO:  #1  ⭕ code="zh-Hant" name="Chinese (Traditional)"
  5. INFO:  #2  ⭕ code="en-US" name="English (United States)"
  6. INFO:  #3  ✔ as translation code="fr" name="French"
  7. INFO:  #4  ⭕ code="de" name="German"
  8. INFO:  #5  ⭕ code="id" name="Indonesian"
  9. INFO:  #6  ⭕ code="pt" name="Portuguese"
  10. INFO:  #7  ⭕ code="ru" name="Russian"
  11. INFO:  #8  ⭕ code="es" name="Spanish"
  12. INFO:  #9  ⭕ code="th" name="Thai"
  13. INFO:  #10 ⭕ code="vi" name="Vietnamese"
  14. INFO:  given by --caption_num default to 0 as original
  15. INFO:  Save to  0,3-zh,fr.txt

Install and Run

Install via download-youtube-subtitle · PyPI

  1. pip install download-youtube-subtitle or pip install download-youtube-subtitle --user
  2. dl-youtube-cc -h

or uninstall to reinstall new version

pip uninstall download-youtube-subtitle -y

Run in CLI

Download the caption of one video

dl-youtube-cc -h will show the following.

  1. NAME
  2.     dl-youtube-cc - download youtube closed caption(subtitles) by videoID
  4. SYNOPSIS
  5.     dl-youtube-cc VIDEOID <flags>
  7. DESCRIPTION
  8.     Examples:
  9.     dl-youtube-cc -h # to see this helpful infomation
  10.     dl-youtube-cc wgNiGj1nGYE --translation 'ru' # use russian translation, see ./lang_code for full list
  11.     dl-youtube-cc wgNiGj1nGYE --caption_num=1 --translation 'ru' # choose the caption num for original transcript and use russian translation,
  12.     dl-youtube-cc wgNiGj1nGYE --caption_num=1 --caption_num_second=2 # manually choose the original and translation transcript from available caption list
  13.     dl-youtube-cc wgNiGj1nGYE --translation False # without translation
  14.     dl-youtube-cc wgNiGj1nGYE --save_to_file=False # print stuff in console
  15.     dl-youtube-cc wgNiGj1nGYE --output_file='test.txt' # print stuff in named file
  16.     dl-youtube-cc wgNiGj1nGYE --to_json=True # print stuff in json
  18. POSITIONAL ARGUMENTS
  19.     VIDEOID
  20.         Type: str
  21.         the video link or the id of youtube video, the string after 'v=' in a youtube video link
  23. FLAGS
  24.     --translation=TRANSLATION
  25.         Type: typing.Union[str, bool]
  26.         Default: 'zh-Hans'
  27.         which will be displayed as original transcript, default to 'zh-Hans' for simplified Chinese, see ./lang_code.json for full list, or pass False to disable translation
  28.     --caption_num=CAPTION_NUM
  29.         Type: int
  30.         Default: 0
  31.         choose the caption which will be displayed as original transcript
  32.     --caption_num_second=CAPTION_NUM_SECOND
  33.         Type: Optional[int]
  34.         Default: None
  35.         will surpass translation option, choose the caption which will be displayed as translation transcript
  36.     --output_file=OUTPUT_FILE
  37.         Type: Optional[str]
  38.         Default: None
  39.         default to video title
  40.     --save_to_file=SAVE_TO_FILE
  41.         Type: bool
  42.         Default: True
  43.         pass False to print in console
  44.     --to_json=TO_JSON
  45.         Type: bool
  46.         Default: False
  47.         pass True to export caption to json
  48.     --remove_font_tag=REMOVE_FONT_TAG
  49.         Type: bool
  50.         Default: True
  51.         remove font tag

Download the caption of entire playlist

dl-youtube-cc-playlist -h will show the following.

  1. NAME
  2.     dl-youtube-cc-playlist - download youtube closed caption(subtitles) by playlist. To figure most of params, please use dl-youtube-cc to download one video first before downloading the entire playlist.
  4. SYNOPSIS
  5.     dl-youtube-cc-playlist PLAYLIST_URL <flags>
  7. DESCRIPTION
  8.     Examples:
  9.     dl-youtube-cc-playlist -h # to see this helpful infomation
  10.     dl-youtube-cc-playlist PLS1QulWo1RIaJECMeUT4LFwJ-ghgoSH6n
  11.     dl-youtube-cc-playlist PLS1QulWo1RIaJECMeUT4LFwJ-ghgoSH6n 0 3 # download the first 3 videos
  12.     dl-youtube-cc-playlist https://www.youtube.com/playlist?list=PLS1QulWo1RIaJECMeUT4LFwJ-ghgoSH6n
  14. POSITIONAL ARGUMENTS
  15.     PLAYLIST_URL
  16.         Type: str
  17.         the playlist link or the id of youtube playlist, the string after 'list=' in the url
  19. FLAGS
  20.     --start=START
  21.         Default: 0
  22.         the index number in the playlist to start downloading, starting from 0
  23.     -e, --end=END
  24.         Type: Optional[]
  25.         Default: None
  26.         the index number in the playlist to end downloading, exclusively
  27.     --translation=TRANSLATION
  28.         Type: Optional[typing.Union[st...
  29.         Default: None
  30.         which will be displayed as original transcript, default to 'zh-Hans' for simplified Chinese, see ./lang_code.json for full list, or pass False to disable translation
  31.     --caption_num=CAPTION_NUM
  32.         Type: int
  33.         Default: 0
  34.         choose the caption which will be displayed as original transcript
  35.     --caption_num_second=CAPTION_NUM_SECOND
  36.         Type: Optional[int]
  37.         Default: None
  38.         will surpass translation option, choose the caption which will be displayed as translation transcript
  39.     -o, --output_file=OUTPUT_FILE
  40.         Type: Optional[str]
  41.         Default: None
  42.         default to video title
  43.     --save_to_file=SAVE_TO_FILE
  44.         Type: bool
  45.         Default: True
  46.         pass False to print in console
  47.     --to_json=TO_JSON
  48.         Type: bool
  49.         Default: False
  50.         pass True to export caption to json
  51.     -r, --remove_font_tag=REMOVE_FONT_TAG
  52.         Type: bool
  53.         Default: True
  54.         remove font tag
  56. NOTES
  57.     You can also use flags syntax for POSITIONAL ARGUMENT

Use in Code

  1. import download_youtube_subtitle.common as common
  2. import download_youtube_subtitle.main as download_youtube_subtitle
  3. # ...

Development

Environment Setup

for conda

  1. pip install 'fire' 'requests' 'IPython' 'sure' 'pytube' 'progiter'
  2. pip install -e .

Usage

  1. python main.py -h
  2. python main.py VIDEOID

Tests

  1. cd tests
  2. ./run.sh
  3. ./test_cli.sh

Ref

deployment - How can I use setuptools to generate a console_scripts entry point which calls python -m mypackage? - Stack Overflow

Packaging Python Projects — Python Packaging User Guide

./nb/notebook2script.py from course-v3/nbs/dl2 at master · fastai/course-v3

Google Style Python Docstrings