.. image:: https://raw.githubusercontent.com/ankit-chaubey/uploady/main/logo.png
:width: 100%
|
.. image:: https://raw.githubusercontent.com/ankit-chaubey/uploady/pip-rating-badge/pip-rating-badge.svg
:target: https://github.com/ankit-chaubey/uploady/actions/workflows/pip-rating.yml
:alt: pip-rating badge
.. image:: https://img.shields.io/github/actions/workflow/status/ankit-chaubey/uploady/test.yml?style=flat-square&maxAge=2592000&branch=main
:target: https://github.com/ankit-chaubey/uploady/actions?query=workflow%3ATests
:alt: Latest Tests CI build status
.. image:: https://img.shields.io/pypi/v/uploady.svg?style=flat-square
:target: https://pypi.org/project/uploady/
:alt: Latest PyPI version
.. image:: https://img.shields.io/pypi/pyversions/uploady.svg?style=flat-square
:target: https://pypi.org/project/uploady/
:alt: Python versions
.. image:: https://img.shields.io/codeclimate/maintainability/ankit-chaubey/uploady.svg?style=flat-square
:target: https://codeclimate.com/github/ankit-chaubey/uploady
:alt: Code Climate
.. image:: https://img.shields.io/codecov/c/github/ankit-chaubey/uploady/main.svg?style=flat-square
:target: https://codecov.io/github/ankit-chaubey/uploady
:alt: Test coverage
.. image:: https://img.shields.io/github/stars/ankit-chaubey/uploady?style=flat-square
:target: https://github.com/ankit-chaubey/uploady
:alt: Github stars
###############
Uploady
###############
Why uploady?
While telegram-upload is great, Uploady offers additional features (currently in development):
- Support for multiple bots/accounts with floodwait handling
- Scheduled uploads for hands-off management
- Gallery synchronization for up-to-date media
- Posting with inline button and much more
- Something even more unexpected 😄 is coming soon!
Uploady enhances flexibility, automation, and control, making it the ultimate solution for Telegram file management.
----------------
Telegram-upload uses your **personal Telegram account** to **upload** and **download** files up to **4 GiB** (2 GiB for
free users). Turn Telegram into your personal ☁ cloud!
To **install 🔧 uploady**, run this command in your terminal:
.. code-block:: console
$ sudo pip3 install -U uploady
This is the preferred method to install uploady, as it will always install the most recent stable release.
🐍 **Python 3.7-3.12** are tested and supported. There are other installation ways available like `Docker <#-docker>`_.
More info in the `📕 documentation <https://docs.ankit-chaubey.org/uploady/installation.html>`_ but make sure to use ``uploady`` instead of ``telegram-upload`` in all respective methods.
.. image:: https://raw.githubusercontent.com/ankit-chaubey/uploady/main/uploady-demo.gif
:target: https://asciinema.org/a/592098
:width: 100%
❓ Usage
========
To use this program you need a Telegram account and your **App api_id & api_hash** (get it in
`my.telegram.org <https://my.telegram.org/>`_). The first time you use uploady it requests your
📱 **telephone**, **api_id** and **api_hash**. Bot tokens can not be used with this program (bot uploads are limited to
50MB).
To **send ⬆️ files** (by default it is uploaded to saved messages):
.. code-block:: console
$ uploady file1.mp4 file2.mkv
You can **download ⤵️ the files** again from your saved messages (by default) or from a channel. All files will be
downloaded until the last text message.
.. code-block:: console
$ telegram-download
`Read the documentation <https://docs.ankit-chaubey.org/uploady/usage.html#telegram-download>`_ for more info about the
options availables.
Interactive mode
----------------
The **interactive option** (``--interactive``) allows you to choose the dialog and the files to download or upload with
a **terminal 🪄 wizard**. It even **supports mouse**!
.. code-block:: console
$ uploady --interactive # Interactive upload
$ telegram-download --interactive # Interactive download
`More info in the documentation <https://docs.ankit-chaubey.org/uploady/usage.html#interactive-mode>`_
Set group or chat
-----------------
By default when using uploady without specifying the recipient or sender, uploady will use your personal
chat. However you can define the 👨 destination. For file upload the argument is ``--to <entity>``. For example:
.. code-block::
$ uploady --to telegram.me/joinchat/AAAAAEkk2WdoDrB4-Q8-gg video.mkv
You can download files from a specific chat using the --from <entity> parameter. For example:
.. code-block::
$ telegram-download --from username
You can see all `the possible values for the entity in the documentation <https://docs.ankit-chaubey.org/uploady/usage.html#set-recipient-or-sender>`_.
Split & join files
------------------
If you try to upload a file that **exceeds the maximum supported** by Telegram by default, an error will occur. But you
can enable ✂ **split mode** to upload multiple files:
.. code-block:: console
$ uploady --large-files split large-video.mkv
Files split using split can be rejoined on download using:
.. code-block:: console
$ telegram-download --split-files join
Find more help in `the uploady documentation <https://docs.ankit-chaubey.org/uploady/usage.html#split-files>`_.
Delete on success
-----------------
The ``--delete-on-success`` option allows you to ❌ **delete the Telegram message** after downloading the file. This is
useful to send files to download to your saved messages and avoid downloading them again. You can use this option to
download files on your computer away from home.
Configuration
-------------
Credentials are saved in ``~/.config/uploady.json`` and ``~/.config/uploady.session``. You must make
sure that these files are secured. You can copy these 📁 files to authenticate ``uploady`` on more machines, but
it is advisable to create a session file for each machine.
More options
------------
Telegram-upload has more options available, like customizing the files thumbnail, set a caption message (including
variables) or configuring a proxy.
`Read the documentation <https://docs.ankit-chaubey.org/uploady/usage.html#telegram-download>`_ for more info.
💡 Features
===========
* **Upload** and **download** multiples files (up to 4 GiB per file for premium users).
* **Interactive** mode.
* Add video **thumbs**.
* **Split** and **join** large files.
* **Delete** local or remote file on success.
* Use **variables** in the **caption** message.
* ... And **more**.
🐋 Docker
=========
Run uploady without installing it on your system using Docker. Instead of ``uploady``
and ``telegram-download`` you should use ``upload`` and ``download``. Usage::
$ docker run -v <files_dir>:/files/
-v <config_dir>:/config
-it ankit-chaubey/uploady:main
<command> <args>
* ``<files_dir>``: upload or download directory.
* ``<config_dir>``: Directory that will be created to store the uploady configuration.
It is created automatically.
* ``<command>``: ``upload`` and ``download``.
* ``<args>``: ``uploady`` and ``telegram-download`` arguments.
For example::
$ docker run -v /media/data/:/files/
-v $PWD/config:/config
-it ankit-chaubey/uploady:main
upload file_to_upload.txt
❤️ Thanks
=========
This project developed by `Nekmo <https://github.com/Nekmo>`_ & `collaborators <https://github.com/ankit-chaubey/uploady/graphs/contributors>`_ would not be possible without
`Telethon <https://github.com/LonamiWebs/Telethon>`_, the library used as a Telegram client.
This project is maintained by `Ankit Chaubey <https://github.com/ankit-chaubey>`_ & The enhancements and customizations for Uploady are coming soon.
Telegram-upload is licensed under the `MIT license <https://github.com/ankit-chaubey/uploady/blob/main/LICENSE>`_.
Raw data
{
"_id": null,
"home_page": "https://github.com/ankit-chaubey/uploady/",
"name": "uploady",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "uploady, telegram, upload, video",
"author": "Ankit Chaubey",
"author_email": "m.ankitchaubey@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d6/68/57a6cd7e9c4857871ac87e9c0030a4f50085425d005ef5caf0a1fd93cedc/uploady-0.0.3.tar.gz",
"platform": "linux",
"description": ".. image:: https://raw.githubusercontent.com/ankit-chaubey/uploady/main/logo.png\n :width: 100%\n\n|\n\n.. image:: https://raw.githubusercontent.com/ankit-chaubey/uploady/pip-rating-badge/pip-rating-badge.svg\n :target: https://github.com/ankit-chaubey/uploady/actions/workflows/pip-rating.yml\n :alt: pip-rating badge\n\n.. image:: https://img.shields.io/github/actions/workflow/status/ankit-chaubey/uploady/test.yml?style=flat-square&maxAge=2592000&branch=main\n :target: https://github.com/ankit-chaubey/uploady/actions?query=workflow%3ATests\n :alt: Latest Tests CI build status\n\n.. image:: https://img.shields.io/pypi/v/uploady.svg?style=flat-square\n :target: https://pypi.org/project/uploady/\n :alt: Latest PyPI version\n\n.. image:: https://img.shields.io/pypi/pyversions/uploady.svg?style=flat-square\n :target: https://pypi.org/project/uploady/\n :alt: Python versions\n\n.. image:: https://img.shields.io/codeclimate/maintainability/ankit-chaubey/uploady.svg?style=flat-square\n :target: https://codeclimate.com/github/ankit-chaubey/uploady\n :alt: Code Climate\n\n.. image:: https://img.shields.io/codecov/c/github/ankit-chaubey/uploady/main.svg?style=flat-square\n :target: https://codecov.io/github/ankit-chaubey/uploady\n :alt: Test coverage\n\n.. image:: https://img.shields.io/github/stars/ankit-chaubey/uploady?style=flat-square\n :target: https://github.com/ankit-chaubey/uploady\n :alt: Github stars\n\n\n###############\nUploady\n###############\nWhy uploady?\nWhile telegram-upload is great, Uploady offers additional features (currently in development):\n\n- Support for multiple bots/accounts with floodwait handling\n\n- Scheduled uploads for hands-off management\n\n- Gallery synchronization for up-to-date media\n\n- Posting with inline button and much more\n\n- Something even more unexpected \ud83d\ude04 is coming soon!\n\nUploady enhances flexibility, automation, and control, making it the ultimate solution for Telegram file management.\n\n----------------\n\nTelegram-upload uses your **personal Telegram account** to **upload** and **download** files up to **4 GiB** (2 GiB for\nfree users). Turn Telegram into your personal \u2601 cloud!\n\nTo **install \ud83d\udd27 uploady**, run this command in your terminal:\n\n.. code-block:: console\n\n $ sudo pip3 install -U uploady\n\nThis is the preferred method to install uploady, as it will always install the most recent stable release.\n\ud83d\udc0d **Python 3.7-3.12** are tested and supported. There are other installation ways available like `Docker <#-docker>`_.\nMore info in the `\ud83d\udcd5 documentation <https://docs.ankit-chaubey.org/uploady/installation.html>`_ but make sure to use ``uploady`` instead of ``telegram-upload`` in all respective methods.\n\n.. image:: https://raw.githubusercontent.com/ankit-chaubey/uploady/main/uploady-demo.gif\n :target: https://asciinema.org/a/592098\n :width: 100%\n\n\u2753 Usage\n========\nTo use this program you need a Telegram account and your **App api_id & api_hash** (get it in\n`my.telegram.org <https://my.telegram.org/>`_). The first time you use uploady it requests your\n\ud83d\udcf1 **telephone**, **api_id** and **api_hash**. Bot tokens can not be used with this program (bot uploads are limited to\n50MB).\n\nTo **send \u2b06\ufe0f files** (by default it is uploaded to saved messages):\n\n.. code-block:: console\n\n $ uploady file1.mp4 file2.mkv\n\nYou can **download \u2935\ufe0f the files** again from your saved messages (by default) or from a channel. All files will be\ndownloaded until the last text message.\n\n.. code-block:: console\n\n $ telegram-download\n\n`Read the documentation <https://docs.ankit-chaubey.org/uploady/usage.html#telegram-download>`_ for more info about the\noptions availables.\n\nInteractive mode\n----------------\nThe **interactive option** (``--interactive``) allows you to choose the dialog and the files to download or upload with\na **terminal \ud83e\ude84 wizard**. It even **supports mouse**!\n\n.. code-block:: console\n\n $ uploady --interactive # Interactive upload\n $ telegram-download --interactive # Interactive download\n\n`More info in the documentation <https://docs.ankit-chaubey.org/uploady/usage.html#interactive-mode>`_\n\nSet group or chat\n-----------------\nBy default when using uploady without specifying the recipient or sender, uploady will use your personal\nchat. However you can define the \ud83d\udc68 destination. For file upload the argument is ``--to <entity>``. For example:\n\n.. code-block::\n\n $ uploady --to telegram.me/joinchat/AAAAAEkk2WdoDrB4-Q8-gg video.mkv\n\nYou can download files from a specific chat using the --from <entity> parameter. For example:\n\n.. code-block::\n\n $ telegram-download --from username\n\nYou can see all `the possible values for the entity in the documentation <https://docs.ankit-chaubey.org/uploady/usage.html#set-recipient-or-sender>`_.\n\nSplit & join files\n------------------\nIf you try to upload a file that **exceeds the maximum supported** by Telegram by default, an error will occur. But you\ncan enable \u2702 **split mode** to upload multiple files:\n\n.. code-block:: console\n\n $ uploady --large-files split large-video.mkv\n\nFiles split using split can be rejoined on download using:\n\n.. code-block:: console\n\n $ telegram-download --split-files join\n\nFind more help in `the uploady documentation <https://docs.ankit-chaubey.org/uploady/usage.html#split-files>`_.\n\nDelete on success\n-----------------\nThe ``--delete-on-success`` option allows you to \u274c **delete the Telegram message** after downloading the file. This is\nuseful to send files to download to your saved messages and avoid downloading them again. You can use this option to\ndownload files on your computer away from home.\n\nConfiguration\n-------------\nCredentials are saved in ``~/.config/uploady.json`` and ``~/.config/uploady.session``. You must make\nsure that these files are secured. You can copy these \ud83d\udcc1 files to authenticate ``uploady`` on more machines, but\nit is advisable to create a session file for each machine.\n\nMore options\n------------\nTelegram-upload has more options available, like customizing the files thumbnail, set a caption message (including\nvariables) or configuring a proxy.\n`Read the documentation <https://docs.ankit-chaubey.org/uploady/usage.html#telegram-download>`_ for more info.\n\n\ud83d\udca1 Features\n===========\n\n* **Upload** and **download** multiples files (up to 4 GiB per file for premium users).\n* **Interactive** mode.\n* Add video **thumbs**.\n* **Split** and **join** large files.\n* **Delete** local or remote file on success.\n* Use **variables** in the **caption** message.\n* ... And **more**.\n\n\ud83d\udc0b Docker\n=========\nRun uploady without installing it on your system using Docker. Instead of ``uploady``\nand ``telegram-download`` you should use ``upload`` and ``download``. Usage::\n\n $ docker run -v <files_dir>:/files/\n -v <config_dir>:/config\n -it ankit-chaubey/uploady:main\n <command> <args>\n\n* ``<files_dir>``: upload or download directory.\n* ``<config_dir>``: Directory that will be created to store the uploady configuration.\n It is created automatically.\n* ``<command>``: ``upload`` and ``download``.\n* ``<args>``: ``uploady`` and ``telegram-download`` arguments.\n\nFor example::\n\n $ docker run -v /media/data/:/files/\n -v $PWD/config:/config\n -it ankit-chaubey/uploady:main\n upload file_to_upload.txt\n\n\u2764\ufe0f Thanks\n=========\nThis project developed by `Nekmo <https://github.com/Nekmo>`_ & `collaborators <https://github.com/ankit-chaubey/uploady/graphs/contributors>`_ would not be possible without\n`Telethon <https://github.com/LonamiWebs/Telethon>`_, the library used as a Telegram client.\n\nThis project is maintained by `Ankit Chaubey <https://github.com/ankit-chaubey>`_ & The enhancements and customizations for Uploady are coming soon.\n\nTelegram-upload is licensed under the `MIT license <https://github.com/ankit-chaubey/uploady/blob/main/LICENSE>`_.\n",
"bugtrack_url": null,
"license": null,
"summary": "Upload (and download) files to Telegram up to 4 GiB using your account.",
"version": "0.0.3",
"project_urls": {
"Download": "https://github.com/ankit-chaubey/uploady/archive/master.zip",
"Homepage": "https://github.com/ankit-chaubey/uploady/"
},
"split_keywords": [
"uploady",
" telegram",
" upload",
" video"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "27e415e82346e1841f3b8e5e1d8b2dc48c0515bf13451c037da0d2134ff556c0",
"md5": "5966306e3789cf2cd52d2db88dd9a2e7",
"sha256": "49a4c0a77fdb69941c536e73755824d0a6767bef70a9adccf07fd11be167e88c"
},
"downloads": -1,
"filename": "uploady-0.0.3-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "5966306e3789cf2cd52d2db88dd9a2e7",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 48237,
"upload_time": "2025-01-17T11:29:35",
"upload_time_iso_8601": "2025-01-17T11:29:35.496739Z",
"url": "https://files.pythonhosted.org/packages/27/e4/15e82346e1841f3b8e5e1d8b2dc48c0515bf13451c037da0d2134ff556c0/uploady-0.0.3-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d66857a6cd7e9c4857871ac87e9c0030a4f50085425d005ef5caf0a1fd93cedc",
"md5": "6fbd95494d051c42084e3ed06eb9a2c8",
"sha256": "217c6136eb0bd87522b4d25593c7c882e226a54ba3ab40f19e01082dd6be6c05"
},
"downloads": -1,
"filename": "uploady-0.0.3.tar.gz",
"has_sig": false,
"md5_digest": "6fbd95494d051c42084e3ed06eb9a2c8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 282618,
"upload_time": "2025-01-17T11:29:36",
"upload_time_iso_8601": "2025-01-17T11:29:36.719846Z",
"url": "https://files.pythonhosted.org/packages/d6/68/57a6cd7e9c4857871ac87e9c0030a4f50085425d005ef5caf0a1fd93cedc/uploady-0.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-17 11:29:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ankit-chaubey",
"github_project": "uploady",
"github_not_found": true,
"lcname": "uploady"
}
JSON
