douyin-dl-cli 2.1.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.
- douyin_dl_cli-2.1.0/LICENSE +21 -0
- douyin_dl_cli-2.1.0/PKG-INFO +258 -0
- douyin_dl_cli-2.1.0/README.md +215 -0
- douyin_dl_cli-2.1.0/agent_mode/__init__.py +1 -0
- douyin_dl_cli-2.1.0/agent_mode/__main__.py +8 -0
- douyin_dl_cli-2.1.0/agent_mode/auth_cmds.py +178 -0
- douyin_dl_cli-2.1.0/agent_mode/capabilities.py +84 -0
- douyin_dl_cli-2.1.0/agent_mode/discovery_cmds.py +152 -0
- douyin_dl_cli-2.1.0/agent_mode/discovery_common.py +33 -0
- douyin_dl_cli-2.1.0/agent_mode/discovery_search.py +182 -0
- douyin_dl_cli-2.1.0/agent_mode/entry.py +299 -0
- douyin_dl_cli-2.1.0/agent_mode/envelope.py +235 -0
- douyin_dl_cli-2.1.0/agent_mode/events.py +113 -0
- douyin_dl_cli-2.1.0/agent_mode/inspect_cmd.py +130 -0
- douyin_dl_cli-2.1.0/agent_mode/logging_guard.py +29 -0
- douyin_dl_cli-2.1.0/agent_mode/login_cmd.py +204 -0
- douyin_dl_cli-2.1.0/agent_mode/login_import.py +128 -0
- douyin_dl_cli-2.1.0/agent_mode/media_cmds.py +49 -0
- douyin_dl_cli-2.1.0/agent_mode/media_live.py +277 -0
- douyin_dl_cli-2.1.0/agent_mode/media_live_recovery.py +174 -0
- douyin_dl_cli-2.1.0/agent_mode/media_transcribe.py +272 -0
- douyin_dl_cli-2.1.0/agent_mode/state.py +199 -0
- douyin_dl_cli-2.1.0/agent_mode/version.py +33 -0
- douyin_dl_cli-2.1.0/auth/__init__.py +4 -0
- douyin_dl_cli-2.1.0/auth/cookie_manager.py +75 -0
- douyin_dl_cli-2.1.0/auth/ms_token_conf.py +148 -0
- douyin_dl_cli-2.1.0/auth/ms_token_manager.py +236 -0
- douyin_dl_cli-2.1.0/cli/__init__.py +3 -0
- douyin_dl_cli-2.1.0/cli/login_flow.py +70 -0
- douyin_dl_cli-2.1.0/cli/main.py +530 -0
- douyin_dl_cli-2.1.0/cli/progress_display.py +314 -0
- douyin_dl_cli-2.1.0/cli/whisper_transcribe.py +533 -0
- douyin_dl_cli-2.1.0/config/__init__.py +4 -0
- douyin_dl_cli-2.1.0/config/config_loader.py +381 -0
- douyin_dl_cli-2.1.0/config/default_config.py +126 -0
- douyin_dl_cli-2.1.0/control/__init__.py +5 -0
- douyin_dl_cli-2.1.0/control/queue_manager.py +148 -0
- douyin_dl_cli-2.1.0/control/rate_limiter.py +28 -0
- douyin_dl_cli-2.1.0/control/retry_handler.py +41 -0
- douyin_dl_cli-2.1.0/core/__init__.py +15 -0
- douyin_dl_cli-2.1.0/core/api_client.py +2244 -0
- douyin_dl_cli-2.1.0/core/audio_extraction.py +381 -0
- douyin_dl_cli-2.1.0/core/comments_collector.py +349 -0
- douyin_dl_cli-2.1.0/core/discovery.py +127 -0
- douyin_dl_cli-2.1.0/core/downloader_base.py +1820 -0
- douyin_dl_cli-2.1.0/core/downloader_factory.py +85 -0
- douyin_dl_cli-2.1.0/core/ffmpeg.py +21 -0
- douyin_dl_cli-2.1.0/core/item_reasons.py +112 -0
- douyin_dl_cli-2.1.0/core/live_downloader.py +173 -0
- douyin_dl_cli-2.1.0/core/live_finalize.py +218 -0
- douyin_dl_cli-2.1.0/core/live_process.py +168 -0
- douyin_dl_cli-2.1.0/core/live_replay_downloader.py +349 -0
- douyin_dl_cli-2.1.0/core/live_session.py +300 -0
- douyin_dl_cli-2.1.0/core/live_streams.py +91 -0
- douyin_dl_cli-2.1.0/core/metadata.py +96 -0
- douyin_dl_cli-2.1.0/core/mix_downloader.py +183 -0
- douyin_dl_cli-2.1.0/core/music_downloader.py +243 -0
- douyin_dl_cli-2.1.0/core/output_naming.py +70 -0
- douyin_dl_cli-2.1.0/core/retry_executor.py +274 -0
- douyin_dl_cli-2.1.0/core/silent_audio.py +110 -0
- douyin_dl_cli-2.1.0/core/transcript_manager.py +424 -0
- douyin_dl_cli-2.1.0/core/url_parser.py +156 -0
- douyin_dl_cli-2.1.0/core/user_downloader.py +745 -0
- douyin_dl_cli-2.1.0/core/user_mode_registry.py +34 -0
- douyin_dl_cli-2.1.0/core/user_modes/__init__.py +17 -0
- douyin_dl_cli-2.1.0/core/user_modes/base_strategy.py +495 -0
- douyin_dl_cli-2.1.0/core/user_modes/collect_mix_strategy.py +67 -0
- douyin_dl_cli-2.1.0/core/user_modes/collect_strategy.py +158 -0
- douyin_dl_cli-2.1.0/core/user_modes/like_strategy.py +6 -0
- douyin_dl_cli-2.1.0/core/user_modes/mix_routing.py +49 -0
- douyin_dl_cli-2.1.0/core/user_modes/mix_strategy.py +84 -0
- douyin_dl_cli-2.1.0/core/user_modes/music_strategy.py +25 -0
- douyin_dl_cli-2.1.0/core/user_modes/post_strategy.py +486 -0
- douyin_dl_cli-2.1.0/core/user_modes/post_time_boundary.py +75 -0
- douyin_dl_cli-2.1.0/core/video_downloader.py +76 -0
- douyin_dl_cli-2.1.0/douyin_dl_cli.egg-info/PKG-INFO +258 -0
- douyin_dl_cli-2.1.0/douyin_dl_cli.egg-info/SOURCES.txt +196 -0
- douyin_dl_cli-2.1.0/douyin_dl_cli.egg-info/dependency_links.txt +1 -0
- douyin_dl_cli-2.1.0/douyin_dl_cli.egg-info/entry_points.txt +2 -0
- douyin_dl_cli-2.1.0/douyin_dl_cli.egg-info/requires.txt +30 -0
- douyin_dl_cli-2.1.0/douyin_dl_cli.egg-info/top_level.txt +10 -0
- douyin_dl_cli-2.1.0/pyproject.toml +96 -0
- douyin_dl_cli-2.1.0/server/__init__.py +13 -0
- douyin_dl_cli-2.1.0/server/app.py +215 -0
- douyin_dl_cli-2.1.0/server/jobs.py +163 -0
- douyin_dl_cli-2.1.0/setup.cfg +4 -0
- douyin_dl_cli-2.1.0/storage/__init__.py +5 -0
- douyin_dl_cli-2.1.0/storage/database.py +815 -0
- douyin_dl_cli-2.1.0/storage/file_manager.py +563 -0
- douyin_dl_cli-2.1.0/storage/live_recordings.py +148 -0
- douyin_dl_cli-2.1.0/storage/metadata_handler.py +51 -0
- douyin_dl_cli-2.1.0/tests/test_agent_capabilities_drift.py +115 -0
- douyin_dl_cli-2.1.0/tests/test_agent_contract.py +206 -0
- douyin_dl_cli-2.1.0/tests/test_agent_discovery.py +296 -0
- douyin_dl_cli-2.1.0/tests/test_agent_discovery_edges.py +68 -0
- douyin_dl_cli-2.1.0/tests/test_agent_entry_args.py +104 -0
- douyin_dl_cli-2.1.0/tests/test_agent_envelope.py +286 -0
- douyin_dl_cli-2.1.0/tests/test_agent_live_lock.py +125 -0
- douyin_dl_cli-2.1.0/tests/test_agent_local_verbs.py +188 -0
- douyin_dl_cli-2.1.0/tests/test_agent_login.py +300 -0
- douyin_dl_cli-2.1.0/tests/test_agent_media.py +288 -0
- douyin_dl_cli-2.1.0/tests/test_agent_signals.py +173 -0
- douyin_dl_cli-2.1.0/tests/test_agent_state.py +160 -0
- douyin_dl_cli-2.1.0/tests/test_agent_transcribe.py +268 -0
- douyin_dl_cli-2.1.0/tests/test_api_client.py +1692 -0
- douyin_dl_cli-2.1.0/tests/test_api_client_login_required.py +160 -0
- douyin_dl_cli-2.1.0/tests/test_api_client_risk_control.py +385 -0
- douyin_dl_cli-2.1.0/tests/test_audio_extraction.py +560 -0
- douyin_dl_cli-2.1.0/tests/test_cli_exit_codes.py +247 -0
- douyin_dl_cli-2.1.0/tests/test_cli_main.py +207 -0
- douyin_dl_cli-2.1.0/tests/test_comments_collector.py +305 -0
- douyin_dl_cli-2.1.0/tests/test_comments_download_behavior.py +416 -0
- douyin_dl_cli-2.1.0/tests/test_config_loader.py +333 -0
- douyin_dl_cli-2.1.0/tests/test_config_loader_save.py +122 -0
- douyin_dl_cli-2.1.0/tests/test_config_validation.py +27 -0
- douyin_dl_cli-2.1.0/tests/test_cookie_fetcher.py +166 -0
- douyin_dl_cli-2.1.0/tests/test_cookie_fetcher_fetch.py +29 -0
- douyin_dl_cli-2.1.0/tests/test_cookie_manager.py +51 -0
- douyin_dl_cli-2.1.0/tests/test_cookie_utils.py +28 -0
- douyin_dl_cli-2.1.0/tests/test_database.py +485 -0
- douyin_dl_cli-2.1.0/tests/test_database_history.py +331 -0
- douyin_dl_cli-2.1.0/tests/test_database_migration.py +386 -0
- douyin_dl_cli-2.1.0/tests/test_database_top_authors.py +331 -0
- douyin_dl_cli-2.1.0/tests/test_discovery.py +105 -0
- douyin_dl_cli-2.1.0/tests/test_download_progress_and_deadline.py +220 -0
- douyin_dl_cli-2.1.0/tests/test_download_proxy_passthrough.py +126 -0
- douyin_dl_cli-2.1.0/tests/test_download_slow_node_guard.py +264 -0
- douyin_dl_cli-2.1.0/tests/test_downloader_author_sec_uid.py +422 -0
- douyin_dl_cli-2.1.0/tests/test_downloader_base_perf.py +383 -0
- douyin_dl_cli-2.1.0/tests/test_downloader_factory.py +52 -0
- douyin_dl_cli-2.1.0/tests/test_downloader_naming_templates.py +281 -0
- douyin_dl_cli-2.1.0/tests/test_downloader_output_dir_report.py +104 -0
- douyin_dl_cli-2.1.0/tests/test_file_manager.py +697 -0
- douyin_dl_cli-2.1.0/tests/test_filename_sanitization.py +74 -0
- douyin_dl_cli-2.1.0/tests/test_item_reasons.py +492 -0
- douyin_dl_cli-2.1.0/tests/test_live_downloader.py +258 -0
- douyin_dl_cli-2.1.0/tests/test_live_downloader_integration.py +115 -0
- douyin_dl_cli-2.1.0/tests/test_live_install.py +56 -0
- douyin_dl_cli-2.1.0/tests/test_live_recording_engine.py +180 -0
- douyin_dl_cli-2.1.0/tests/test_live_recording_recovery.py +155 -0
- douyin_dl_cli-2.1.0/tests/test_live_replay_downloader.py +267 -0
- douyin_dl_cli-2.1.0/tests/test_live_replay_remux.py +194 -0
- douyin_dl_cli-2.1.0/tests/test_live_room_ssr.py +102 -0
- douyin_dl_cli-2.1.0/tests/test_live_session_control.py +278 -0
- douyin_dl_cli-2.1.0/tests/test_logger.py +51 -0
- douyin_dl_cli-2.1.0/tests/test_login_flow.py +65 -0
- douyin_dl_cli-2.1.0/tests/test_lvdetail_gate.py +64 -0
- douyin_dl_cli-2.1.0/tests/test_manifest_author_fields.py +312 -0
- douyin_dl_cli-2.1.0/tests/test_media_quality.py +310 -0
- douyin_dl_cli-2.1.0/tests/test_mix_downloader.py +571 -0
- douyin_dl_cli-2.1.0/tests/test_mix_routing_completeness.py +172 -0
- douyin_dl_cli-2.1.0/tests/test_ms_token_manager.py +259 -0
- douyin_dl_cli-2.1.0/tests/test_music_downloader.py +164 -0
- douyin_dl_cli-2.1.0/tests/test_naming.py +246 -0
- douyin_dl_cli-2.1.0/tests/test_naming_audio.py +42 -0
- douyin_dl_cli-2.1.0/tests/test_naming_limits.py +278 -0
- douyin_dl_cli-2.1.0/tests/test_notifier.py +154 -0
- douyin_dl_cli-2.1.0/tests/test_notifier_redactor_property.py +286 -0
- douyin_dl_cli-2.1.0/tests/test_original_quality_promotion.py +325 -0
- douyin_dl_cli-2.1.0/tests/test_paid_content.py +190 -0
- douyin_dl_cli-2.1.0/tests/test_post_time_pagination.py +266 -0
- douyin_dl_cli-2.1.0/tests/test_post_walk_completeness.py +566 -0
- douyin_dl_cli-2.1.0/tests/test_progress_display.py +174 -0
- douyin_dl_cli-2.1.0/tests/test_proxy_validator_parity.py +293 -0
- douyin_dl_cli-2.1.0/tests/test_queue_manager.py +302 -0
- douyin_dl_cli-2.1.0/tests/test_rate_limiter.py +66 -0
- douyin_dl_cli-2.1.0/tests/test_relogin_retry.py +78 -0
- douyin_dl_cli-2.1.0/tests/test_retry_handler.py +128 -0
- douyin_dl_cli-2.1.0/tests/test_server.py +175 -0
- douyin_dl_cli-2.1.0/tests/test_silent_audio.py +35 -0
- douyin_dl_cli-2.1.0/tests/test_single_type_item_reasons.py +261 -0
- douyin_dl_cli-2.1.0/tests/test_skill_package.py +128 -0
- douyin_dl_cli-2.1.0/tests/test_time_range_filter.py +58 -0
- douyin_dl_cli-2.1.0/tests/test_time_window_overrides.py +47 -0
- douyin_dl_cli-2.1.0/tests/test_transcript_manager.py +94 -0
- douyin_dl_cli-2.1.0/tests/test_transcript_manager_audio.py +612 -0
- douyin_dl_cli-2.1.0/tests/test_url_parser.py +212 -0
- douyin_dl_cli-2.1.0/tests/test_user_downloader.py +900 -0
- douyin_dl_cli-2.1.0/tests/test_user_downloader_modes.py +545 -0
- douyin_dl_cli-2.1.0/tests/test_user_mix_routing.py +308 -0
- douyin_dl_cli-2.1.0/tests/test_user_mode_registry.py +19 -0
- douyin_dl_cli-2.1.0/tests/test_user_mode_strategies.py +1048 -0
- douyin_dl_cli-2.1.0/tests/test_video_downloader.py +1775 -0
- douyin_dl_cli-2.1.0/tests/test_whisper_safe_stem.py +8 -0
- douyin_dl_cli-2.1.0/tests/test_xbogus.py +11 -0
- douyin_dl_cli-2.1.0/tools/__init__.py +1 -0
- douyin_dl_cli-2.1.0/tools/cookie_fetcher.py +390 -0
- douyin_dl_cli-2.1.0/utils/__init__.py +14 -0
- douyin_dl_cli-2.1.0/utils/abogus.py +865 -0
- douyin_dl_cli-2.1.0/utils/cookie_utils.py +45 -0
- douyin_dl_cli-2.1.0/utils/helpers.py +24 -0
- douyin_dl_cli-2.1.0/utils/logger.py +97 -0
- douyin_dl_cli-2.1.0/utils/naming.py +241 -0
- douyin_dl_cli-2.1.0/utils/naming_limits.py +116 -0
- douyin_dl_cli-2.1.0/utils/notifier.py +293 -0
- douyin_dl_cli-2.1.0/utils/paid_content.py +141 -0
- douyin_dl_cli-2.1.0/utils/validators.py +145 -0
- douyin_dl_cli-2.1.0/utils/xbogus.py +216 -0
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 jiji262
|
|
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.
|
|
@@ -0,0 +1,258 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: douyin-dl-cli
|
|
3
|
+
Version: 2.1.0
|
|
4
|
+
Summary: Douyin batch downloader with no-watermark support
|
|
5
|
+
License: MIT
|
|
6
|
+
Classifier: Development Status :: 4 - Beta
|
|
7
|
+
Classifier: Intended Audience :: End Users/Desktop
|
|
8
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
9
|
+
Classifier: Programming Language :: Python :: 3
|
|
10
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
11
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
12
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
13
|
+
Classifier: Topic :: Multimedia :: Video
|
|
14
|
+
Requires-Python: >=3.10
|
|
15
|
+
Description-Content-Type: text/markdown
|
|
16
|
+
License-File: LICENSE
|
|
17
|
+
Requires-Dist: aiohttp>=3.9.0
|
|
18
|
+
Requires-Dist: httpx>=0.25
|
|
19
|
+
Requires-Dist: aiofiles>=23.2.1
|
|
20
|
+
Requires-Dist: aiosqlite>=0.19.0
|
|
21
|
+
Requires-Dist: rich>=13.7.0
|
|
22
|
+
Requires-Dist: pyyaml>=6.0.1
|
|
23
|
+
Requires-Dist: python-dateutil>=2.8.2
|
|
24
|
+
Requires-Dist: gmssl>=3.2.2
|
|
25
|
+
Requires-Dist: imageio-ffmpeg==0.8.1
|
|
26
|
+
Provides-Extra: browser
|
|
27
|
+
Requires-Dist: playwright>=1.40.0; extra == "browser"
|
|
28
|
+
Provides-Extra: transcribe
|
|
29
|
+
Requires-Dist: openai-whisper>=20231117; extra == "transcribe"
|
|
30
|
+
Provides-Extra: server
|
|
31
|
+
Requires-Dist: fastapi>=0.100; extra == "server"
|
|
32
|
+
Requires-Dist: uvicorn>=0.23; extra == "server"
|
|
33
|
+
Requires-Dist: pydantic>=2.0; extra == "server"
|
|
34
|
+
Provides-Extra: dev
|
|
35
|
+
Requires-Dist: pytest>=7.0; extra == "dev"
|
|
36
|
+
Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
|
|
37
|
+
Requires-Dist: ruff>=0.4.0; extra == "dev"
|
|
38
|
+
Requires-Dist: httpx>=0.25; extra == "dev"
|
|
39
|
+
Requires-Dist: hypothesis>=6.0; extra == "dev"
|
|
40
|
+
Provides-Extra: all
|
|
41
|
+
Requires-Dist: douyin-dl-cli[browser,dev,server,transcribe]; extra == "all"
|
|
42
|
+
Dynamic: license-file
|
|
43
|
+
|
|
44
|
+
<!-- README.md is also the PyPI project page: keep links and images absolute. -->
|
|
45
|
+
# Douyin Downloader
|
|
46
|
+
|
|
47
|
+
<p align="center">
|
|
48
|
+
<img src="https://camo.githubusercontent.com/327409f4eab82516b28e9c67bd4831261917ee9a29ffd865a60996a9c53709cb/68747470733a2f2f736f6369616c6966792e6769742e63692f6a696a693236322f646f7579696e2d646f776e6c6f616465722f696d6167653f637573746f6d5f6465736372697074696f6e3d446f7579696e2b62617463682b646f776e6c6f61642b746f6f6c2532432b72656d6f76652b77617465726d61726b732532432b737570706f72742b62617463682b646f776e6c6f61642b6f662b766964656f732532432b67616c6c6572792532432b616e642b617574686f722b686f6d6570616765732e266465736372697074696f6e3d3126666f6e743d536f757263652b436f64652b50726f26666f726b733d31266f776e65723d31267061747465726e3d436972637569742b426f617264267374617267617a6572733d31267468656d653d4c69676874" alt="douyin-downloader" width="820" />
|
|
49
|
+
</p>
|
|
50
|
+
|
|
51
|
+
[简体中文](https://github.com/jiji262/douyin-downloader/blob/main/README.zh-CN.md) · **English**
|
|
52
|
+
|
|
53
|
+
Download Douyin videos and photos without watermarks. Use **Douzy** for a desktop interface, the **Python CLI** for scripts, or the **[agent skill](#agent--skill-mode)** so AI agents such as Claude Code and Codex can read the hot board, search, and record live streams.
|
|
54
|
+
|
|
55
|
+
## Douzy Desktop
|
|
56
|
+
|
|
57
|
+
A desktop app for **Douyin, TikTok, YouTube, Telegram, and X**. Paste links, track downloads, and browse your local archive.
|
|
58
|
+
|
|
59
|
+
**[Download for Windows / macOS](https://github.com/jiji262/douyin-downloader/releases)**
|
|
60
|
+
|
|
61
|
+
Platform features depend on enabled plugins or local components. Some batch and advanced features require activation.
|
|
62
|
+
|
|
63
|
+
| Platform | Content |
|
|
64
|
+
|:---|:---|
|
|
65
|
+
| Douyin | Videos, photos, profiles, collections; following, subscriptions, favorites, and likes |
|
|
66
|
+
| TikTok | Public videos, photos, and profiles |
|
|
67
|
+
| YouTube | Videos, Shorts, channels, and playlists; audio and subtitles |
|
|
68
|
+
| Telegram | Media from accessible chats, groups, and channels; requires setup and sign-in |
|
|
69
|
+
| X | Posts, profile media, your bookmarks and likes; requires account cookies |
|
|
70
|
+
|
|
71
|
+
| **Douyin** | **TikTok** | **YouTube** |
|
|
72
|
+
|:---:|:---:|:---:|
|
|
73
|
+
| [](https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/001.png) | [](https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/002.png) | [](https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/003.png) |
|
|
74
|
+
| **Telegram setup** | **X** | **Task center** |
|
|
75
|
+
| [](https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/004.png) | [](https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/005.png) | [](https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/006.png) |
|
|
76
|
+
|
|
77
|
+
| **Douyin (light)** | **YouTube (light)** | **Task center (light)** |
|
|
78
|
+
|:---:|:---:|:---:|
|
|
79
|
+
| [](https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/007.png) | [](https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/008.png) | [](https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/009.png) |
|
|
80
|
+
|
|
81
|
+
_Screenshots: Douzy 0.13.0 on macOS (light and dark themes, 1440 × 900, sample data). Telegram is shown before setup. Click an image to enlarge._
|
|
82
|
+
|
|
83
|
+
## CLI Status
|
|
84
|
+
|
|
85
|
+
The CLI supports **Douyin only**. It includes batch downloads, date filters, retries, download history, and optional comments, transcription, and notifications.
|
|
86
|
+
|
|
87
|
+
> **Download limitations:** Douyin's request verification currently blocks CLI downloads of individual videos/photos, collections, music, likes, and favorites. Profile posts can try the Playwright browser fallback, but success is not guaranteed. Use **Douzy** for everyday downloads.
|
|
88
|
+
|
|
89
|
+
Refreshing cookies or retrying does not fix this verification block. Live recording is experimental: FFmpeg records the stream in segments, converts each segment to MP4, and reconnects after drops.
|
|
90
|
+
|
|
91
|
+
## Quick Start
|
|
92
|
+
|
|
93
|
+
Requires **Python 3.10+** on Windows, macOS, or Linux. Read the CLI limitations above first.
|
|
94
|
+
|
|
95
|
+
### 1. Install
|
|
96
|
+
|
|
97
|
+
```bash
|
|
98
|
+
git clone https://github.com/jiji262/douyin-downloader.git
|
|
99
|
+
cd douyin-downloader
|
|
100
|
+
python -m pip install -r requirements.txt
|
|
101
|
+
python -m pip install playwright
|
|
102
|
+
python -m playwright install chromium
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
### 2. Configure and sign in
|
|
106
|
+
|
|
107
|
+
Copy [config.example.yml](https://github.com/jiji262/douyin-downloader/blob/main/config.example.yml) to `config.yml`:
|
|
108
|
+
|
|
109
|
+
```bash
|
|
110
|
+
cp config.example.yml config.yml
|
|
111
|
+
python -m tools.cookie_fetcher --config config.yml
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
On Windows PowerShell, use `Copy-Item config.example.yml config.yml` to copy the file. Sign in to Douyin in the browser, then return to the terminal and press Enter to save cookies.
|
|
115
|
+
|
|
116
|
+
Replace the sample `link` in `config.yml` with your creator's profile URL. Keep the saved cookies and adjust these fields:
|
|
117
|
+
|
|
118
|
+
```yaml
|
|
119
|
+
link:
|
|
120
|
+
- https://www.douyin.com/user/YOUR_SEC_UID
|
|
121
|
+
path: ./Downloaded/
|
|
122
|
+
mode: [post]
|
|
123
|
+
number:
|
|
124
|
+
post: 10 # 0 = unlimited
|
|
125
|
+
increase:
|
|
126
|
+
post: true # skip downloaded items
|
|
127
|
+
redownload_missing_files: true
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
### 3. Run
|
|
131
|
+
|
|
132
|
+
```bash
|
|
133
|
+
python run.py -c config.yml
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
Use `python run.py --help` for all options.
|
|
137
|
+
|
|
138
|
+
| Option | Purpose |
|
|
139
|
+
|:---|:---|
|
|
140
|
+
| `-c, --config` | Config file |
|
|
141
|
+
| `-u, --url` | Append a URL to the links in the config; repeatable |
|
|
142
|
+
| `-p, --path` | Download folder |
|
|
143
|
+
| `-t, --thread` | Concurrent downloads |
|
|
144
|
+
| `-v, --verbose` | Detailed logs |
|
|
145
|
+
|
|
146
|
+
| Exit code | Meaning |
|
|
147
|
+
|:---|:---|
|
|
148
|
+
| `0` | Finished. Some items may still have failed; check the summary |
|
|
149
|
+
| `1` | Nothing was downloaded or skipped and at least one item failed, or a fatal error occurred |
|
|
150
|
+
| `3` | The sign-in expired and could not be renewed; the other URLs in the batch were still processed |
|
|
151
|
+
|
|
152
|
+
## Configuration
|
|
153
|
+
|
|
154
|
+
Full settings and examples: **[config.example.yml](https://github.com/jiji262/douyin-downloader/blob/main/config.example.yml)**.
|
|
155
|
+
|
|
156
|
+
| Setting | Purpose |
|
|
157
|
+
|:---|:---|
|
|
158
|
+
| `number.post` | Item limit; `0` means unlimited |
|
|
159
|
+
| `start_time` / `end_time` | Date range (`YYYY-MM-DD`); includes the whole end date |
|
|
160
|
+
| `video_quality` | `highest` by default; `original` tries the original upload and falls back |
|
|
161
|
+
| `increase.post` | `true` skips downloaded items; `false` downloads again and overwrites files in the selected scope |
|
|
162
|
+
| `redownload_missing_files` | Default `true`: download missing files again. With `false`, valid database history can still skip them |
|
|
163
|
+
|
|
164
|
+
Incremental downloads check for non-empty primary media on disk. You do **not** need to clear the database to download again: set `increase.post: false`. The same switch is available for `like`, `mix`, and `music`.
|
|
165
|
+
|
|
166
|
+
<details>
|
|
167
|
+
<summary>More CLI commands</summary>
|
|
168
|
+
|
|
169
|
+
```bash
|
|
170
|
+
# Hot search board and keyword search → JSONL
|
|
171
|
+
python run.py --hot-board 30
|
|
172
|
+
python run.py --search "cats" --search-max 50
|
|
173
|
+
|
|
174
|
+
# Optional REST API server
|
|
175
|
+
python -m pip install fastapi uvicorn
|
|
176
|
+
python run.py --serve --serve-port 8000
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
Comments, transcription, notifications, and live recording are configured in [config.example.yml](https://github.com/jiji262/douyin-downloader/blob/main/config.example.yml).
|
|
180
|
+
|
|
181
|
+
</details>
|
|
182
|
+
|
|
183
|
+
## Agent / Skill Mode
|
|
184
|
+
|
|
185
|
+
`douyin-dl agent <verb>` is a machine-readable mode for AI agents. Each run prints exactly one JSON line on stdout (logs go to stderr), with stable error and exit codes. The bundled skill `skills/douyin-dl/` teaches an agent when and how to call it.
|
|
186
|
+
|
|
187
|
+
**1. Install the CLI**
|
|
188
|
+
|
|
189
|
+
```bash
|
|
190
|
+
uv tool install douyin-dl-cli # or: pipx install douyin-dl-cli
|
|
191
|
+
# unreleased code from GitHub: uv tool install git+https://github.com/jiji262/douyin-downloader
|
|
192
|
+
douyin-dl agent doctor
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
The PyPI package is `douyin-dl-cli`; the command it installs is `douyin-dl`. In a cloned checkout with the requirements installed, `python run.py agent doctor` works too. Do not `pip install` the package into a shared environment: its top-level packages `utils`, `core`, and `config` collide with other projects.
|
|
196
|
+
|
|
197
|
+
**2. Install the skill** (pick one)
|
|
198
|
+
|
|
199
|
+
```bash
|
|
200
|
+
# Claude Code
|
|
201
|
+
/plugin marketplace add jiji262/douyin-downloader
|
|
202
|
+
/plugin install douyin-dl@douyin-dl
|
|
203
|
+
|
|
204
|
+
# Codex and other agents: copy the folder
|
|
205
|
+
cp -r skills/douyin-dl ~/.agents/skills/
|
|
206
|
+
|
|
207
|
+
# or use the skills CLI
|
|
208
|
+
npx skills add jiji262/douyin-downloader
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
**3. Try it**
|
|
212
|
+
|
|
213
|
+
```bash
|
|
214
|
+
douyin-dl agent hot --max 3
|
|
215
|
+
# {"schema":1,"ok":true,"verb":"hot","version":"2.1.0","data":{"items":[…],"count":3},"error":null,"warnings":[]}
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
| Status | Capabilities |
|
|
219
|
+
|:---|:---|
|
|
220
|
+
| Available | Hot search board (`hot`), link classification (`inspect`), live recording (`live`), local transcription (`transcribe`), environment check (`doctor`) |
|
|
221
|
+
| Sign-in required | Keyword search (`search`), profile info (`user`); sign in with `douyin-dl agent login` in your own browser window |
|
|
222
|
+
| Blocked | Downloading videos/photos, collections, music, or a profile's posts by link returns `ARGUS_GATED`. Use **Douzy** |
|
|
223
|
+
|
|
224
|
+
Exit codes: `0` success · `1` internal error · `2` bad arguments or unsupported link · `3` sign-in required · `4` `ARGUS_GATED` · `5` upstream returned nothing (rate limit, anti-bot, or the room is not live) · `6` partial result · `7` missing dependency · `130` interrupted.
|
|
225
|
+
|
|
226
|
+
- Agent mode keeps its own sign-in in `~/.douyin-dl` (set `DOUYIN_DL_HOME` to move it). It does not read `config.yml` or the cookies saved by `tools.cookie_fetcher`, and cookie values never appear in its output.
|
|
227
|
+
- `login` needs Playwright and Chromium; `transcribe` needs Whisper. `doctor` lists what is missing with the exact install command.
|
|
228
|
+
- Set `DOUYIN_PROXY` to send requests through a proxy.
|
|
229
|
+
|
|
230
|
+
Details: [contract](https://github.com/jiji262/douyin-downloader/blob/main/skills/douyin-dl/references/contract.md) · [troubleshooting](https://github.com/jiji262/douyin-downloader/blob/main/skills/douyin-dl/references/troubleshooting.md)
|
|
231
|
+
|
|
232
|
+
## FAQ
|
|
233
|
+
|
|
234
|
+
**Cookies expired?** Run `python -m tools.cookie_fetcher --config config.yml` again.
|
|
235
|
+
|
|
236
|
+
**Only a few profile posts?** Keep `browser_fallback.enabled: true` and `headless: false`. Complete any verification yourself in the browser; the current verification block may still prevent downloads.
|
|
237
|
+
|
|
238
|
+
**Need logs?** Run `python run.py -c config.yml -v`.
|
|
239
|
+
|
|
240
|
+
## Development
|
|
241
|
+
|
|
242
|
+
```bash
|
|
243
|
+
python -m pip install -e ".[dev]"
|
|
244
|
+
python -m pytest tests/
|
|
245
|
+
ruff check .
|
|
246
|
+
```
|
|
247
|
+
|
|
248
|
+
## Community & License
|
|
249
|
+
|
|
250
|
+
[QQ group](https://qm.qq.com/q/8wrCzYyLHa) · [LINUX DO](https://linux.do/) · [MIT License](https://github.com/jiji262/douyin-downloader/blob/main/LICENSE)
|
|
251
|
+
|
|
252
|
+
<img src="https://raw.githubusercontent.com/jiji262/douyin-downloader/main/img/qq-group.png" alt="Community QR code" width="200" />
|
|
253
|
+
|
|
254
|
+
For learning and personal data management. Respect copyright, privacy, and platform rules. You are responsible for how you use this tool; platform changes may affect availability.
|
|
255
|
+
|
|
256
|
+
## Star History
|
|
257
|
+
|
|
258
|
+
[View GitHub Star History](https://www.star-history.com/?repos=jiji262%2Fdouyin-downloader&type=date&legend=top-left)
|
|
@@ -0,0 +1,215 @@
|
|
|
1
|
+
<!-- README.md is also the PyPI project page: keep links and images absolute. -->
|
|
2
|
+
# Douyin Downloader
|
|
3
|
+
|
|
4
|
+
<p align="center">
|
|
5
|
+
<img src="https://camo.githubusercontent.com/327409f4eab82516b28e9c67bd4831261917ee9a29ffd865a60996a9c53709cb/68747470733a2f2f736f6369616c6966792e6769742e63692f6a696a693236322f646f7579696e2d646f776e6c6f616465722f696d6167653f637573746f6d5f6465736372697074696f6e3d446f7579696e2b62617463682b646f776e6c6f61642b746f6f6c2532432b72656d6f76652b77617465726d61726b732532432b737570706f72742b62617463682b646f776e6c6f61642b6f662b766964656f732532432b67616c6c6572792532432b616e642b617574686f722b686f6d6570616765732e266465736372697074696f6e3d3126666f6e743d536f757263652b436f64652b50726f26666f726b733d31266f776e65723d31267061747465726e3d436972637569742b426f617264267374617267617a6572733d31267468656d653d4c69676874" alt="douyin-downloader" width="820" />
|
|
6
|
+
</p>
|
|
7
|
+
|
|
8
|
+
[简体中文](https://github.com/jiji262/douyin-downloader/blob/main/README.zh-CN.md) · **English**
|
|
9
|
+
|
|
10
|
+
Download Douyin videos and photos without watermarks. Use **Douzy** for a desktop interface, the **Python CLI** for scripts, or the **[agent skill](#agent--skill-mode)** so AI agents such as Claude Code and Codex can read the hot board, search, and record live streams.
|
|
11
|
+
|
|
12
|
+
## Douzy Desktop
|
|
13
|
+
|
|
14
|
+
A desktop app for **Douyin, TikTok, YouTube, Telegram, and X**. Paste links, track downloads, and browse your local archive.
|
|
15
|
+
|
|
16
|
+
**[Download for Windows / macOS](https://github.com/jiji262/douyin-downloader/releases)**
|
|
17
|
+
|
|
18
|
+
Platform features depend on enabled plugins or local components. Some batch and advanced features require activation.
|
|
19
|
+
|
|
20
|
+
| Platform | Content |
|
|
21
|
+
|:---|:---|
|
|
22
|
+
| Douyin | Videos, photos, profiles, collections; following, subscriptions, favorites, and likes |
|
|
23
|
+
| TikTok | Public videos, photos, and profiles |
|
|
24
|
+
| YouTube | Videos, Shorts, channels, and playlists; audio and subtitles |
|
|
25
|
+
| Telegram | Media from accessible chats, groups, and channels; requires setup and sign-in |
|
|
26
|
+
| X | Posts, profile media, your bookmarks and likes; requires account cookies |
|
|
27
|
+
|
|
28
|
+
| **Douyin** | **TikTok** | **YouTube** |
|
|
29
|
+
|:---:|:---:|:---:|
|
|
30
|
+
| [](https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/001.png) | [](https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/002.png) | [](https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/003.png) |
|
|
31
|
+
| **Telegram setup** | **X** | **Task center** |
|
|
32
|
+
| [](https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/004.png) | [](https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/005.png) | [](https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/006.png) |
|
|
33
|
+
|
|
34
|
+
| **Douyin (light)** | **YouTube (light)** | **Task center (light)** |
|
|
35
|
+
|:---:|:---:|:---:|
|
|
36
|
+
| [](https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/007.png) | [](https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/008.png) | [](https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/009.png) |
|
|
37
|
+
|
|
38
|
+
_Screenshots: Douzy 0.13.0 on macOS (light and dark themes, 1440 × 900, sample data). Telegram is shown before setup. Click an image to enlarge._
|
|
39
|
+
|
|
40
|
+
## CLI Status
|
|
41
|
+
|
|
42
|
+
The CLI supports **Douyin only**. It includes batch downloads, date filters, retries, download history, and optional comments, transcription, and notifications.
|
|
43
|
+
|
|
44
|
+
> **Download limitations:** Douyin's request verification currently blocks CLI downloads of individual videos/photos, collections, music, likes, and favorites. Profile posts can try the Playwright browser fallback, but success is not guaranteed. Use **Douzy** for everyday downloads.
|
|
45
|
+
|
|
46
|
+
Refreshing cookies or retrying does not fix this verification block. Live recording is experimental: FFmpeg records the stream in segments, converts each segment to MP4, and reconnects after drops.
|
|
47
|
+
|
|
48
|
+
## Quick Start
|
|
49
|
+
|
|
50
|
+
Requires **Python 3.10+** on Windows, macOS, or Linux. Read the CLI limitations above first.
|
|
51
|
+
|
|
52
|
+
### 1. Install
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
git clone https://github.com/jiji262/douyin-downloader.git
|
|
56
|
+
cd douyin-downloader
|
|
57
|
+
python -m pip install -r requirements.txt
|
|
58
|
+
python -m pip install playwright
|
|
59
|
+
python -m playwright install chromium
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
### 2. Configure and sign in
|
|
63
|
+
|
|
64
|
+
Copy [config.example.yml](https://github.com/jiji262/douyin-downloader/blob/main/config.example.yml) to `config.yml`:
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
cp config.example.yml config.yml
|
|
68
|
+
python -m tools.cookie_fetcher --config config.yml
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
On Windows PowerShell, use `Copy-Item config.example.yml config.yml` to copy the file. Sign in to Douyin in the browser, then return to the terminal and press Enter to save cookies.
|
|
72
|
+
|
|
73
|
+
Replace the sample `link` in `config.yml` with your creator's profile URL. Keep the saved cookies and adjust these fields:
|
|
74
|
+
|
|
75
|
+
```yaml
|
|
76
|
+
link:
|
|
77
|
+
- https://www.douyin.com/user/YOUR_SEC_UID
|
|
78
|
+
path: ./Downloaded/
|
|
79
|
+
mode: [post]
|
|
80
|
+
number:
|
|
81
|
+
post: 10 # 0 = unlimited
|
|
82
|
+
increase:
|
|
83
|
+
post: true # skip downloaded items
|
|
84
|
+
redownload_missing_files: true
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### 3. Run
|
|
88
|
+
|
|
89
|
+
```bash
|
|
90
|
+
python run.py -c config.yml
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Use `python run.py --help` for all options.
|
|
94
|
+
|
|
95
|
+
| Option | Purpose |
|
|
96
|
+
|:---|:---|
|
|
97
|
+
| `-c, --config` | Config file |
|
|
98
|
+
| `-u, --url` | Append a URL to the links in the config; repeatable |
|
|
99
|
+
| `-p, --path` | Download folder |
|
|
100
|
+
| `-t, --thread` | Concurrent downloads |
|
|
101
|
+
| `-v, --verbose` | Detailed logs |
|
|
102
|
+
|
|
103
|
+
| Exit code | Meaning |
|
|
104
|
+
|:---|:---|
|
|
105
|
+
| `0` | Finished. Some items may still have failed; check the summary |
|
|
106
|
+
| `1` | Nothing was downloaded or skipped and at least one item failed, or a fatal error occurred |
|
|
107
|
+
| `3` | The sign-in expired and could not be renewed; the other URLs in the batch were still processed |
|
|
108
|
+
|
|
109
|
+
## Configuration
|
|
110
|
+
|
|
111
|
+
Full settings and examples: **[config.example.yml](https://github.com/jiji262/douyin-downloader/blob/main/config.example.yml)**.
|
|
112
|
+
|
|
113
|
+
| Setting | Purpose |
|
|
114
|
+
|:---|:---|
|
|
115
|
+
| `number.post` | Item limit; `0` means unlimited |
|
|
116
|
+
| `start_time` / `end_time` | Date range (`YYYY-MM-DD`); includes the whole end date |
|
|
117
|
+
| `video_quality` | `highest` by default; `original` tries the original upload and falls back |
|
|
118
|
+
| `increase.post` | `true` skips downloaded items; `false` downloads again and overwrites files in the selected scope |
|
|
119
|
+
| `redownload_missing_files` | Default `true`: download missing files again. With `false`, valid database history can still skip them |
|
|
120
|
+
|
|
121
|
+
Incremental downloads check for non-empty primary media on disk. You do **not** need to clear the database to download again: set `increase.post: false`. The same switch is available for `like`, `mix`, and `music`.
|
|
122
|
+
|
|
123
|
+
<details>
|
|
124
|
+
<summary>More CLI commands</summary>
|
|
125
|
+
|
|
126
|
+
```bash
|
|
127
|
+
# Hot search board and keyword search → JSONL
|
|
128
|
+
python run.py --hot-board 30
|
|
129
|
+
python run.py --search "cats" --search-max 50
|
|
130
|
+
|
|
131
|
+
# Optional REST API server
|
|
132
|
+
python -m pip install fastapi uvicorn
|
|
133
|
+
python run.py --serve --serve-port 8000
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
Comments, transcription, notifications, and live recording are configured in [config.example.yml](https://github.com/jiji262/douyin-downloader/blob/main/config.example.yml).
|
|
137
|
+
|
|
138
|
+
</details>
|
|
139
|
+
|
|
140
|
+
## Agent / Skill Mode
|
|
141
|
+
|
|
142
|
+
`douyin-dl agent <verb>` is a machine-readable mode for AI agents. Each run prints exactly one JSON line on stdout (logs go to stderr), with stable error and exit codes. The bundled skill `skills/douyin-dl/` teaches an agent when and how to call it.
|
|
143
|
+
|
|
144
|
+
**1. Install the CLI**
|
|
145
|
+
|
|
146
|
+
```bash
|
|
147
|
+
uv tool install douyin-dl-cli # or: pipx install douyin-dl-cli
|
|
148
|
+
# unreleased code from GitHub: uv tool install git+https://github.com/jiji262/douyin-downloader
|
|
149
|
+
douyin-dl agent doctor
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
The PyPI package is `douyin-dl-cli`; the command it installs is `douyin-dl`. In a cloned checkout with the requirements installed, `python run.py agent doctor` works too. Do not `pip install` the package into a shared environment: its top-level packages `utils`, `core`, and `config` collide with other projects.
|
|
153
|
+
|
|
154
|
+
**2. Install the skill** (pick one)
|
|
155
|
+
|
|
156
|
+
```bash
|
|
157
|
+
# Claude Code
|
|
158
|
+
/plugin marketplace add jiji262/douyin-downloader
|
|
159
|
+
/plugin install douyin-dl@douyin-dl
|
|
160
|
+
|
|
161
|
+
# Codex and other agents: copy the folder
|
|
162
|
+
cp -r skills/douyin-dl ~/.agents/skills/
|
|
163
|
+
|
|
164
|
+
# or use the skills CLI
|
|
165
|
+
npx skills add jiji262/douyin-downloader
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
**3. Try it**
|
|
169
|
+
|
|
170
|
+
```bash
|
|
171
|
+
douyin-dl agent hot --max 3
|
|
172
|
+
# {"schema":1,"ok":true,"verb":"hot","version":"2.1.0","data":{"items":[…],"count":3},"error":null,"warnings":[]}
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
| Status | Capabilities |
|
|
176
|
+
|:---|:---|
|
|
177
|
+
| Available | Hot search board (`hot`), link classification (`inspect`), live recording (`live`), local transcription (`transcribe`), environment check (`doctor`) |
|
|
178
|
+
| Sign-in required | Keyword search (`search`), profile info (`user`); sign in with `douyin-dl agent login` in your own browser window |
|
|
179
|
+
| Blocked | Downloading videos/photos, collections, music, or a profile's posts by link returns `ARGUS_GATED`. Use **Douzy** |
|
|
180
|
+
|
|
181
|
+
Exit codes: `0` success · `1` internal error · `2` bad arguments or unsupported link · `3` sign-in required · `4` `ARGUS_GATED` · `5` upstream returned nothing (rate limit, anti-bot, or the room is not live) · `6` partial result · `7` missing dependency · `130` interrupted.
|
|
182
|
+
|
|
183
|
+
- Agent mode keeps its own sign-in in `~/.douyin-dl` (set `DOUYIN_DL_HOME` to move it). It does not read `config.yml` or the cookies saved by `tools.cookie_fetcher`, and cookie values never appear in its output.
|
|
184
|
+
- `login` needs Playwright and Chromium; `transcribe` needs Whisper. `doctor` lists what is missing with the exact install command.
|
|
185
|
+
- Set `DOUYIN_PROXY` to send requests through a proxy.
|
|
186
|
+
|
|
187
|
+
Details: [contract](https://github.com/jiji262/douyin-downloader/blob/main/skills/douyin-dl/references/contract.md) · [troubleshooting](https://github.com/jiji262/douyin-downloader/blob/main/skills/douyin-dl/references/troubleshooting.md)
|
|
188
|
+
|
|
189
|
+
## FAQ
|
|
190
|
+
|
|
191
|
+
**Cookies expired?** Run `python -m tools.cookie_fetcher --config config.yml` again.
|
|
192
|
+
|
|
193
|
+
**Only a few profile posts?** Keep `browser_fallback.enabled: true` and `headless: false`. Complete any verification yourself in the browser; the current verification block may still prevent downloads.
|
|
194
|
+
|
|
195
|
+
**Need logs?** Run `python run.py -c config.yml -v`.
|
|
196
|
+
|
|
197
|
+
## Development
|
|
198
|
+
|
|
199
|
+
```bash
|
|
200
|
+
python -m pip install -e ".[dev]"
|
|
201
|
+
python -m pytest tests/
|
|
202
|
+
ruff check .
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
## Community & License
|
|
206
|
+
|
|
207
|
+
[QQ group](https://qm.qq.com/q/8wrCzYyLHa) · [LINUX DO](https://linux.do/) · [MIT License](https://github.com/jiji262/douyin-downloader/blob/main/LICENSE)
|
|
208
|
+
|
|
209
|
+
<img src="https://raw.githubusercontent.com/jiji262/douyin-downloader/main/img/qq-group.png" alt="Community QR code" width="200" />
|
|
210
|
+
|
|
211
|
+
For learning and personal data management. Respect copyright, privacy, and platform rules. You are responsible for how you use this tool; platform changes may affect availability.
|
|
212
|
+
|
|
213
|
+
## Star History
|
|
214
|
+
|
|
215
|
+
[View GitHub Star History](https://www.star-history.com/?repos=jiji262%2Fdouyin-downloader&type=date&legend=top-left)
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"""douyin-dl agent 模式:给 AI agent 用的机器可读入口(CLI-only,不与桌面版同步)。"""
|