Skip to content

Commit eacad39

Browse files
committed
v1.2.6
1 parent b001ade commit eacad39

File tree

5 files changed

+29
-16
lines changed

5 files changed

+29
-16
lines changed

README.md

Lines changed: 20 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,9 @@
33
**youtube2txt** (YouTube Transcript Grabber) — A robust, locally-hosted tool to extract clean transcripts from any YouTube video. It runs on your own machine to bypass YouTube's IP blocks on public proxies, ensuring high reliability by using the powerful `yt-dlp` engine under the hood.
44

55
> [!IMPORTANT]
6-
> This tool must be hosted locally on your own machine to avoid IP blocks from YouTube.
6+
> This tool must run locally to avoid YouTube IP blocks. It uses your own IP, which YouTube trusts, so transcript fetches are far more reliable.
77
8-
Since this tool runs **locally**, it uses your residential IP address, which YouTube trusts, effectively eliminating these errors.
8+
<br>
99

1010
## Features
1111

@@ -17,6 +17,8 @@ Since this tool runs **locally**, it uses your residential IP address, which You
1717

1818
[yt-dlp](https://github.com/yt-dlp/yt-dlp) is a powerful, open-source command-line tool used to extract information and download media from YouTube and thousands of other sites. In this project, it is used as the core engine to fetch high-quality, timed transcripts while handling YouTube's complex anti-bot measures better than standard web crawlers.
1919

20+
<br>
21+
2022
## How to Use
2123

2224
### Method 1: Desktop App (recommended)
@@ -55,17 +57,21 @@ Requires Docker Desktop (or Docker Engine + Compose v2).
5557
docker compose up --build
5658
```
5759

58-
### Optional Environment Variables
59-
- `YTDLP_PATH`: Use an existing `yt-dlp` binary from a custom path.
60-
- `YTDLP_COOKIES`: Path to a cookies file for YouTube (helps with rate limits).
61-
- `HOST`: Override the server host (default is 0.0.0.0).
62-
- `PORT`: Override the server port (default is 3000).
60+
<br>
61+
62+
## Configuration & Troubleshooting
6363

6464
### Using the latest UI
6565
Access the tool at `http://localhost:3000`, or use the hosted page which includes the latest UI updates:
6666
- **GitHub Pages**: [https://spacesoda.github.io/youtube2txt/](https://spacesoda.github.io/youtube2txt/)
6767
- **Auto-connect to Local Server**: [https://spacesoda.github.io/youtube2txt/?apiBase=http://localhost:3000](https://spacesoda.github.io/youtube2txt/?apiBase=http://localhost:3000)
6868

69+
### Optional Environment Variables
70+
- `YTDLP_PATH`: Use an existing `yt-dlp` binary from a custom path.
71+
- `YTDLP_COOKIES`: Path to a cookies file for YouTube (helps with rate limits).
72+
- `HOST`: Override the server host (default is 0.0.0.0).
73+
- `PORT`: Override the server port (default is 3000).
74+
6975
### Per-project Node Version
7076
To keep Node isolated and avoid conflicts with other projects:
7177
- **nvm (macOS/Linux)**: run `nvm install` then `nvm use` (this repo includes `.nvmrc`).
@@ -79,13 +85,18 @@ To keep Node isolated and avoid conflicts with other projects:
7985
- `EADDRINUSE`: port 3000 is busy. Run with `PORT=3001 npm start`.
8086
- `npm ERR! network`: network or proxy issue. Try again or switch networks.
8187

82-
## Release (for devs)
83-
To publish a new release with app files reliably included, tag the release and push the tag using the following commands:
88+
<br>
89+
90+
## Publishing a Release
91+
92+
To publish a new release with app files reliably included, use the following commands:
8493
```bash
8594
git tag v1.2.6
8695
git push origin v1.2.6
8796
```
8897

98+
<br>
99+
89100
## License
90101

91102
This project is licensed under the MIT License.

package-lock.json

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "youtube2txt",
3-
"version": "1.2.5",
3+
"version": "1.2.6",
44
"description": "Local server for fetching YouTube transcripts",
55
"author": "SPACESODA",
66
"main": "server.js",

public/app.js

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,8 @@ let currentSelectedLang = 'auto';
4949
let currentDefaultLang = '';
5050
const localReminderDefaults = {
5151
title: localReminderTitle ? localReminderTitle.innerText : '',
52-
message: localReminderMessage ? localReminderMessage.innerText : '',
52+
messageText: localReminderMessage ? localReminderMessage.innerText : '',
53+
messageHtml: localReminderMessage ? localReminderMessage.innerHTML : '',
5354
actionHtml: localReminderAction ? localReminderAction.innerHTML : ''
5455
};
5556

@@ -82,7 +83,8 @@ function showLocalReminder(variant = 'local') {
8283
return;
8384
}
8485
localReminderTitle.innerText = localReminderDefaults.title;
85-
localReminderMessage.innerText = localReminderDefaults.message;
86+
localReminderMessage.innerHTML =
87+
localReminderDefaults.messageHtml || localReminderDefaults.messageText;
8688
localReminderAction.innerHTML = localReminderDefaults.actionHtml;
8789
}
8890

public/index.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,8 +48,8 @@ <h1>youtube2txt</h1>
4848

4949
<div id="localReminder" class="local-reminder hidden">
5050
<p><strong id="localReminderTitle">Local Server Not Running</strong></p>
51-
<p id="localReminderMessage"><a href="https://github.com/SPACESODA/youtube2txt/releases/latest" target="_blank" rel="noopener noreferrer">Download</a> and open the desktop app → Click the tray icon to open on browser.</p>
52-
<p id="localReminderAction">Prefer the CLI? Run "npm run quickstart" from the repo (<a href="https://github.com/SPACESODA/youtube2txt" target="_blank" rel="noopener noreferrer">GitHub</a>).</p>
51+
<p id="localReminderMessage"><a href="https://github.com/SPACESODA/youtube2txt/releases/latest" target="_blank" rel="noopener noreferrer">Download</a> and open the desktop app → Click the tray icon to open on browser</p>
52+
<p id="localReminderAction">Prefer CLI? Run "npm run quickstart" from the <a href="https://github.com/SPACESODA/youtube2txt" target="_blank" rel="noopener noreferrer">repo</a></p>
5353
</div>
5454

5555
<div id="errorMsg" class="error-message hidden"></div>

0 commit comments

Comments
 (0)