fast-dlp 0.6.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- fast_dlp-0.6.0/LICENSE +21 -0
- fast_dlp-0.6.0/PKG-INFO +438 -0
- fast_dlp-0.6.0/README.md +412 -0
- fast_dlp-0.6.0/fast_dlp/__init__.py +2 -0
- fast_dlp-0.6.0/fast_dlp/__main__.py +5 -0
- fast_dlp-0.6.0/fast_dlp/aes.py +136 -0
- fast_dlp-0.6.0/fast_dlp/cipher.py +542 -0
- fast_dlp-0.6.0/fast_dlp/cli.py +1188 -0
- fast_dlp-0.6.0/fast_dlp/download.py +332 -0
- fast_dlp-0.6.0/fast_dlp/extractor.py +213 -0
- fast_dlp-0.6.0/fast_dlp/formats.py +96 -0
- fast_dlp-0.6.0/fast_dlp/hls.py +359 -0
- fast_dlp-0.6.0/fast_dlp/innertube.py +107 -0
- fast_dlp-0.6.0/fast_dlp/lyrics.py +56 -0
- fast_dlp-0.6.0/fast_dlp/mp3.py +111 -0
- fast_dlp-0.6.0/fast_dlp/mux.py +855 -0
- fast_dlp-0.6.0/fast_dlp/net.py +109 -0
- fast_dlp-0.6.0/fast_dlp/oauth.py +175 -0
- fast_dlp-0.6.0/fast_dlp/playlist.py +236 -0
- fast_dlp-0.6.0/fast_dlp/postprocess.py +211 -0
- fast_dlp-0.6.0/fast_dlp/search.py +85 -0
- fast_dlp-0.6.0/fast_dlp/section.py +166 -0
- fast_dlp-0.6.0/fast_dlp/sources/__init__.py +24 -0
- fast_dlp-0.6.0/fast_dlp/sources/common.py +61 -0
- fast_dlp-0.6.0/fast_dlp/sources/generic.py +57 -0
- fast_dlp-0.6.0/fast_dlp/sources/pinterest.py +85 -0
- fast_dlp-0.6.0/fast_dlp/sources/pornhub.py +134 -0
- fast_dlp-0.6.0/fast_dlp/sources/soundcloud.py +107 -0
- fast_dlp-0.6.0/fast_dlp/sources/steam.py +174 -0
- fast_dlp-0.6.0/fast_dlp/sources/tiktok.py +145 -0
- fast_dlp-0.6.0/fast_dlp/sources/vk.py +133 -0
- fast_dlp-0.6.0/fast_dlp/sources/yandex.py +200 -0
- fast_dlp-0.6.0/fast_dlp/spotify.py +326 -0
- fast_dlp-0.6.0/fast_dlp/stream.py +637 -0
- fast_dlp-0.6.0/fast_dlp/sync.py +84 -0
- fast_dlp-0.6.0/fast_dlp/ts.py +93 -0
- fast_dlp-0.6.0/fast_dlp/tui.py +416 -0
- fast_dlp-0.6.0/fast_dlp/utils.py +141 -0
- fast_dlp-0.6.0/fast_dlp/web/__init__.py +1 -0
- fast_dlp-0.6.0/fast_dlp/web/__main__.py +5 -0
- fast_dlp-0.6.0/fast_dlp/web/server.py +421 -0
- fast_dlp-0.6.0/fast_dlp/web/static/index.html +608 -0
- fast_dlp-0.6.0/fast_dlp/web/static/logo.svg +24 -0
- fast_dlp-0.6.0/fast_dlp/ytmeta.py +292 -0
- fast_dlp-0.6.0/fast_dlp/ytmusic.py +148 -0
- fast_dlp-0.6.0/fast_dlp.egg-info/PKG-INFO +438 -0
- fast_dlp-0.6.0/fast_dlp.egg-info/SOURCES.txt +64 -0
- fast_dlp-0.6.0/fast_dlp.egg-info/dependency_links.txt +1 -0
- fast_dlp-0.6.0/fast_dlp.egg-info/entry_points.txt +2 -0
- fast_dlp-0.6.0/fast_dlp.egg-info/top_level.txt +1 -0
- fast_dlp-0.6.0/pyproject.toml +45 -0
- fast_dlp-0.6.0/setup.cfg +4 -0
- fast_dlp-0.6.0/tests/test_download.py +77 -0
- fast_dlp-0.6.0/tests/test_extras.py +180 -0
- fast_dlp-0.6.0/tests/test_music.py +123 -0
- fast_dlp-0.6.0/tests/test_mux.py +147 -0
- fast_dlp-0.6.0/tests/test_network.py +49 -0
- fast_dlp-0.6.0/tests/test_parsing.py +159 -0
- fast_dlp-0.6.0/tests/test_pornhub.py +97 -0
- fast_dlp-0.6.0/tests/test_section.py +120 -0
- fast_dlp-0.6.0/tests/test_sources.py +172 -0
- fast_dlp-0.6.0/tests/test_spotify_backend.py +70 -0
- fast_dlp-0.6.0/tests/test_stream.py +126 -0
- fast_dlp-0.6.0/tests/test_tag_progressive.py +85 -0
- fast_dlp-0.6.0/tests/test_tui.py +167 -0
- fast_dlp-0.6.0/tests/test_web.py +147 -0
fast_dlp-0.6.0/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 valkdz
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
fast_dlp-0.6.0/PKG-INFO
ADDED
|
@@ -0,0 +1,438 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: fast-dlp
|
|
3
|
+
Version: 0.6.0
|
|
4
|
+
Summary: Fast YouTube downloader: up to 4K at full line speed, built-in merging without ffmpeg, plus Spotify, Yandex Music, SoundCloud, TikTok and more
|
|
5
|
+
Author: valkdz
|
|
6
|
+
License-Expression: MIT
|
|
7
|
+
Project-URL: Homepage, https://github.com/valkdzx/fast-dlp
|
|
8
|
+
Project-URL: Source, https://github.com/valkdzx/fast-dlp
|
|
9
|
+
Project-URL: Issues, https://github.com/valkdzx/fast-dlp/issues
|
|
10
|
+
Keywords: youtube,downloader,youtube-dl,yt-dlp,spotify,soundcloud,tiktok,video,music,mp3
|
|
11
|
+
Classifier: Development Status :: 4 - Beta
|
|
12
|
+
Classifier: Environment :: Console
|
|
13
|
+
Classifier: Environment :: Web Environment
|
|
14
|
+
Classifier: Intended Audience :: End Users/Desktop
|
|
15
|
+
Classifier: Natural Language :: Russian
|
|
16
|
+
Classifier: Operating System :: OS Independent
|
|
17
|
+
Classifier: Programming Language :: Python :: 3
|
|
18
|
+
Classifier: Programming Language :: Python :: 3 :: Only
|
|
19
|
+
Classifier: Topic :: Multimedia :: Sound/Audio
|
|
20
|
+
Classifier: Topic :: Multimedia :: Video
|
|
21
|
+
Classifier: Topic :: Internet :: WWW/HTTP
|
|
22
|
+
Requires-Python: >=3.9
|
|
23
|
+
Description-Content-Type: text/markdown
|
|
24
|
+
License-File: LICENSE
|
|
25
|
+
Dynamic: license-file
|
|
26
|
+
|
|
27
|
+
<p align="center">
|
|
28
|
+
<img src="https://raw.githubusercontent.com/valkdzx/fast-dlp/main/assets/logo.svg" width="128" alt="fast-dlp">
|
|
29
|
+
</p>
|
|
30
|
+
|
|
31
|
+
<h1 align="center">fast-dlp</h1>
|
|
32
|
+
|
|
33
|
+
<p align="center">
|
|
34
|
+
Быстрая альтернатива yt-dlp. Чистый Python, без зависимостей.<br>
|
|
35
|
+
YouTube · Spotify · Яндекс Музыка · SoundCloud · TikTok · VK · Pinterest · Pornhub · Steam Workshop
|
|
36
|
+
</p>
|
|
37
|
+
|
|
38
|
+
- **Скорость:** 4K-видео на 345 МиБ скачивается за 7.3 с (~47 МиБ/с).
|
|
39
|
+
- **Без ffmpeg:** видео и звук склеиваются встроенным муксером меньше чем за секунду.
|
|
40
|
+
- **Музыка:** теги, обложки, тексты песен и ReplayGain пишутся сами.
|
|
41
|
+
- **Поиск:** один запрос сразу по всем источникам.
|
|
42
|
+
- **Экран выбора:** треки отмечаются в терминале, качаются параллельно.
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
## Установка
|
|
47
|
+
|
|
48
|
+
Нужен Python 3.9+.
|
|
49
|
+
|
|
50
|
+
```
|
|
51
|
+
pip install fast-dlp
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
Обновление: `pip install -U fast-dlp`. Чтобы команда была изолирована от остальных
|
|
55
|
+
пакетов, можно поставить через pipx: `pipx install fast-dlp`.
|
|
56
|
+
|
|
57
|
+
Из исходников:
|
|
58
|
+
|
|
59
|
+
```
|
|
60
|
+
git clone https://github.com/valkdzx/fast-dlp
|
|
61
|
+
cd fast-dlp
|
|
62
|
+
pip install -e .
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
Без установки: `py -m fast_dlp ...` или `fast-dlp.cmd ...` из папки проекта.
|
|
66
|
+
|
|
67
|
+
Необязательные программы:
|
|
68
|
+
|
|
69
|
+
- **ffmpeg** — только для MP3 и смешанных контейнеров;
|
|
70
|
+
- **Deno, Node.js или Bun** — только для возрастных видео через `login`.
|
|
71
|
+
|
|
72
|
+
## Примеры
|
|
73
|
+
|
|
74
|
+
```
|
|
75
|
+
fast-dlp https://youtu.be/VIDEO_ID # лучшее видео + звук
|
|
76
|
+
fast-dlp https://youtu.be/VIDEO_ID -q 1080 # не выше 1080p
|
|
77
|
+
fast-dlp https://youtu.be/VIDEO_ID -x # только звук
|
|
78
|
+
fast-dlp https://youtu.be/VIDEO_ID --audio-format mp3
|
|
79
|
+
fast-dlp https://youtu.be/VIDEO_ID -F # список форматов
|
|
80
|
+
fast-dlp https://youtu.be/VIDEO_ID -f 137+140 # конкретные itag
|
|
81
|
+
fast-dlp https://youtu.be/VIDEO_ID -g # вывести прямые ссылки
|
|
82
|
+
fast-dlp https://open.spotify.com/track/TRACK_ID # трек Spotify
|
|
83
|
+
fast-dlp https://open.spotify.com/album/ALBUM_ID # альбом, экран выбора
|
|
84
|
+
fast-dlp "https://www.youtube.com/playlist?list=PLAYLIST_ID"
|
|
85
|
+
fast-dlp исполнитель - название # поиск по всем источникам
|
|
86
|
+
fast-dlp URL -N 32 -P D:\Video -o "{author} - {title}.{ext}"
|
|
87
|
+
fast-dlp web # сайт-загрузчик на http://127.0.0.1:8000
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
## Сайт-загрузчик
|
|
93
|
+
|
|
94
|
+
```
|
|
95
|
+
fast-dlp web # http://127.0.0.1:8000
|
|
96
|
+
fast-dlp web --host 0.0.0.0 --port 8080 # доступ из локальной сети
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
Чёрная страница: вставляете ссылку на видео, выбираете параметры, нажимаете «Скачать».
|
|
100
|
+
|
|
101
|
+
Параметры:
|
|
102
|
+
|
|
103
|
+
- что скачать: видео со звуком, только звук или только видео;
|
|
104
|
+
- формат: MP4 (H.264 / AV1 + AAC) или WebM (VP9 + Opus); для звука M4A, Opus или MP3;
|
|
105
|
+
- качество от 144p до 4K, с размером каждого варианта;
|
|
106
|
+
- кодек и битрейт MP3;
|
|
107
|
+
- отрывок по времени;
|
|
108
|
+
- теги, обложка, ReplayGain;
|
|
109
|
+
- шаблон имени файла;
|
|
110
|
+
- число соединений с YouTube.
|
|
111
|
+
|
|
112
|
+
**Сервер ничего не сохраняет.** Файл передаётся потоком (HTTP streaming):
|
|
113
|
+
|
|
114
|
+
1. Сначала скачиваются только заголовки и оглавления форматов (`sidx` / `Cues`). По ним
|
|
115
|
+
заранее рассчитывается весь файл: новый заголовок, порядок фрагментов и точный размер,
|
|
116
|
+
поэтому браузер сразу видит `Content-Length` и показывает прогресс.
|
|
117
|
+
2. Фрагменты качаются с googlevideo параллельно, в ограниченном окне памяти (~80 МиБ на
|
|
118
|
+
загрузку). На лету правятся номера дорожек и времена, и всё сразу пишется в ответ.
|
|
119
|
+
Результат побайтно совпадает с файлом, который склеил бы встроенный муксер.
|
|
120
|
+
3. MP3 кодируется ffmpeg прямо из потока и передаётся частями (`Transfer-Encoding: chunked`).
|
|
121
|
+
|
|
122
|
+
**Подтверждение доставки.** После последнего байта сервер закрывает свою сторону соединения
|
|
123
|
+
и ждёт, пока браузер закроет свою. Браузер закрывает соединение только после того, как
|
|
124
|
+
прочитал всё, поэтому файл помечается «Доставлено» только при настоящем подтверждении.
|
|
125
|
+
|
|
126
|
+
Другие исходы:
|
|
127
|
+
|
|
128
|
+
- сброс соединения означает «Прервано», и ту же ссылку можно открыть снова;
|
|
129
|
+
- если браузер молчит 60 с, статус будет «Отправлено».
|
|
130
|
+
|
|
131
|
+
Ссылка на скачивание одноразовая и живёт час. Страница следит за статусом через
|
|
132
|
+
`/api/status`.
|
|
133
|
+
|
|
134
|
+
| Запрос | Что делает |
|
|
135
|
+
|---|---|
|
|
136
|
+
| `GET /api/info?url=` | название, длительность, все форматы с размерами |
|
|
137
|
+
| `POST /api/jobs` | параметры → токен, имя файла, точный размер |
|
|
138
|
+
| `GET /dl/<токен>` | сам файл, потоком |
|
|
139
|
+
| `GET /api/status?t=a,b` | состояние загрузок: передано байт, скорость, статус |
|
|
140
|
+
|
|
141
|
+
Замер: 4K-видео на 232 МиБ доходит до браузера за 3.8 с (~60 МиБ/с).
|
|
142
|
+
|
|
143
|
+
## Почему быстро
|
|
144
|
+
|
|
145
|
+
- **Один запрос к API.** Нет загрузки watch-страницы и base.js: InnerTube-клиент `VISIONOS`
|
|
146
|
+
отдаёт прямые ссылки (до 4K, без подписи и без `n`-параметра) примерно за 0.25 с.
|
|
147
|
+
- **Параллельная загрузка.** Файл качается в 16 потоков, у каждого постоянное
|
|
148
|
+
HTTPS-соединение.
|
|
149
|
+
- **Куски под скорость сети.** Каждое соединение замеряет свою скорость и берёт следующий
|
|
150
|
+
кусок примерно на 2 секунды загрузки:
|
|
151
|
+
- на 60 Мбит/с это ~1 МиБ;
|
|
152
|
+
- на гигабите 8 МиБ, это потолок: googlevideo режет скорость на диапазонах больше ~10 МБ;
|
|
153
|
+
- к концу файла куски дробятся, чтобы все соединения закончили вместе.
|
|
154
|
+
- **Сразу в готовый файл.** Видео и звук YouTube качаются не в `.part`-файлы с последующей
|
|
155
|
+
склейкой. По оглавлениям форматов (`sidx` / `Cues`) итоговый файл рассчитывается заранее,
|
|
156
|
+
и каждый кусок пишется прямо на своё место. После загрузки правятся только заголовки
|
|
157
|
+
фрагментов (несколько КиБ). Каждый байт скачивается и пишется на диск один раз.
|
|
158
|
+
- **Без записи нулей.** Windows при увеличении файла физически пишет нули: 3 ГБ нулей
|
|
159
|
+
перед загрузкой выглядят как «фоновая закачка». Файл создаётся разреженным (NTFS
|
|
160
|
+
sparse), и его размер задаётся мгновенно.
|
|
161
|
+
- **MP3 без промежуточного файла.** Звук идёт из сети прямо в ffmpeg.
|
|
162
|
+
- **Без перезапуска.** Протухшую ссылку (HTTP 403) обновляет новый запрос к `/player`, и
|
|
163
|
+
загрузка продолжается с того же места.
|
|
164
|
+
|
|
165
|
+
## IPv4 и IPv6
|
|
166
|
+
|
|
167
|
+
YouTube проверяет каждый адрес отдельно. У домашнего подключения общий IPv4-адрес, а у каждого
|
|
168
|
+
устройства свой IPv6, и Windows по умолчанию предпочитает IPv6. Если на IPv6-адрес YouTube
|
|
169
|
+
отвечает bot-check («Sign in to confirm you're not a bot»), fast-dlp сам переключает весь
|
|
170
|
+
процесс на IPv4 и запоминает это на 6 часов (`%LOCALAPPDATA%\fast-dlp\route.json`).
|
|
171
|
+
Переключается весь процесс сразу, потому что ссылки на поток привязаны к адресу, с которого
|
|
172
|
+
их запросили. Флаги `-4` / `-6` задают семейство адресов вручную.
|
|
173
|
+
|
|
174
|
+
## Возрастные видео
|
|
175
|
+
|
|
176
|
+
Если VISIONOS отвечает `LOGIN_REQUIRED`, fast-dlp переходит на клиент `TVHTML5` (Tizen,
|
|
177
|
+
версия `5.<дата>`) с OAuth-токеном аккаунта:
|
|
178
|
+
|
|
179
|
+
- client_id и client_secret берутся из бандла `youtube.com/tv` (кэш 6 ч);
|
|
180
|
+
- refresh token меняется на access token (кэш до истечения срока);
|
|
181
|
+
- `signatureCipher` и `n` расшифровываются через base.js: верхнеуровневые побочные эффекты
|
|
182
|
+
вырезаются, а сборщик ссылок с `.set("alr","yes")` вызывается во внешнем JS-рантайме.
|
|
183
|
+
|
|
184
|
+
```
|
|
185
|
+
fast-dlp login # код устройства на google.com/device
|
|
186
|
+
fast-dlp URL --refresh-token TOKEN # или готовый refresh token (сохраняется)
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
Токен можно передать и через переменную `FAST_DLP_REFRESH_TOKEN`.
|
|
190
|
+
|
|
191
|
+
## Spotify
|
|
192
|
+
|
|
193
|
+
```
|
|
194
|
+
fast-dlp https://open.spotify.com/track/TRACK_ID
|
|
195
|
+
fast-dlp https://open.spotify.com/playlist/PLAYLIST_ID -I 1-10,15
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
Звук берётся с YouTube, Spotify даёт только данные о треке. Ключи не нужны: данные (с ISRC)
|
|
199
|
+
приходят через бэкенд CDisc (`https://2281273.xyz/spotify?url=…&beta=true`, сырой JSON
|
|
200
|
+
Spotify). Свой адрес задаёт переменная `FAST_DLP_SPOTIFY_BACKEND`.
|
|
201
|
+
|
|
202
|
+
Можно использовать и свои ключи Web API: приложение создаётся на
|
|
203
|
+
https://developer.spotify.com/dashboard, ключи вводятся командой `fast-dlp spotify-setup`
|
|
204
|
+
или задаются переменными `FAST_DLP_SPOTIFY_ID` / `FAST_DLP_SPOTIFY_SECRET`. С ключами
|
|
205
|
+
Spotify участвует и в общем поиске.
|
|
206
|
+
|
|
207
|
+
Источники данных перебираются по порядку: свои ключи → бэкенд → публичная embed-страница
|
|
208
|
+
(без ISRC).
|
|
209
|
+
|
|
210
|
+
Как трек находится на YouTube Music:
|
|
211
|
+
|
|
212
|
+
1. По **ISRC**. Результат принимается, только если длительность отличается не больше чем
|
|
213
|
+
на 5 с и совпадает название или артист.
|
|
214
|
+
2. Поиск «артист + название» с фильтром «песни»: оценивается сходство названия, артиста и
|
|
215
|
+
разница в длительности (не больше 15 с).
|
|
216
|
+
3. То же с фильтром «видео»: клипы и перезаливы.
|
|
217
|
+
|
|
218
|
+
У треков плейлиста из бэкенда нет обложки и даты, поэтому они догружаются перед
|
|
219
|
+
скачиванием каждого трека. Редакционные плейлисты Spotify (`37i9…`) берутся с
|
|
220
|
+
embed-страницы.
|
|
221
|
+
|
|
222
|
+
## Другие источники
|
|
223
|
+
|
|
224
|
+
| Источник | Что умеет | Вход |
|
|
225
|
+
|---|---|---|
|
|
226
|
+
| **Яндекс Музыка** | трек, альбом, плейлист. С токеном файл берётся прямо с Яндекса (MP3 320 при Плюсе); без токена трек ищется на YouTube | `fast-dlp yandex-login`, необязательно |
|
|
227
|
+
| **VK Музыка** | трек, плейлист, альбом. HLS с AES-128 расшифровывается встроенным AES, MP3 достаётся из MPEG-TS без перекодирования | `fast-dlp vk-setup` |
|
|
228
|
+
| **SoundCloud** | трек, сет (плейлист/альбом), теги и обложка 500×500 | нет |
|
|
229
|
+
| **TikTok** | видео без водяного знака (h264, `--codec hevc` — h265), фото-посты, `-x` — оригинальный звук, короткие ссылки | нет |
|
|
230
|
+
| **Pinterest** | видео, истории, картинки в оригинале | нет |
|
|
231
|
+
| **Pornhub** | видео: лучший MP4 не выше `-q`, качается параллельно по диапазонам (сайт режет скорость на одно соединение); если MP4 нет, берётся HLS. Где страна требует настоящую проверку возраста, fast-dlp сообщает об этом и ничего не обходит | нет |
|
|
232
|
+
| **Steam Workshop** | предмет или коллекция. Старые предметы — по прямой ссылке, SteamPipe — через `steamcmd`, который скачивается сам. Для платных игр: `--steam-user ЛОГИН`, пароль и Steam Guard вводятся в steamcmd один раз | для платных игр |
|
|
233
|
+
| **Любой файл / .m3u8** | прямые ссылки — в N потоков по диапазонам; HLS — сегменты параллельно, с AES-128 | нет |
|
|
234
|
+
|
|
235
|
+
Токены лежат в `%APPDATA%\fast-dlp\` (`yandex.json`, `vk.json`); можно задать и через
|
|
236
|
+
`FAST_DLP_YANDEX_TOKEN` / `FAST_DLP_VK_TOKEN`.
|
|
237
|
+
|
|
238
|
+
AES написан на чистом Python и сверен с векторами FIPS-197 и NIST SP 800-38A. Один поток даёт
|
|
239
|
+
~1.6 МиБ/с, поэтому большие объёмы расшифровываются в пуле процессов на всех ядрах.
|
|
240
|
+
|
|
241
|
+
## Поиск сразу по всем источникам
|
|
242
|
+
|
|
243
|
+
```
|
|
244
|
+
fast-dlp исполнитель - название
|
|
245
|
+
```
|
|
246
|
+
|
|
247
|
+
Если в аргументах нет ни одной ссылки, они считаются поисковым запросом. YouTube Music,
|
|
248
|
+
Spotify, Яндекс Музыка, YouTube и SoundCloud опрашиваются параллельно, весь поиск занимает
|
|
249
|
+
около 1 с. Результаты открываются в экране выбора: у каждого видно источник и длительность,
|
|
250
|
+
отмечен лучший. С `-y` или без терминала сразу скачивается лучший результат.
|
|
251
|
+
|
|
252
|
+
## Выбор треков в терминале
|
|
253
|
+
|
|
254
|
+
Ссылка на альбом или плейлист открывает экран выбора:
|
|
255
|
+
|
|
256
|
+
```
|
|
257
|
+
Spotify · «Альбом» · 12 выбрано 11 из 12
|
|
258
|
+
─ Треки ──────────────────────────────────────────────
|
|
259
|
+
▸ [x] 1 Трек 1 — Исполнитель 3:41
|
|
260
|
+
[ ] 2 Трек 2 — Исполнитель 4:05
|
|
261
|
+
─ Параметры ──────────────────────────────────────────
|
|
262
|
+
Формат ◀ mp3 ▶
|
|
263
|
+
Качество MP3 ◀ 320k ▶
|
|
264
|
+
Параллельно ◀ 4 ▶
|
|
265
|
+
Теги / Обложка ◀ да ▶
|
|
266
|
+
Уже скачанные ◀ пропускать ▶
|
|
267
|
+
```
|
|
268
|
+
|
|
269
|
+
| Клавиша | Действие |
|
|
270
|
+
|---|---|
|
|
271
|
+
| ↑ ↓, Home/End, PgUp/PgDn | перемещение |
|
|
272
|
+
| Пробел | отметить / снять трек |
|
|
273
|
+
| ← → | на параметре: менять значение; на треках: листать страницами |
|
|
274
|
+
| A / N / I | все / ничего / инвертировать |
|
|
275
|
+
| Enter | скачать отмеченное |
|
|
276
|
+
| Esc / Q | отмена |
|
|
277
|
+
|
|
278
|
+
После Enter открывается живая таблица: у каждого трека свой статус (в очереди / качается /
|
|
279
|
+
готово / уже было / ошибка), внизу последние строки лога.
|
|
280
|
+
|
|
281
|
+
`-y` качает всё без экрана выбора, `--select` открывает его всегда. С `-I` или без
|
|
282
|
+
терминала экран не открывается.
|
|
283
|
+
|
|
284
|
+
## Плейлисты и альбомы
|
|
285
|
+
|
|
286
|
+
```
|
|
287
|
+
fast-dlp "https://www.youtube.com/playlist?list=PLAYLIST_ID"
|
|
288
|
+
fast-dlp https://open.spotify.com/album/ALBUM_ID
|
|
289
|
+
fast-dlp https://open.spotify.com/playlist/PLAYLIST_ID -I 1-10,15 # только эти номера
|
|
290
|
+
```
|
|
291
|
+
|
|
292
|
+
Плейлист YouTube читается через InnerTube `/browse` со всеми продолжениями (913 видео за
|
|
293
|
+
6.8 с). Файлы раскладываются в папку `{playlist}/` с номерами `{index}`. Элементы качаются
|
|
294
|
+
по 4 сразу (`-J`): альбом из 14 треков в MP3 — за 18 с вместо 52. Уже скачанные файлы
|
|
295
|
+
пропускаются ещё до запроса к YouTube, `-w` качает всё заново.
|
|
296
|
+
|
|
297
|
+
## Синхронизация плейлистов
|
|
298
|
+
|
|
299
|
+
```
|
|
300
|
+
fast-dlp sync https://open.spotify.com/playlist/PLAYLIST_ID
|
|
301
|
+
fast-dlp sync "https://www.youtube.com/playlist?list=PLAYLIST_ID" --sync-dir D:\Music\Mix -x
|
|
302
|
+
```
|
|
303
|
+
|
|
304
|
+
Новые треки докачиваются, убранные из плейлиста удаляются. Удаляются только файлы, которые
|
|
305
|
+
создал sync (они записаны в `.fast-dlp-sync.json`); `--sync-keep` не удаляет ничего. Рядом
|
|
306
|
+
пишется `<плейлист>.m3u8`. Повторный запуск без изменений занимает меньше секунды — удобно
|
|
307
|
+
для планировщика.
|
|
308
|
+
|
|
309
|
+
## Отрывок видео без ffmpeg
|
|
310
|
+
|
|
311
|
+
```
|
|
312
|
+
fast-dlp URL --section 3:40-5:10
|
|
313
|
+
fast-dlp URL --section 1:00:00- # с часа до конца
|
|
314
|
+
fast-dlp "https://youtu.be/VIDEO_ID?t=220" --section t # с отметки t= в ссылке
|
|
315
|
+
```
|
|
316
|
+
|
|
317
|
+
По оглавлению формата (`sidx` в MP4, `Cues` в WebM) скачиваются только байты нужного
|
|
318
|
+
отрывка, а муксер переносит время к нулю. Отрывок 30 с из 4-минутного 1080p — 13 МБ вместо
|
|
319
|
+
80. Резка идёт по ключевым кадрам, как у `ffmpeg -c copy`, без перекодирования.
|
|
320
|
+
|
|
321
|
+
## Тексты песен и громкость
|
|
322
|
+
|
|
323
|
+
- **Тексты** берутся из LRCLIB, синхронизированные (LRC), если есть. Для музыки включено по
|
|
324
|
+
умолчанию, для видео — флагом `--lyrics`. Вшиваются в MP3 (`USLT`), M4A (`©lyr`) и
|
|
325
|
+
WebM/MKV. `--write-lyrics` сохраняет ещё и `.lrc`, `--no-lyrics` отключает.
|
|
326
|
+
- **ReplayGain** без анализа файла: YouTube сам сообщает громкость трека, из неё получается
|
|
327
|
+
усиление ReplayGain 2.0 (опора −18 LUFS). `--no-replaygain` отключает.
|
|
328
|
+
|
|
329
|
+
## Субтитры, главы, эфиры (YouTube)
|
|
330
|
+
|
|
331
|
+
```
|
|
332
|
+
fast-dlp URL --embed-subs --sub-langs en,ru
|
|
333
|
+
fast-dlp URL --write-subs --write-auto-subs --sub-langs all --sub-format vtt
|
|
334
|
+
fast-dlp URL --embed-chapters --sponsorblock-mark all
|
|
335
|
+
fast-dlp URL --write-info-json --write-description --write-thumbnail --write-comments
|
|
336
|
+
fast-dlp LIVE_URL --live-duration 600 # записать эфир 10 минут
|
|
337
|
+
fast-dlp LIVE_URL --live-from-start # с начала окна DVR
|
|
338
|
+
fast-dlp "https://www.youtube.com/@CHANNEL" # канал
|
|
339
|
+
fast-dlp "ytsearch10:запрос" -x # поиск по YouTube
|
|
340
|
+
fast-dlp URL --download-archive done.txt # не качать уже скачанное
|
|
341
|
+
fast-dlp URL --proxy http://user:pass@host:8080
|
|
342
|
+
```
|
|
343
|
+
|
|
344
|
+
- **Субтитры** — ручные и автоматические, встраиваются без ffmpeg (MP4 — `tx3g`, MKV — SRT).
|
|
345
|
+
- **Главы** — из маркеров плеера или таймкодов в описании; **SponsorBlock** размечает
|
|
346
|
+
рекламу, интро и т. д.
|
|
347
|
+
- **Эфиры** записываются через HLS, пока трансляция не кончится или не нажат Ctrl+C.
|
|
348
|
+
- **Запасной HLS** до 4K включается сам, если прямые ссылки не работают (`--hls` —
|
|
349
|
+
принудительно).
|
|
350
|
+
- **Побочные файлы:** `.info.json`, `.description`, `.jpg`, `.comments.json`.
|
|
351
|
+
- **Шаблон имени:** `{title} {id} {uploader} {channel} {upload_date} {year} {duration}
|
|
352
|
+
{height} {resolution} {playlist} {playlist_index} {album} {artist} {track_number} {site}
|
|
353
|
+
{ext}` и другие. Работает форматирование Python: `{playlist_index:03d}`. Неизвестное поле
|
|
354
|
+
становится `NA`, `/` создаёт папки.
|
|
355
|
+
|
|
356
|
+
## Теги и обложки
|
|
357
|
+
|
|
358
|
+
Теги пишутся без ffmpeg:
|
|
359
|
+
|
|
360
|
+
- **MP4/M4A** — атомы iTunes (`©nam ©ART ©alb aART ©day trkn ©cmt covr`);
|
|
361
|
+
- **WebM** — Matroska `Tags`, обложка во вложении;
|
|
362
|
+
- **MP3** — ID3v2.3, обложка во фрейме APIC.
|
|
363
|
+
|
|
364
|
+
Обложка по умолчанию встраивается только в аудио; `--embed-thumbnail` — и в видео,
|
|
365
|
+
`--no-cover` / `--no-metadata` отключают.
|
|
366
|
+
|
|
367
|
+
## MP3
|
|
368
|
+
|
|
369
|
+
```
|
|
370
|
+
fast-dlp URL --audio-format mp3 # 320k CBR
|
|
371
|
+
fast-dlp URL --audio-format mp3 --audio-quality V0
|
|
372
|
+
```
|
|
373
|
+
|
|
374
|
+
YouTube не отдаёт MP3, поэтому нужен ffmpeg (libmp3lame): трёхминутный трек кодируется за
|
|
375
|
+
~2 с. `--audio-format opus` / `m4a` берут поток без перекодирования.
|
|
376
|
+
|
|
377
|
+
## Склейка без ffmpeg
|
|
378
|
+
|
|
379
|
+
Обычно отдельной склейки нет: файл собирается прямо при загрузке (см. «Почему быстро»).
|
|
380
|
+
Встроенный муксер работает, когда нужны встроенные субтитры или главы, с `--keep-parts`
|
|
381
|
+
и для запасного пути HLS. Он только копирует данные, ничего не перекодирует:
|
|
382
|
+
|
|
383
|
+
- **WebM + WebM** (vp9/av01 + opus): кластеры чередуются по времени, Cues и SeekHead
|
|
384
|
+
пишутся заново.
|
|
385
|
+
- **MP4 + M4A** (фрагментированные): один `moov` с двумя дорожками, `moof+mdat`
|
|
386
|
+
чередуются по времени.
|
|
387
|
+
|
|
388
|
+
| Что | Размер | Время |
|
|
389
|
+
|---|---|---|
|
|
390
|
+
| 4K60 vp9 + opus → .webm | 1.3 ГБ | 0.90 с |
|
|
391
|
+
| 4K vp9 + opus → .webm | 345 МиБ | 0.14 с |
|
|
392
|
+
| 1080p60 avc1 + aac → .mp4 | 255 МиБ | 0.11 с |
|
|
393
|
+
|
|
394
|
+
Потоки побитово совпадают с исходными. ffmpeg нужен только для смешанных контейнеров
|
|
395
|
+
(`-f 398+251`) или с `--merger ffmpeg`.
|
|
396
|
+
|
|
397
|
+
## Тесты
|
|
398
|
+
|
|
399
|
+
```
|
|
400
|
+
py -m unittest discover -s tests -t . # 104 теста без сети, ~4 с
|
|
401
|
+
set FAST_DLP_NETWORK=1 && py -m unittest discover -s tests -t . # + живые проверки
|
|
402
|
+
```
|
|
403
|
+
|
|
404
|
+
## Устройство
|
|
405
|
+
|
|
406
|
+
| Файл | Что делает |
|
|
407
|
+
|---|---|
|
|
408
|
+
| `fast_dlp/innertube.py` | клиенты VISIONOS / TVHTML5, запрос `/player` |
|
|
409
|
+
| `fast_dlp/oauth.py` | вход по коду устройства, refresh |
|
|
410
|
+
| `fast_dlp/cipher.py` | подготовка base.js, решатель sig/n |
|
|
411
|
+
| `fast_dlp/extractor.py` | VISIONOS → (возрастное) → TV + OAuth |
|
|
412
|
+
| `fast_dlp/download.py` | многопоточная загрузка по диапазонам |
|
|
413
|
+
| `fast_dlp/formats.py` | выбор форматов, таблица `-F` |
|
|
414
|
+
| `fast_dlp/mux.py` | склейка WebM и fMP4, теги и обложки |
|
|
415
|
+
| `fast_dlp/mp3.py` | MP3 через ffmpeg, свой ID3v2.3 |
|
|
416
|
+
| `fast_dlp/playlist.py` | плейлисты, каналы, поиск YouTube |
|
|
417
|
+
| `fast_dlp/spotify.py` | Spotify: свои ключи / бэкенд CDisc / embed-страница |
|
|
418
|
+
| `fast_dlp/ytmusic.py` | поиск YouTube Music и сопоставление трека |
|
|
419
|
+
| `fast_dlp/sources/` | Яндекс, VK, SoundCloud, TikTok, Pinterest, Pornhub, Steam, любые файлы |
|
|
420
|
+
| `fast_dlp/hls.py` | HLS, AES-128, запись эфиров |
|
|
421
|
+
| `fast_dlp/ytmeta.py` | дата, главы, комментарии, субтитры, SponsorBlock |
|
|
422
|
+
| `fast_dlp/search.py` | поиск по всем источникам |
|
|
423
|
+
| `fast_dlp/section.py` | отрывок по времени |
|
|
424
|
+
| `fast_dlp/sync.py` | синхронизация с плейлистом |
|
|
425
|
+
| `fast_dlp/lyrics.py` | тексты LRCLIB, ReplayGain |
|
|
426
|
+
| `fast_dlp/postprocess.py` | шаблон имени, побочные файлы, архив |
|
|
427
|
+
| `fast_dlp/aes.py` | AES-128-CBC на чистом Python |
|
|
428
|
+
| `fast_dlp/ts.py` | разбор MPEG-TS |
|
|
429
|
+
| `fast_dlp/tui.py` | экран выбора и таблица загрузок |
|
|
430
|
+
| `fast_dlp/stream.py` | файл потоком: план по индексам, параллельные фрагменты, правка на лету |
|
|
431
|
+
| `fast_dlp/web/` | сайт: сервер, одноразовые ссылки, подтверждение доставки, страница |
|
|
432
|
+
| `fast_dlp/cli.py` | командная строка |
|
|
433
|
+
|
|
434
|
+
Кэш: `%LOCALAPPDATA%\fast-dlp`. Токены и настройки: `%APPDATA%\fast-dlp`.
|
|
435
|
+
|
|
436
|
+
## Лицензия
|
|
437
|
+
|
|
438
|
+
MIT, см. [LICENSE](LICENSE).
|