{"id":17366936,"url":"https://github.com/gabrielrf/document2telegram","last_synced_at":"2025-09-20T18:32:35.138Z","repository":{"id":81479877,"uuid":"186619401","full_name":"GabrielRF/Document2Telegram","owner":"GabrielRF","description":"Watches a folder. If new file, sends it using Telegram Messenger.","archived":false,"fork":false,"pushed_at":"2019-05-14T16:56:04.000Z","size":19,"stargazers_count":2,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-31T11:23:43.935Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/gabrielrf/document2telegram","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GabrielRF.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}},"created_at":"2019-05-14T12:39:50.000Z","updated_at":"2021-06-11T17:32:28.000Z","dependencies_parsed_at":null,"dependency_job_id":"9b1ac532-6d1d-40bf-a842-c9a32109637b","html_url":"https://github.com/GabrielRF/Document2Telegram","commit_stats":{"total_commits":7,"total_committers":1,"mean_commits":7.0,"dds":0.0,"last_synced_commit":"1be19ba48394956d94b0a0742bd002c56ad9447e"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GabrielRF%2FDocument2Telegram","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GabrielRF%2FDocument2Telegram/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GabrielRF%2FDocument2Telegram/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GabrielRF%2FDocument2Telegram/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GabrielRF","download_url":"https://codeload.github.com/GabrielRF/Document2Telegram/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233682439,"owners_count":18713551,"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":[],"created_at":"2024-10-15T22:11:29.758Z","updated_at":"2025-09-20T18:32:29.922Z","avatar_url":"https://github.com/GabrielRF.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![](https://dockerbuildbadges.quelltext.eu/status.svg?organization=gabrielrf\u0026repository=document2telegram)](https://hub.docker.com/r/gabrielrf/document2telegram/builds)\n\n# Document to Telegram\n\n* [About](#about)\n* [Setup](#setup)\n  * [Docker Compose](#docker-compose)\n  * [Python](#python)\n* [Contribute](#contribute)\n* [Contact](#contact-me)\n\n## About\n\nThis docker container checks if a new file is created on a folder and sends it to a person/group/channel using [Telegram Messenger](https://telegram.org).\n\n## Setup\n\n### Docker Compose\n\n```\ndoc2tg:\n    image: gabrielrf/document2telegram\n    environment:\n        - BOT_TOKEN=\n        - FOLDER=/\n        - EXTENSION=\n        - DESTINATION=\n    restart: always\n    volumes:\n        - host_folder:container_folder\n```\n\n`BOT_TOKEN`: Token given by [@BotFather](https://t.me/BotFather) on Telegram.\n\n`FOLDER`: Folder that will be monitored by the script. In case of a folder tree, set the top-level folder.\n\n`EXTENSION` (optional): The extension of the file that should be sent. Usually `mp4` is the case.\n\n`DESTINATION`: To whom the message will be sent.\n\n`volumes`: The same folder used on `FOLDER`:Some folder that exists on the container. Suggested: `/mnt`\n\n### Python\n\nFirst, run \n\n```\npip install inotify\npip install pytelegrambotapi\n```\n\nto install the libraries needed. Then, open `file2gif.py` and make the necessary adjustments on `BOT_TOKEN`, `FOLDER`, `EXTENSION` and `DESTINATION` as listed above. \n\nRun the Python Script.\n\n```\npython doc2tg.py\n```\n\n## Contribute\n\nPull requests and issues are welcome! \n\n## Contact me\n\n[GabRF.com](https://gabrf.com)\n\n[@GabrielRF](https://t.me/gabrielrf) on Telegram.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabrielrf%2Fdocument2telegram","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgabrielrf%2Fdocument2telegram","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabrielrf%2Fdocument2telegram/lists"}