UNPKG

yt-sub-fetch

Version:

A lightweight and efficient CLI tool for fetching YouTube subtitles or transcripts effortlessly.

117 lines (72 loc) β€’ 2.38 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
# yt-sub-fetch πŸŽ₯πŸ’¬ A lightweight and efficient CLI tool for fetching YouTube subtitles or transcripts effortlessly. πŸš€ --- ## ✨ Features - πŸŽ₯ Fetch subtitles or transcripts for any YouTube video. - 🌍 Supports specifying language codes. - πŸ“ Outputs a clean, plain-text transcript. - πŸ› οΈ Easy-to-use CLI interface. - πŸ”— **New:** Copy the transcript to clipboard with `--copy` option. --- ## πŸ“ž Installation You can use `yt-sub-fetch` directly via **npx** without any prior installation: ```bash npx yt-sub-fetch <YouTube URL> [langCode] [--copy] ``` --- ## πŸš€ Usage ### πŸ”Ή Basic Command ```bash npx yt-sub-fetch <YouTube URL> ``` Example: ```bash npx yt-sub-fetch https://youtu.be/ekr2nIex040 ``` ### 🌐 Specify Language Code You can specify a language code to fetch subtitles in a specific language. Default is English (`en`). ```bash npx yt-sub-fetch <YouTube URL> <langCode> ``` Example: ```bash npx yt-sub-fetch https://youtu.be/ekr2nIex040 es ``` In this example, the tool will attempt to fetch Spanish subtitles (`es`). ### πŸ”Ή Copy Transcript to Clipboard Use the `--copy` option to automatically copy the transcript to your clipboard after fetching. ```bash npx yt-sub-fetch <YouTube URL> --copy ``` Example: ```bash npx yt-sub-fetch https://youtu.be/ekr2nIex040 --copy ``` This will fetch the subtitles and copy the content to your clipboard for easy pasting. --- ## πŸ‘” Output The tool will output the transcript in the following format: ``` Title: [Video Title] Transcript: [Transcript Text] ``` Example output: ``` Title: ROSÉ & Bruno Mars - APT. (Official Music Video) Transcript: [Music] start uhhuh [Music] uhuh uh uhhuh uh-huh kissy face kissy face sent to your phone butt I'm trying to kiss your Li for real... ``` If the `--copy` option is used, the transcript will also be copied to your clipboard. --- ## πŸ› οΈ Troubleshooting - βœ… Ensure the YouTube URL is valid. - 🌐 Verify that subtitles are available for the requested language. - πŸ“Ά Check your internet connection. - πŸ› If you encounter any issues, feel free to report them on the GitHub repository. --- ## πŸ‘¨β€πŸ’» Author Developed with ❀️ by [Aung Myo Kyaw](https://github.com/AungMyoKyaw) --- ## 🐟 License This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.