Skip to content

Commit ab76011

Browse files
committed
core release v6.0.14
1 parent cbc56b1 commit ab76011

File tree

16 files changed

+249
-69
lines changed

16 files changed

+249
-69
lines changed

README.md

Lines changed: 30 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
</div>
1515

1616
<div align="center">
17-
<p>A lightweight TypeScript/JavaScript library for downloading videos, images, and audio from Instagram, TikTok, YouTube, Capcut, Pinterest, Twitter, X, Google Drive, MediaFire, Douyin, SnackVideo, Xiaohongshu, Cocofun, Spotify, Youtube Search, and Facebook.</p>
17+
<p>A lightweight TypeScript/JavaScript library for downloading videos, images, and audio from Instagram, TikTok, YouTube, Capcut, Pinterest, Twitter, X, Google Drive, MediaFire, Douyin, SnackVideo, Xiaohongshu, Cocofun, Spotify, Youtube Search, SounCloud and Facebook.</p>
1818
</div>
1919

2020
<div align="center">
@@ -39,13 +39,13 @@ Alternatively, you can include btch-downloader by getting it from [npm](https://
3939
<script src="https://unpkg.com/btch-downloader/dist/browser/index.min.js"></script>
4040

4141
<!-- unpkg : use a specific version of btch-downloader (change the version numbers as necessary) -->
42-
<script src="https://unpkg.com/btch-downloader@6.0.13/dist/browser/index.min.js"></script>
42+
<script src="https://unpkg.com/btch-downloader@6.0.14/dist/browser/index.min.js"></script>
4343

4444
<!-- jsDelivr : use the latest version of btch-downloader -->
4545
<script src="https://cdn.jsdelivr.net/npm/btch-downloader/dist/browser/index.min.js"></script>
4646

4747
<!-- jsDelivr : use a specific version of btch-downloader (change the version numbers as necessary) -->
48-
<script src="https://cdn.jsdelivr.net/npm/btch-downloader@6.0.13/dist/browser/index.min.js"></script>
48+
<script src="https://cdn.jsdelivr.net/npm/btch-downloader@6.0.14/dist/browser/index.min.js"></script>
4949
````
5050

5151
---
@@ -160,6 +160,7 @@ Alternatively, you can include btch-downloader by getting it from [npm](https://
160160
<option value="cocofun">Cocofun</option>
161161
<option value="spotify">Spotify</option>
162162
<option value="yts">YTS</option>
163+
<option value="soundcloud">SoundCloud</option>
163164
</select>
164165
<input id="urlInput" placeholder="Paste any supported URL here..." />
165166
<button id="downloadBtn">Fetch</button>
@@ -186,10 +187,11 @@ Alternatively, you can include btch-downloader by getting it from [npm](https://
186187
<li>Google Drive: <a href="https://drive.google.com/file/d/1thDYWcS5p5FFhzTpTev7RUv0VFnNQyZ4/view" target="_blank">https://drive.google.com/file/d/1thDYWcS5p5FFhzTpTev7RUv0VFnNQyZ4/view</a></li>
187188
<li>Pinterest: <a href="https://pin.it/4CVodSq" target="_blank">https://pin.it/4CVodSq</a> or query (e.g., "Zhao Lusi")</li>
188189
<li>Douyin: <a href="https://v.douyin.com/ikq8axJ/" target="_blank">https://v.douyin.com/ikq8axJ/</a></li>
189-
<li>Xiaohongshu: <a href="https://xhslink.com/o/588P0GrGwWf" target="_blank">https://xhslink.com/o/588P0GrGwWf</a></li>
190+
<li>Xiaohongshu: <a href="http://xhslink.com/o/2jqifpr7GJ5" target="_blank">http://xhslink.com/o/2jqifpr7GJ5</a></li>
190191
<li>SnackVideo: <a href="https://s.snackvideo.com/p/j9jKr9dR" target="_blank">https://s.snackvideo.com/p/j9jKr9dR</a></li>
191192
<li>Cocofun: <a href="https://www.icocofun.com/share/post/379250110809" target="_blank">https://www.icocofun.com/share/post/379250110809</a></li>
192193
<li>Spotify: <a href="https://open.spotify.com/track/3zakx7RAwdkUQlOoQ7SJRt" target="_blank">https://open.spotify.com/track/3zakx7RAwdkUQlOoQ7SJRt</a></li>
194+
<li>SoundCloud: <a href="https://soundcloud.com/issabella-marchelina/sisa-rasa-mahalini-official-audio?utm_source=clipboard&utm_medium=text&utm_campaign=social_sharing" target="_blank">https://soundcloud.com/issabella-marchelina/sisa-rasa-mahalini-official-audio?utm_source=clipboard&utm_medium=text&utm_campaign=social_sharing</a></li>
193195
<li>YTS: <a href="#" target="_blank">Enter a YTS query (e.g., "movie title 2023")</a></li>
194196
</ul>
195197

@@ -218,6 +220,7 @@ Alternatively, you can include btch-downloader by getting it from [npm](https://
218220
snackvideo: "Paste SnackVideo URL (e.g., https://s.snackvideo.com/p/123)",
219221
cocofun: "Paste Cocofun URL (e.g., https://www.icocofun.com/share/post/123)",
220222
spotify: "Paste Spotify URL (e.g., https://open.spotify.com/track/123)",
223+
soundcloud: "Paste SoundCloud URL (e.g., https://soundcloud.com/xxxxc)",
221224
yts: "Enter YTS query (e.g., 'movie title 2023')"
222225
};
223226
@@ -236,6 +239,7 @@ Alternatively, you can include btch-downloader by getting it from [npm](https://
236239
snackvideo: /(snackvideo\.com|s\.snackvideo\.com)/i,
237240
cocofun: /(icocofun|cocofun)\.com/i,
238241
spotify: /(open\.spotify|play\.spotify|spotify)\.com/i,
242+
soundcloud: /(soundcloud)\.com/i,
239243
};
240244
241245
const fnMap = {
@@ -253,6 +257,7 @@ Alternatively, you can include btch-downloader by getting it from [npm](https://
253257
snackvideo: "snackvideo",
254258
cocofun: "cocofun",
255259
spotify: "spotify",
260+
soundcloud: "soundcloud",
256261
yts: "yts",
257262
};
258263
@@ -579,15 +584,15 @@ douyin(url).then(data => console.log(data)).catch(err => console.error(err)); //
579584
```javascript
580585
import { xiaohongshu } from 'btch-downloader';
581586

582-
const url = 'https://xhslink.com/o/588P0GrGwWf';
587+
const url = 'http://xhslink.com/o/2jqifpr7GJ5';
583588
xiaohongshu(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON
584589
```
585590

586591
#### CJS
587592
```javascript
588593
const { xiaohongshu } = require('btch-downloader');
589594

590-
const url = 'https://xhslink.com/o/588P0GrGwWf';
595+
const url = 'http://xhslink.com/o/2jqifpr7GJ5';
591596
xiaohongshu(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON
592597
```
593598
### Snackvideo
@@ -650,7 +655,7 @@ spotify(url).then(data => console.log(data)).catch(err => console.error(err)); /
650655
```javascript
651656
import { yts } from 'btch-downloader';
652657

653-
const query = 'Somewhere Only We Know;
658+
const query = 'Somewhere Only We Know';
654659
yts(query).then(data => console.log(data)).catch(err => console.error(err)); // JSON
655660
```
656661

@@ -662,6 +667,24 @@ const query = 'Somewhere Only We Know';
662667
spotify(query).then(data => console.log(data)).catch(err => console.error(err)); // JSON
663668
```
664669

670+
### SoundCloud
671+
672+
#### ESM
673+
```javascript
674+
import { soundcloud } from 'btch-downloader';
675+
676+
const url = 'https://soundcloud.com/issabella-marchelina/sisa-rasa-mahalini-official-audio?utm_source=clipboard&utm_medium=text&utm_campaign=social_sharing';
677+
SoundCloud(query).then(data => console.log(data)).catch(err => console.error(err)); // JSON
678+
```
679+
680+
#### CJS
681+
```javascript
682+
const { soundcloud } = require('btch-downloader');
683+
684+
const url = 'https://soundcloud.com/issabella-marchelina/sisa-rasa-mahalini-official-audio?utm_source=clipboard&utm_medium=text&utm_campaign=social_sharing';
685+
soundcloud(query).then(data => console.log(data)).catch(err => console.error(err)); // JSON
686+
```
687+
665688
## Important Notes
666689

667690
1. This downloader can only be used to download media that is public or accessible to the public.

docs/data/search.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
{"list":[{"title":"module:btch-downloader","link":"<a href=\"module-btch-downloader.html\">btch-downloader</a>","description":"<p>A lightweight TypeScript/JavaScript library for downloading media from social media platforms</p>"},{"title":"module:btch-downloader~aio","link":"<a href=\"module-btch-downloader.html#~aio\">aio</a>","description":"<p>Downloads media from a given URL across supported platforms.</p>"},{"title":"module:btch-downloader~capcut","link":"<a href=\"module-btch-downloader.html#~capcut\">capcut</a>","description":"<p>Downloads media from Capcut.</p>"},{"title":"module:btch-downloader~cocofun","link":"<a href=\"module-btch-downloader.html#~cocofun\">cocofun</a>","description":"<p>Downloads media from Cocofun.</p>"},{"title":"module:btch-downloader~douyin","link":"<a href=\"module-btch-downloader.html#~douyin\">douyin</a>","description":"<p>Downloads media from Douyin.</p>"},{"title":"module:btch-downloader~fbdown","link":"<a href=\"module-btch-downloader.html#~fbdown\">fbdown</a>","description":"<p>Downloads media from Facebook.</p>"},{"title":"module:btch-downloader~gdrive","link":"<a href=\"module-btch-downloader.html#~gdrive\">gdrive</a>","description":"<p>Downloads media from Google Drive.</p>"},{"title":"module:btch-downloader~igdl","link":"<a href=\"module-btch-downloader.html#~igdl\">igdl</a>","description":"<p>Downloads media from Instagram.</p>"},{"title":"module:btch-downloader~mediafire","link":"<a href=\"module-btch-downloader.html#~mediafire\">mediafire</a>","description":"<p>Downloads media from MediaFire.</p>"},{"title":"module:btch-downloader~pinterest","link":"<a href=\"module-btch-downloader.html#~pinterest\">pinterest</a>","description":"<p>Downloads or searches media from Pinterest using a URL or text query.</p>"},{"title":"module:btch-downloader~spotify","link":"<a href=\"module-btch-downloader.html#~spotify\">spotify</a>","description":"<p>Downloads media from Spotify.</p>"},{"title":"module:btch-downloader~ttdl","link":"<a href=\"module-btch-downloader.html#~ttdl\">ttdl</a>","description":"<p>Downloads media from TikTok.</p>"},{"title":"module:btch-downloader~twitter","link":"<a href=\"module-btch-downloader.html#~twitter\">twitter</a>","description":"<p>Downloads media from Twitter.</p>"},{"title":"module:btch-downloader~xiaohongshu","link":"<a href=\"module-btch-downloader.html#~xiaohongshu\">xiaohongshu</a>","description":"<p>Downloads media from Xiaohongshu.</p>"},{"title":"module:btch-downloader~youtube","link":"<a href=\"module-btch-downloader.html#~youtube\">youtube</a>","description":"<p>Downloads media from YouTube.</p>"},{"title":"module:btch-downloader~yts","link":"<a href=\"module-btch-downloader.html#~yts\">yts</a>","description":"<p>YouTube search function.</p>"}]}
1+
{"list":[{"title":"module:btch-downloader","link":"<a href=\"module-btch-downloader.html\">btch-downloader</a>","description":"<p>A lightweight TypeScript/JavaScript library for downloading media from social media platforms</p>"},{"title":"module:btch-downloader~aio","link":"<a href=\"module-btch-downloader.html#~aio\">aio</a>","description":"<p>Downloads media from a given URL across supported platforms.</p>"},{"title":"module:btch-downloader~capcut","link":"<a href=\"module-btch-downloader.html#~capcut\">capcut</a>","description":"<p>Downloads media from Capcut.</p>"},{"title":"module:btch-downloader~cocofun","link":"<a href=\"module-btch-downloader.html#~cocofun\">cocofun</a>","description":"<p>Downloads media from Cocofun.</p>"},{"title":"module:btch-downloader~douyin","link":"<a href=\"module-btch-downloader.html#~douyin\">douyin</a>","description":"<p>Downloads media from Douyin.</p>"},{"title":"module:btch-downloader~fbdown","link":"<a href=\"module-btch-downloader.html#~fbdown\">fbdown</a>","description":"<p>Downloads media from Facebook.</p>"},{"title":"module:btch-downloader~gdrive","link":"<a href=\"module-btch-downloader.html#~gdrive\">gdrive</a>","description":"<p>Downloads media from Google Drive.</p>"},{"title":"module:btch-downloader~igdl","link":"<a href=\"module-btch-downloader.html#~igdl\">igdl</a>","description":"<p>Downloads media from Instagram.</p>"},{"title":"module:btch-downloader~mediafire","link":"<a href=\"module-btch-downloader.html#~mediafire\">mediafire</a>","description":"<p>Downloads media from MediaFire.</p>"},{"title":"module:btch-downloader~pinterest","link":"<a href=\"module-btch-downloader.html#~pinterest\">pinterest</a>","description":"<p>Downloads or searches media from Pinterest using a URL or text query.</p>"},{"title":"module:btch-downloader~soundcloud","link":"<a href=\"module-btch-downloader.html#~soundcloud\">soundcloud</a>","description":"<p>Downloads media from SoundCloud.</p>"},{"title":"module:btch-downloader~spotify","link":"<a href=\"module-btch-downloader.html#~spotify\">spotify</a>","description":"<p>Downloads media from Spotify.</p>"},{"title":"module:btch-downloader~ttdl","link":"<a href=\"module-btch-downloader.html#~ttdl\">ttdl</a>","description":"<p>Downloads media from TikTok.</p>"},{"title":"module:btch-downloader~twitter","link":"<a href=\"module-btch-downloader.html#~twitter\">twitter</a>","description":"<p>Downloads media from Twitter.</p>"},{"title":"module:btch-downloader~xiaohongshu","link":"<a href=\"module-btch-downloader.html#~xiaohongshu\">xiaohongshu</a>","description":"<p>Downloads media from Xiaohongshu.</p>"},{"title":"module:btch-downloader~youtube","link":"<a href=\"module-btch-downloader.html#~youtube\">youtube</a>","description":"<p>Downloads media from YouTube.</p>"},{"title":"module:btch-downloader~yts","link":"<a href=\"module-btch-downloader.html#~yts\">yts</a>","description":"<p>YouTube search function.</p>"}]}

docs/example.html

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -101,6 +101,7 @@ <h1>Playground</h1>
101101
<option value="cocofun">Cocofun</option>
102102
<option value="spotify">Spotify</option>
103103
<option value="yts">YTS</option>
104+
<option value="soundcloud">SoundCloud</option>
104105
</select>
105106
<input id="urlInput" placeholder="Paste any supported URL here..." />
106107
<button id="downloadBtn">Fetch</button>
@@ -127,15 +128,16 @@ <h3>Example URLs</h3>
127128
<li>Google Drive: <a href="https://drive.google.com/file/d/1thDYWcS5p5FFhzTpTev7RUv0VFnNQyZ4/view" target="_blank">https://drive.google.com/file/d/1thDYWcS5p5FFhzTpTev7RUv0VFnNQyZ4/view</a></li>
128129
<li>Pinterest: <a href="https://pin.it/4CVodSq" target="_blank">https://pin.it/4CVodSq</a> or query (e.g., "Zhao Lusi")</li>
129130
<li>Douyin: <a href="https://v.douyin.com/ikq8axJ/" target="_blank">https://v.douyin.com/ikq8axJ/</a></li>
130-
<li>Xiaohongshu: <a href="https://xhslink.com/o/588P0GrGwWf" target="_blank">https://xhslink.com/o/588P0GrGwWf</a></li>
131+
<li>Xiaohongshu: <a href="http://xhslink.com/o/2jqifpr7GJ5" target="_blank">http://xhslink.com/o/2jqifpr7GJ5</a></li>
131132
<li>SnackVideo: <a href="https://s.snackvideo.com/p/j9jKr9dR" target="_blank">https://s.snackvideo.com/p/j9jKr9dR</a></li>
132133
<li>Cocofun: <a href="https://www.icocofun.com/share/post/379250110809" target="_blank">https://www.icocofun.com/share/post/379250110809</a></li>
133134
<li>Spotify: <a href="https://open.spotify.com/track/3zakx7RAwdkUQlOoQ7SJRt" target="_blank">https://open.spotify.com/track/3zakx7RAwdkUQlOoQ7SJRt</a></li>
135+
<li>SoundCloud: <a href="https://soundcloud.com/issabella-marchelina/sisa-rasa-mahalini-official-audio?utm_source=clipboard&utm_medium=text&utm_campaign=social_sharing" target="_blank">https://soundcloud.com/issabella-marchelina/sisa-rasa-mahalini-official-audio?utm_source=clipboard&utm_medium=text&utm_campaign=social_sharing</a></li>
134136
<li>YTS: <a href="#" target="_blank">Enter a YTS query (e.g., "movie title 2023")</a></li>
135137
</ul>
136138

137139
<!-- Load btch CDN -->
138-
<script src="https://cdn.jsdelivr.net/npm/btch-downloader@6.0.13/dist/browser/index.min.js"></script>
140+
<script src="https://cdn.jsdelivr.net/npm/btch-downloader@6.0.14/dist/browser/index.min.js"></script>
139141

140142
<script>
141143
const output = document.getElementById("output");
@@ -159,6 +161,7 @@ <h3>Example URLs</h3>
159161
snackvideo: "Paste SnackVideo URL (e.g., https://s.snackvideo.com/p/123)",
160162
cocofun: "Paste Cocofun URL (e.g., https://www.icocofun.com/share/post/123)",
161163
spotify: "Paste Spotify URL (e.g., https://open.spotify.com/track/123)",
164+
soundcloud: "Paste SoundCloud URL (e.g., https://soundcloud.com/xxxxc)",
162165
yts: "Enter YTS query (e.g., 'movie title 2023')"
163166
};
164167

@@ -177,6 +180,7 @@ <h3>Example URLs</h3>
177180
snackvideo: /(snackvideo\.com|s\.snackvideo\.com)/i,
178181
cocofun: /(icocofun|cocofun)\.com/i,
179182
spotify: /(open\.spotify|play\.spotify|spotify)\.com/i,
183+
soundcloud: /(soundcloud)\.com/i,
180184
};
181185

182186
const fnMap = {
@@ -194,6 +198,7 @@ <h3>Example URLs</h3>
194198
snackvideo: "snackvideo",
195199
cocofun: "cocofun",
196200
spotify: "spotify",
201+
soundcloud: "soundcloud",
197202
yts: "yts",
198203
};
199204

@@ -258,4 +263,4 @@ <h3>Example URLs</h3>
258263
});
259264
</script>
260265
</body>
261-
</html>
266+
</html>

0 commit comments

Comments
 (0)