{"id":25155121,"url":"https://github.com/dub1401/telegram-dlp","last_synced_at":"2025-04-30T07:50:07.195Z","repository":{"id":228049338,"uuid":"773011407","full_name":"DUB1401/Telegram-dlp","owner":"DUB1401","description":"Бот Telegram для быстрой загрузки видео из множества источников.","archived":false,"fork":false,"pushed_at":"2025-04-15T18:54:02.000Z","size":264,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-30T07:50:01.047Z","etag":null,"topics":["bot","downloader","storage","telegram","yt-dlp"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DUB1401.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-03-16T13:53:45.000Z","updated_at":"2025-04-23T12:42:18.000Z","dependencies_parsed_at":"2024-09-17T21:28:02.245Z","dependency_job_id":"a8844c9e-a3fc-4c85-8317-c95a8b1c6642","html_url":"https://github.com/DUB1401/Telegram-dlp","commit_stats":null,"previous_names":["dub1401/telegram-dlp"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DUB1401%2FTelegram-dlp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DUB1401%2FTelegram-dlp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DUB1401%2FTelegram-dlp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DUB1401%2FTelegram-dlp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DUB1401","download_url":"https://codeload.github.com/DUB1401/Telegram-dlp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251666227,"owners_count":21624291,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","downloader","storage","telegram","yt-dlp"],"created_at":"2025-02-09T00:40:07.666Z","updated_at":"2025-04-30T07:50:07.189Z","avatar_url":"https://github.com/DUB1401.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Telegram-dlp\n**Telegram-dlp** – это бот Telegram для скачивания видеороликов из сети, поддерживающий распознание водяных знаков, извлечение аудиодорожек и буферизацию контента для мгновенной повторной отправки. Также в систему внедрена удобная панель управления, позволяющая ознакомится со статистикой или проводить рассылку сообщений подписчикам бота.\n\nБот оптимизирован для работы со следующими источниками:\n* [ВКонтакте](https://vk.com/)\n* [YouTube](https://www.youtube.com/)\n* [PornHub](https://www.pornhub.com/)\n* [Rutube](https://rutube.ru/)\n* [TikTok](https://www.tiktok.com/)\n* [Instagram](https://www.instagram.com/)\n\nСо списком остальных сайтов, работа с которыми также теоретически поддерживается, но не гарантируется, можно ознакомится [здесь](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md).\n\nДля вывода дополнительных режимов загрузки выполните команду `/settings`.\n\n## Порядок установки и использования\n1. Для установки необходимо наличие системы [Git](https://git-scm.com/) и [Python](https://www.python.org/) версии **3.12** или новее на вашем устройстве.\n```Bash\ngit -v\npython3 -V\n```\n2. Клонируйте репозиторий рекурсивно (для автоматического включения подмодулей) и перейдите в его каталог.\n```Bash\ngit clone https://github.com/DUB1401/Telegram-dlp --recursive\ncd Telegram-dlp\n```\n3. Создайте виртуальное окружение Python.\n```Bash\npython3 -m venv .venv\n```\n4. Активируйте вирутальное окружение. \n```Bash\n# Для Windows.\n.venv\\Scripts\\activate.bat\n\n# Для Linux или MacOS.\nsource .venv/bin/activate\n```\n5. Установите зависимости.\n```\npip install -r requirements.txt\n```\n6. Разработчики [yt-dlp](https://github.com/yt-dlp) настоятельно рекомендуют установить библиотеку **ffmpeg** для поддержки расширенных сценариев загрузки и постпроцессинга. Ниже приведено несколько примеров.\n```Bash\n# Fedora\nsudo dnf install ffmpeg-free\n# Arch Linux\npacman -S ffmpeg\n# Ubuntu\nsudo apt install ffmpeg\n```\n7. Произведите настройку путём редактирования файла _Settings.json_.\n8. В вирутальном окружении выполните команду `main.py login {PHONE_NUMBER} {API_ID} {API_HASH}`, подставив данные, которые можно получить [здесь](https://my.telegram.org/).\n\u003e [!NOTE]  \n\u003e Это действие подключит выбранный аккаунт к **Telegram-dlp** в качестве загрузчика контента, что позволяет обходить лимиты ботов и скачивать видео размером до 2 GB (4 GB с подпиской Premium). Вы можете свободно продолжать пользоваться данным аккаунтом.\n9. При намерении скачивать ролики из Instagram необходимо получить из браузера с произведённой авторизацией файл куков в формате Netscape и поместить его в этот [каталог](yt-dlp) под именем _instagram.cookies_. \n10. После подключения аккаунта запустите файл `main.py` и отправьте боту команду `/start`.\n11. Для автоматического запуска рекомендуется провести инициализацию сервиса через [systemd](systemd/README.md) на Linux или путём добавления его в автозагрузку на Windows.\n\n# Settings.json\n```JSON\n\"token\": \"\"\n```\nСюда необходимо занести токен бота Telegram (можно получить у [BotFather](https://t.me/BotFather)).\n___\n```JSON\n\"support_contact\": \"\"\n```\nЗдесь можно указать Telegram-контакт поддержки, который будет добавляться к шаблону и отправляться в ответ на команду `/support`.\n___\n```JSON\n\"language\": \"ru\"\n```\nКод используемого ботом языка. По умолчанию поддерживаются: _ru_, _en_. Локализация осуществляется через [GNU gettext](https://www.gnu.org/software/gettext/manual/gettext.html).\n___\n```JSON\n\"trusted_sources_id\": []\n```\nСюда заносятся ID пользователей, от имени которых выполняется загрузка файлов на сервера Telegram. Заполняется автоматически.\n___\n```JSON\n\"password\": \"1234\"\n```\nУказывает пароль для доступа в панель управления (команда `/admin {PASSWORD}`).\n___\n```JSON\n\"quality_improvement\": false\n```\nВключает постобработку для улучшения качества видео. На данный момент не оказывает влияния на загружаемый ролик.\n___\n```JSON\n\"one_watermarked\": true\n```\nПереключает режим отображение видео с водяными знаками (только лучшее качество или все).\n___\n```JSON\n\"max_file_size\": 1950\n```\nМаксимальный размер выгружаемого в Telegram файла в MB. Если у подключённого к боту аккаунта имеется Premium-подписка, рекомендуется повысить до 3950.\n___\n```JSON\n\"parallel_download_qualities\": [\"Full HD\"]\n```\nЗдесь перечисляются идентификаторы качества, которые будут скачиваться ещё до выбора пользователем требуемого формата для ускорения выдачи. Доступны `240p`, `360p`, `480p`, `HD`, `Full HD`, `2K`, `4K`, `8K`. Не рекомендуется определять более двух вариантов из-за возможного длительного состояния гонки!\n___\n```JSON\n\"lib_autoupdate\": false\n```\nАктивирует проверку обновлений **yt-dlp** при каждом использовании.\n___\n```JSON\n\"configs\": {\n\t\"*\": {\n\t\t\"proxy\": \"http://{LOGIN}:{PASSWORD}@{IP}:{PORT}\"\n\t}\n}\n```\nЗдесь можно определять настройки, специфичные для отдельных экстракторов, в том числе и для базового. Внутри поля необходимо создать ключ, значением которого будет словарь с параметрами. Список ключей смотреть [здесь](/Source/Core/__init__.py), параметры приведены ниже. В примере выше для всех экстракторов установлен стандартный прокси.\n\n### Дополнительные параметры всех обработчиков\n| **Ключ** | **Тип** | **Описание** |\n|---|---|---|\n| proxy | string | Прокси-сервер для обработчика. |\n\n### Дополнительные параметры Instagram\n| **Ключ** | **Тип** | **Описание** |\n|---|---|---|\n| cookies_generator | string | Указывает Shell-команду для запуска скрипта, обновляющего cookies для авторизации |\n| libx264 | bool | Включает использование проприетарной _libx264_ вместо открытой _libopenh264_ во время перекодирования роликов в H.264 из VP9. |\n\n### Дополнительные параметры TikTok\n| **Ключ** | **Тип** | **Описание** |\n|---|---|---|\n| fake_hd | bool | Если у видео нет HD-варианта, таковым будет считаться наибольший из доступных. |\n\n# Благодарность\n* [@yt-dlp](https://github.com/yt-dlp) – библиотека для скачивания видео из множества источников с широким дополнительным функционалом.\n\n_Copyright © DUB1401. 2024-2025._","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdub1401%2Ftelegram-dlp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdub1401%2Ftelegram-dlp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdub1401%2Ftelegram-dlp/lists"}