repository·master·Indexed 23 days ago
https://github.com/nekmo/telegram-uploadA tool that uses a personal Telegram account to upload and download files, effectively turning Telegram into a personal cloud storage service. It supports files up to 4 GiB for premium users and includes features for personalized file captions using variables, metadata extraction via hachoir, and detailed compatibility support for various audio and video file types.
Telegram-upload supports any file type supported by Telegram, but specific video formats provide varying levels of feature support. Features include:
Hachoir.Note that results may vary across different platforms and Telegram clients.
You can install specific versions from PyPI or install development versions directly from GitHub using pip.
To install a specific version from PyPI:
$ pip install telegram-upload==<version>To install a development version from a specific git branch:
$ pip install git+https://github.com/Nekmo/telegram-upload.git@<branch>#egg=telegram_uploadIf you do not have git installed, you can install from a branch zip archive:
$ pip install https://github.com/Nekmo/telegram-upload/archive/<branch>.zipYou can download files from your Saved Messages or from a specific channel. By default, telegram-download downloads all files until the last text message.
$ telegram-downloadTo install the latest stable release of telegram-upload, run the following command in your terminal. This tool supports Python 3.7-3.11.
$ sudo pip3 install -U telegram-uploadTo verify your caption formatting and variable syntax without actually uploading files, use the telegram_upload.caption_formatter module via Python. This is the recommended way to debug complex captions.
$ python -m telegram_upload.caption_formatter file.txt "{file.absolute}"--large-files split to upload it as multiple parts. To reconstruct the file later, use the join command with telegram-download.You can add a custom message to every file you send using the --caption "<message>" argument. This message can be personalized using variables inside braces ({}).
Available top-level variables:
{file}: The file object, containing extensive metadata and attributes.{now}: The current datetime.Note on syntax:
{{ {file.name} }} becomes { file.txt }).$ telegram-upload --caption "This is a file with name {file.name}" file.txtYou can run telegram-upload without installing it on your system by using Docker. When using Docker, the commands telegram-upload and telegram-download are replaced by upload and download respectively.
Use the following command structure:
docker run -v <files_dir>:/files/ \
-v <config_dir>:/config/ \
-it nekmo/telegram-upload:master \
<command> <args>Arguments:
<files_dir>: The directory containing the files you want to upload or download.<config_dir>: The directory where the telegram-upload configuration will be stored. This directory is created automatically.<command>: Use upload or download.<args>: The arguments normally passed to telegram-upload or telegram-download.Example:
To upload file_to_upload.txt from /media/data/ using a local ./config directory:
docker run -v /media/data/:/files/ \
-v $PWD/config:/config/ \
-it nekmo/telegram-upload:master \
upload file_to_upload.txtTo install the most recent stable release of telegram-upload, use pip3 with the -U flag to ensure it is updated. This is the preferred installation method.
$ sudo pip3 install -U telegram-uploadTo install telegram-upload, use pip to install the package from PyPI. It is recommended to use the -U flag to ensure you are using the latest version.
$ pip install -U telegram-upload--delete-on-success option deletes the Telegram message after the file has been successfully downloaded. This is useful for managing storage in your Saved Messages.Activate interactive mode using the -i or --interactive option. This launches a wizard to select files and conversations.
SPACE to select multiple).SPACE to select multiple).