Skip to content

Commit 1433e05

Browse files
committed
feat: update README and index.html to include clip-range download feature details
1 parent 8b293a7 commit 1433e05

2 files changed

Lines changed: 30 additions & 8 deletions

File tree

README.md

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ Cross-platform desktop downloader for YouTube and other platforms, built with El
1111

1212
- Queue-based downloads with per-item progress and logs
1313
- Pause, resume, cancel, and retry controls
14+
- Optional clip-range downloads (start/end time)
1415
- Smart fallback strategy for format/download failures
1516
- Built-in `yt-dlp` updater
1617
- In-app app-update notification (checks GitHub latest release)
@@ -31,6 +32,7 @@ StreamFetch now handles restricted content in a guided flow:
3132

3233
- Single video and playlist support
3334
- Advanced format picker from extracted format IDs
35+
- Clip-range download for single videos (`ss`, `mm:ss`, `hh:mm:ss`)
3436
- Playlist range controls (`start`, `end`, include, exclude)
3537
- Global + per-download speed limits (`500K`, `2M`, `1.5M`)
3638
- Download history and runtime logs
@@ -103,10 +105,25 @@ npm run build:mac
103105
npm run build:linux
104106
```
105107

108+
## Clip-Range Download (Time Span)
109+
110+
You can download only a specific part of a single video:
111+
112+
1. Fetch video metadata.
113+
2. In `Download Options`, enable `Clip Range`.
114+
3. Enter `Start Time` and `End Time` using `ss`, `mm:ss`, or `hh:mm:ss`.
115+
4. Queue the job.
116+
117+
Notes:
118+
- Clip range is available only for single videos (not playlist jobs).
119+
- `ffmpeg` is required for clip extraction.
120+
106121
## Release Workflow
107122

108123
- GitHub workflow runs on `v*` tags (for example `v1.2.0`).
109-
- Tagged releases build artifacts for Windows, macOS, and Linux.
124+
- Workflow validates that tag version (`vX.Y.Z`) matches `package.json` version.
125+
- Tagged releases build artifacts for Windows, Linux, and macOS.
126+
- macOS build is configured as non-blocking in CI (to avoid blocking release when mac runners are unavailable).
110127
- Release notes are auto-generated from commits between the previous release tag and the current tag.
111128
- Notes are grouped into `Features`, `Fixes`, and `Other Changes` based on commit message prefix.
112129

docs/index.html

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<title>StreamFetch | Fast Desktop Video Downloader (Windows / macOS / Linux)</title>
77
<meta
88
name="description"
9-
content="StreamFetch is a fast cross-platform desktop video downloader optimized for Windows, with queue controls, smart retries, format selection, and built-in yt-dlp updates. Also available on macOS and Linux via source builds."
9+
content="StreamFetch is a fast cross-platform desktop video downloader with queue controls, clip-range downloads, smart retries, format selection, and built-in yt-dlp updates. Release artifacts are available for Windows, macOS, and Linux."
1010
/>
1111
<link rel="preconnect" href="https://fonts.googleapis.com" />
1212
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
@@ -42,7 +42,7 @@
4242
<h1>Fetch, queue, and download videos faster with desktop-level control.</h1>
4343
<p class="hero-text">
4444
StreamFetch combines Electron, React, and yt-dlp into a focused desktop app for reliable video and audio
45-
downloads, even when links need retries or cookie-authenticated access.
45+
downloads, including optional clip-range extraction and guided auth recovery when links need retries.
4646
</p>
4747
<div class="hero-actions">
4848
<a class="btn btn-primary" href="https://github.com/Shripad735/streamfetch/releases/latest" target="_blank" rel="noreferrer">
@@ -54,6 +54,7 @@ <h1>Fetch, queue, and download videos faster with desktop-level control.</h1>
5454
</div>
5555
<ul class="hero-points">
5656
<li>Queue-based workflow with per-item progress</li>
57+
<li>Clip-range download by start/end time</li>
5758
<li>Pause, resume, cancel, and retry controls</li>
5859
<li>Smart fallback for format and auth issues</li>
5960
</ul>
@@ -74,7 +75,7 @@ <h2>Why StreamFetch</h2>
7475
</div>
7576
<div class="metric">
7677
<span class="metric-title">Distribution</span>
77-
<span class="metric-value">Windows installer/portable via GitHub Releases; manual source builds for macOS/Linux</span>
78+
<span class="metric-value">Windows setup, Linux AppImage, and macOS DMG via GitHub Releases</span>
7879
</div>
7980
</aside>
8081
</section>
@@ -94,18 +95,22 @@ <h3>Playlist Controls</h3>
9495
<p>Target full playlists or narrow ranges with include and exclude style controls.</p>
9596
</article> -->
9697
<article class="feature-card" style="--order: 2;">
98+
<h3>Clip Range</h3>
99+
<p>Download only the needed portion of a video by entering start and end timestamps.</p>
100+
</article>
101+
<article class="feature-card" style="--order: 3;">
97102
<h3>Advanced Format Picker</h3>
98103
<p>Pick exact format IDs when auto mode is not enough for your target output.</p>
99104
</article>
100-
<article class="feature-card" style="--order: 3;">
105+
<article class="feature-card" style="--order: 4;">
101106
<h3>Auth Recovery Flow</h3>
102107
<p>Fallback from browser cookies to `cookies.txt` import when extraction is blocked.</p>
103108
</article>
104109
<!-- <article class="feature-card" style="--order: 5;">
105110
<h3>Speed Limits</h3>
106111
<p>Apply global and per-download bandwidth caps with human-readable limits.</p>
107112
</article> -->
108-
<article class="feature-card" style="--order: 4;">
113+
<article class="feature-card" style="--order: 5;">
109114
<h3>Update Awareness</h3>
110115
<p>Detect both app and yt-dlp updates so your downloader stays current.</p>
111116
</article>
@@ -126,7 +131,7 @@ <h3>Paste URL + Fetch</h3>
126131
<li>
127132
<span class="step-num">02</span>
128133
<h3>Select Output</h3>
129-
<p>Choose video or audio mode, quality profile, folder, and optional format ID.</p>
134+
<p>Choose video or audio mode, quality profile, optional clip range, folder, and optional format ID.</p>
130135
</li>
131136
<li>
132137
<span class="step-num">03</span>
@@ -173,7 +178,7 @@ <h2>Desktop convenience without dropping core Electron safeguards</h2>
173178

174179
<section class="section cta">
175180
<h2>Get Started with StreamFetch</h2>
176-
<p>Windows users: grab the latest installer or portable build and queue your first download in under a minute. On macOS or Linux, explore the repository for build instructions.</p>
181+
<p>Grab the latest setup/build from GitHub Releases (Windows setup, Linux AppImage, macOS DMG) and queue your first download in under a minute.</p>
177182
<div class="hero-actions">
178183
<a class="btn btn-primary" href="https://github.com/Shripad735/streamfetch/releases/latest" target="_blank" rel="noreferrer">
179184
Get Latest Build

0 commit comments

Comments
 (0)