sticker-convert 2.10.9__py3-none-any.whl → 2.11.0__py3-none-any.whl

sticker_convert/cli.py

@@ -20,6 +20,7 @@ from sticker_convert.utils.auth.get_kakao_desktop_auth import GetKakaoDesktopAut
 from sticker_convert.utils.auth.get_line_auth import GetLineAuth
 from sticker_convert.utils.auth.get_signal_auth import GetSignalAuth
 from sticker_convert.utils.auth.get_viber_auth import GetViberAuth
+from sticker_convert.utils.auth.telethon_setup import TelethonSetup
 from sticker_convert.utils.callback import Callback
 from sticker_convert.utils.files.json_manager import JsonManager
 from sticker_convert.utils.url_detect import UrlDetect
@@ -168,10 +169,12 @@ class CLI:
         parser_cred = parser.add_argument_group("Credentials options")
         flags_cred_bool = (
             "signal_get_auth",
+            "telethon_setup",
             "kakao_get_auth",
             "kakao_get_auth_desktop",
             "line_get_auth",
             "discord_get_auth",
+            "save_cred",
         )
         for k, v in self.help["cred"].items():
             keyword_args = {}
@@ -226,6 +229,7 @@ class CLI:
             "signal": args.download_signal,
             "line": args.download_line,
             "telegram": args.download_telegram,
+            "telegram_telethon": args.download_telegram_telethon,
             "kakao": args.download_kakao,
             "viber": args.download_viber,
             "discord": args.download_discord,
@@ -266,6 +270,14 @@ class CLI:
             export_option = "signal"
         elif args.export_telegram:
             export_option = "telegram"
+        elif args.export_telegram_emoji:
+            export_option = "telegram_emoji"
+        elif args.export_telegram_telethon:
+            export_option = "telegram_telethon"
+        elif args.export_telegram_emoji_telethon:
+            export_option = "telegram_emoji_telethon"
+        elif args.export_viber:
+            export_option = "viber"
         elif args.export_imessage:
             export_option = "imessage"
         else:
@@ -291,6 +303,10 @@ class CLI:
                         args.export_whatsapp,
                         args.export_signal,
                         args.export_telegram,
+                        args.export_telegram_emoji,
+                        args.export_telegram_telethon,
+                        args.export_telegram_emoji_telethon,
+                        args.export_viber,
                         args.export_imessage,
                     )
                 )
@@ -302,8 +318,12 @@ class CLI:
                 preset = "whatsapp"
             elif args.export_signal:
                 preset = "signal"
-            elif args.export_telegram:
+            elif args.export_telegram or args.export_telegram_telethon:
                 preset = "telegram"
+            elif args.export_telegram_emoji or args.export_telegram_emoji_telethon:
+                preset = "telegram_emoji"
+            elif args.export_viber:
+                preset = "viber"
             elif args.export_imessage:
                 preset = "imessage_small"
         elif args.preset == "auto":
@@ -316,6 +336,12 @@ class CLI:
                 self.cb.msg(
                     "Auto compression option set to no_compress (Reason: Export to local directory only)"
                 )
+            elif "telegram_emoji" in output_option:
+                preset = "telegram_emoji"
+                self.cb.msg(f"Auto compression option set to {preset}")
+            elif "telegram" in output_option:
+                preset = "telegram"
+                self.cb.msg(f"Auto compression option set to {preset}")
             elif output_option == "imessage":
                 preset = "imessage_small"
                 self.cb.msg(f"Auto compression option set to {preset}")
@@ -445,6 +471,8 @@ class CLI:
             telegram_userid=args.telegram_userid
             if args.telegram_userid
             else creds.get("telegram", {}).get("userid"),
+            telethon_api_id=creds.get("telethon", {}).get("api_id"),
+            telethon_api_hash=creds.get("telethon", {}).get("api_hash"),
             kakao_auth_token=args.kakao_auth_token
             if args.kakao_auth_token
             else creds.get("kakao", {}).get("auth_token"),
@@ -511,6 +539,16 @@ class CLI:
 
             self.cb.msg("Failed to get uuid and password")
 
+        if args.telethon_setup:
+            telethon_setup = TelethonSetup(opt_cred, self.cb.ask_str)
+            success, _, telethon_api_id, telethon_api_hash = telethon_setup.start()
+
+            if success:
+                opt_cred.telethon_api_id = telethon_api_id
+                opt_cred.telethon_api_hash = telethon_api_hash
+
+                self.cb.msg("Telethon setup successful")
+
         if args.line_get_auth:
             get_line_auth = GetLineAuth()
 

sticker_convert/converter.py

@@ -434,7 +434,7 @@ class StickerConvert:
                 # Pillow is not reliable for getting webp frame durations
                 durations: Optional[List[int]]
                 if im.format == "WEBP":
-                    _, _, _, durations = CodecInfo._get_file_fps_frames_duration_webp(
+                    _, _, _, durations = CodecInfo._get_file_fps_frames_duration_webp(  # type: ignore
                         self.in_f
                     )
                 else:
@@ -764,7 +764,7 @@ class StickerConvert:
             format=self.out_f.suffix.replace(".", ""),
             options=options_container,
         ) as output:
-            out_stream = output.add_stream(codec, rate=self.fps, options=options_stream)
+            out_stream = output.add_stream(codec, rate=self.fps, options=options_stream)  # type: ignore
             out_stream = cast(VideoStream, out_stream)
             assert isinstance(self.res_w, int) and isinstance(self.res_h, int)
             out_stream.width = self.res_w
@@ -811,9 +811,12 @@ class StickerConvert:
         elif self.out_f.suffix == ".webp":
             im_out = [Image.fromarray(i) for i in self.frames_processed]  # type: ignore
             extra_kwargs["format"] = "WebP"
-            # Enabling below is too slow
-            # extra_kwargs["minimize_size"] = True
-            # extra_kwargs["method"] = 6
+            extra_kwargs["allow_mixed"] = True
+            if self.quality:
+                if self.quality < 20:
+                    extra_kwargs["minimize_size"] = True
+                extra_kwargs["method"] = 4 + int(2 * (100 - self.quality) / 100)
+                extra_kwargs["alpha_quality"] = self.quality
         else:
             raise RuntimeError(f"Invalid format {self.out_f.suffix}")
 

sticker_convert/downloaders/download_base.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 
 from functools import partial
 from pathlib import Path
-from typing import Any, List, Optional, Tuple
+from typing import Any, Dict, List, Optional, Tuple
 
 import anyio
 import httpx
@@ -34,8 +34,8 @@ class DownloadBase:
         retries: int = 3,
         headers: Optional[dict[Any, Any]] = None,
         **kwargs: Any,
-    ) -> dict[str, bool]:
-        results: dict[str, bool] = {}
+    ) -> Dict[str, bool]:
+        results: Dict[str, bool] = {}
         anyio.run(
             partial(
                 self.download_multiple_files_async,

sticker_convert/downloaders/download_signal.py

@@ -63,11 +63,13 @@ class DownloadSignal(DownloadBase):
         )
 
     def download_stickers_signal(self) -> Tuple[int, int]:
-        if "signal.art" not in self.url:
+        if "signal.art" not in self.url or not self.url.startswith(
+            "sgnl://addstickers/"
+        ):
             self.cb.put("Download failed: Unrecognized URL format")
             return 0, 0
 
-        pack_id = self.url.split("#pack_id=")[1].split("&pack_key=")[0]
+        pack_id = self.url.split("pack_id=")[1].split("&pack_key=")[0]
         pack_key = self.url.split("&pack_key=")[1]
 
         try:

sticker_convert/downloaders/download_telegram.py

@@ -1,15 +1,13 @@
 #!/usr/bin/env python3
 from pathlib import Path
-from typing import Dict, Optional, Tuple, Union
+from typing import Optional, Tuple
 from urllib.parse import urlparse
 
 import anyio
-from telegram import PhotoSize, Sticker, StickerSet
-from telegram.error import TelegramError
-from telegram.ext import AIORateLimiter, ApplicationBuilder
 
 from sticker_convert.downloaders.download_base import DownloadBase
 from sticker_convert.job_option import CredOption, InputOption
+from sticker_convert.utils.auth.telegram_api import BotAPI, TelegramAPI, TelethonAPI
 from sticker_convert.utils.callback import CallbackProtocol, CallbackReturn
 from sticker_convert.utils.files.metadata_handler import MetadataHandler
 
@@ -19,114 +17,32 @@ class DownloadTelegram(DownloadBase):
     #     super().__init__(*args, **kwargs)
 
     def download_stickers_telegram(self) -> Tuple[int, int]:
-        self.token = ""
-
-        if self.opt_cred:
-            self.token = self.opt_cred.telegram_token.strip()
-        if not self.token:
-            self.cb.put("Download failed: Token required for downloading from telegram")
-            return 0, 0
-
         if not ("telegram.me" in self.url or "t.me" in self.url):
             self.cb.put("Download failed: Unrecognized URL format")
             return 0, 0
 
-        self.title = Path(urlparse(self.url).path).name
-
-        self.emoji_dict: Dict[str, str] = {}
-
         return anyio.run(self.save_stickers)
 
     async def save_stickers(self) -> Tuple[int, int]:
-        results: dict[str, bool] = {}
-        timeout = 30
-        application = (  # type: ignore
-            ApplicationBuilder()
-            .token(self.token)
-            .rate_limiter(AIORateLimiter(max_retries=3))
-            .connect_timeout(timeout)
-            .pool_timeout(timeout)
-            .read_timeout(timeout)
-            .write_timeout(timeout)
-            .connection_pool_size(20)
-            .build()
-        )
-
-        async with application:
-            bot = application.bot
-            try:
-                sticker_set: StickerSet = await bot.get_sticker_set(
-                    self.title,
-                    read_timeout=timeout,
-                    write_timeout=timeout,
-                    connect_timeout=timeout,
-                    pool_timeout=timeout,
-                )
-            except TelegramError as e:
-                self.cb.put(
-                    f"Failed to download telegram sticker set {self.title} due to: {e}"
-                )
-                return 0, 0
-
-            self.cb.put(
-                (
-                    "bar",
-                    None,
-                    {
-                        "set_progress_mode": "determinate",
-                        "steps": len(sticker_set.stickers),
-                    },
-                )
-            )
-
-            async def download_sticker(
-                sticker: Union[PhotoSize, Sticker], f_id: str, results: dict[str, bool]
-            ) -> None:
-                try:
-                    sticker_file = await sticker.get_file(
-                        read_timeout=timeout,
-                        write_timeout=timeout,
-                        connect_timeout=timeout,
-                        pool_timeout=timeout,
-                    )
-                except TelegramError as e:
-                    self.cb.put(f"Failed to download {f_id}: {str(e)}")
-                    results[f_id] = False
-                    return
-                fpath = sticker_file.file_path
-                assert fpath is not None
-                ext = Path(fpath).suffix
-                f_name = f_id + ext
-                f_path = Path(self.out_dir, f_name)
-                await sticker_file.download_to_drive(
-                    custom_path=f_path,
-                    read_timeout=timeout,
-                    write_timeout=timeout,
-                    connect_timeout=timeout,
-                    pool_timeout=timeout,
-                )
-                if isinstance(sticker, Sticker) and sticker.emoji is not None:
-                    self.emoji_dict[f_id] = sticker.emoji
-                self.cb.put(f"Downloaded {f_name}")
-                results[f_id] = True
-                if f_id != "cover":
-                    self.cb.put("update_bar")
-
-            async with anyio.create_task_group() as tg:
-                for num, sticker in enumerate(sticker_set.stickers):
-                    f_id = str(num).zfill(3)
-                    tg.start_soon(download_sticker, sticker, f_id, results)
+        tg_api: TelegramAPI
+        if self.input_option.endswith("telethon"):
+            tg_api = TelethonAPI()
+        else:
+            tg_api = BotAPI()
+
+        if self.opt_cred is None:
+            self.cb.put("Download failed: No credentials")
+            return 0, 0
 
-                if sticker_set.thumbnail is not None:
-                    results_thumb: dict[str, bool] = {}
-                    tg.start_soon(
-                        download_sticker, sticker_set.thumbnail, "cover", results_thumb
-                    )
+        success = await tg_api.setup(self.opt_cred, False, self.cb, self.cb_return)
+        if success is False:
+            self.cb.put("Download failed: Invalid credentials")
+            return 0, 0
 
-        MetadataHandler.set_metadata(
-            self.out_dir, title=self.title, emoji_dict=self.emoji_dict
-        )
-        return sum(results.values()), len(sticker_set.stickers)
+        title = Path(urlparse(self.url).path).name
+        results, emoji_dict = await tg_api.pack_dl(title, self.out_dir)
+        MetadataHandler.set_metadata(self.out_dir, title=title, emoji_dict=emoji_dict)
+        return sum(results.values()), len(results)
 
     @staticmethod
     def start(

sticker_convert/gui.py

@@ -154,6 +154,8 @@ class GUI(Window):
         self.signal_password_var = StringVar(self)
         self.telegram_token_var = StringVar(self)
         self.telegram_userid_var = StringVar(self)
+        self.telethon_api_id_var = IntVar(self)
+        self.telethon_api_hash_var = StringVar(self)
         self.kakao_auth_token_var = StringVar(self)
         self.kakao_username_var = StringVar(self)
         self.kakao_password_var = StringVar(self)
@@ -406,6 +408,10 @@ class GUI(Window):
         self.signal_password_var.set(self.creds.get("signal", {}).get("password", ""))
         self.telegram_token_var.set(self.creds.get("telegram", {}).get("token", ""))
         self.telegram_userid_var.set(self.creds.get("telegram", {}).get("userid", ""))
+        self.telethon_api_id_var.set(self.creds.get("telethon", {}).get("api_id", 0))
+        self.telethon_api_hash_var.set(
+            self.creds.get("telethon", {}).get("api_hash", "")
+        )
         self.kakao_auth_token_var.set(self.creds.get("kakao", {}).get("auth_token", ""))
         self.kakao_username_var.set(self.creds.get("kakao", {}).get("username", ""))
         self.kakao_password_var.set(self.creds.get("kakao", {}).get("password", ""))
@@ -451,6 +457,10 @@ class GUI(Window):
         selection = self.comp_preset_var.get()
         if selection == "auto":
             output_option = self.get_output_name()
+            if "telegram_emoji" in output_option:
+                return "telegram_emoji"
+            if "telegram" in output_option:
+                return "telegram"
             if output_option == "imessage":
                 return "imessage_small"
             if output_option == "local":
@@ -572,6 +582,8 @@ class GUI(Window):
             signal_password=self.signal_password_var.get(),
             telegram_token=self.telegram_token_var.get(),
             telegram_userid=self.telegram_userid_var.get(),
+            telethon_api_id=self.telethon_api_id_var.get(),
+            telethon_api_hash=self.telethon_api_hash_var.get(),
             kakao_auth_token=self.kakao_auth_token_var.get(),
             kakao_username=self.kakao_username_var.get(),
             kakao_password=self.kakao_password_var.get(),

sticker_convert/gui_components/frames/cred_frame.py

@@ -10,6 +10,7 @@ from sticker_convert.gui_components.windows.kakao_get_auth_window import KakaoGe
 from sticker_convert.gui_components.windows.line_get_auth_window import LineGetAuthWindow
 from sticker_convert.gui_components.windows.signal_get_auth_window import SignalGetAuthWindow
 from sticker_convert.gui_components.windows.viber_get_auth_window import ViberGetAuthWindow
+from sticker_convert.utils.auth.telethon_setup import TelethonSetup
 
 if TYPE_CHECKING:
     from sticker_convert.gui import GUI  # type: ignore
@@ -77,6 +78,16 @@ class CredFrame(LabelFrame):
         )
         self.telegram_userid_entry.bind("<Button-3><ButtonRelease-3>", RightClicker)
 
+        self.telethon_auth_lbl = Label(
+            self, text="Telethon authorization", justify="left", anchor="w"
+        )
+        self.telethon_auth_btn = Button(
+            self,
+            text="Generate",
+            command=self.cb_telethon_get_auth,
+            bootstyle="secondary",  # type: ignore
+        )
+
         self.kakao_auth_token_lbl = Label(
             self, text="Kakao auth_token", justify="left", anchor="w"
         )
@@ -157,19 +168,21 @@ class CredFrame(LabelFrame):
         self.telegram_userid_entry.grid(
             column=1, row=4, columnspan=2, sticky="w", padx=3, pady=3
         )
-        self.kakao_auth_token_lbl.grid(column=0, row=5, sticky="w", padx=3, pady=3)
-        self.kakao_auth_token_entry.grid(column=1, row=5, sticky="w", padx=3, pady=3)
-        self.kakao_get_auth_btn.grid(column=2, row=5, sticky="e", padx=3, pady=3)
-        self.line_cookies_lbl.grid(column=0, row=6, sticky="w", padx=3, pady=3)
-        self.line_cookies_entry.grid(column=1, row=6, sticky="w", padx=3, pady=3)
-        self.line_get_auth_btn.grid(column=2, row=6, sticky="e", padx=3, pady=3)
-        self.viber_auth_lbl.grid(column=0, row=7, sticky="w", padx=3, pady=3)
-        self.viber_auth_entry.grid(column=1, row=7, sticky="w", padx=3, pady=3)
-        self.viber_get_auth_btn.grid(column=2, row=7, sticky="e", padx=3, pady=3)
-        self.discord_token_lbl.grid(column=0, row=8, sticky="w", padx=3, pady=3)
-        self.discord_token_entry.grid(column=1, row=8, sticky="w", padx=3, pady=3)
-        self.discord_get_auth_btn.grid(column=2, row=8, sticky="e", padx=3, pady=3)
-        self.help_btn.grid(column=2, row=9, sticky="e", padx=3, pady=3)
+        self.telethon_auth_lbl.grid(column=0, row=5, sticky="w", padx=3, pady=3)
+        self.telethon_auth_btn.grid(column=2, row=5, sticky="e", padx=3, pady=3)
+        self.kakao_auth_token_lbl.grid(column=0, row=6, sticky="w", padx=3, pady=3)
+        self.kakao_auth_token_entry.grid(column=1, row=6, sticky="w", padx=3, pady=3)
+        self.kakao_get_auth_btn.grid(column=2, row=6, sticky="e", padx=3, pady=3)
+        self.line_cookies_lbl.grid(column=0, row=7, sticky="w", padx=3, pady=3)
+        self.line_cookies_entry.grid(column=1, row=7, sticky="w", padx=3, pady=3)
+        self.line_get_auth_btn.grid(column=2, row=7, sticky="e", padx=3, pady=3)
+        self.viber_auth_lbl.grid(column=0, row=8, sticky="w", padx=3, pady=3)
+        self.viber_auth_entry.grid(column=1, row=8, sticky="w", padx=3, pady=3)
+        self.viber_get_auth_btn.grid(column=2, row=8, sticky="e", padx=3, pady=3)
+        self.discord_token_lbl.grid(column=0, row=9, sticky="w", padx=3, pady=3)
+        self.discord_token_entry.grid(column=1, row=9, sticky="w", padx=3, pady=3)
+        self.discord_get_auth_btn.grid(column=2, row=9, sticky="e", padx=3, pady=3)
+        self.help_btn.grid(column=2, row=10, sticky="e", padx=3, pady=3)
 
     def cb_cred_help(self, *_: Any) -> None:
         faq_site = "https://github.com/laggykiller/sticker-convert#faq"
@@ -177,6 +190,18 @@ class CredFrame(LabelFrame):
         if not success:
             self.gui.cb_ask_str("You can get help from:", initialvalue=faq_site)
 
+    def cb_telethon_get_auth(self, *_: Any) -> None:
+        success, _client, api_id, api_hash = TelethonSetup(
+            self.gui.get_opt_cred(), self.gui.cb_ask_str
+        ).start()
+        if success:
+            self.gui.telethon_api_id_var.set(api_id)
+            self.gui.telethon_api_hash_var.set(api_hash)
+            self.gui.save_creds()
+            self.gui.cb_msg_block("Telethon setup successful")
+        else:
+            self.gui.cb_msg_block("Telethon setup failed")
+
     def cb_kakao_get_auth(self, *_: Any) -> None:
         KakaoGetAuthWindow(self.gui)
 

sticker_convert/job.py

@@ -379,7 +379,10 @@ class Job:
             not self.opt_comp.no_compress
             and self.opt_output.option != "local"
             and self.opt_comp.preset != "custom"
-            and self.opt_output.option not in self.opt_comp.preset
+            and (
+                self.opt_output.option not in self.opt_comp.preset
+                and self.opt_comp.preset not in self.opt_output.option
+            )
         ):
             msg = "Compression preset does not match export option\n"
             msg += "You may continue, but the files will need to be compressed again before export\n"
@@ -551,7 +554,7 @@ class Job:
         if self.opt_input.option == "line":
             downloaders.append(DownloadLine.start)
 
-        if self.opt_input.option == "telegram":
+        if self.opt_input.option.startswith("telegram"):
             downloaders.append(DownloadTelegram.start)
 
         if self.opt_input.option == "kakao":
@@ -702,10 +705,7 @@ class Job:
         if self.opt_output.option == "signal":
             exporters.append(UploadSignal.start)
 
-        if self.opt_output.option == "telegram":
-            exporters.append(UploadTelegram.start)
-
-        if self.opt_output.option == "telegram_emoji":
+        if self.opt_output.option.startswith("telegram"):
             exporters.append(UploadTelegram.start)
 
         if self.opt_output.option == "imessage":

sticker_convert/job_option.py

@@ -214,6 +214,8 @@ class CredOption(BaseOption):
     signal_password: str = ""
     telegram_token: str = ""
     telegram_userid: str = ""
+    telethon_api_id: int = 0
+    telethon_api_hash: str = ""
     kakao_auth_token: str = ""
     kakao_username: str = ""
     kakao_password: str = ""
@@ -227,6 +229,10 @@ class CredOption(BaseOption):
         return {
             "signal": {"uuid": self.signal_uuid, "password": self.signal_password},
             "telegram": {"token": self.telegram_token, "userid": self.telegram_userid},
+            "telethon": {
+                "api_id": self.telethon_api_id,
+                "api_hash": self.telethon_api_hash,
+            },
             "kakao": {
                 "auth_token": self.kakao_auth_token,
                 "username": self.kakao_username,

sticker_convert/resources/compression.json

@@ -213,8 +213,8 @@
             "power": 3
         },
         "quality": {
-            "min": 10,
-            "max": 95,
+            "min": 0,
+            "max": 100,
             "power": 5
         },
         "color": {

sticker_convert/resources/help.json

@@ -59,7 +59,8 @@
         "signal_password": "Set Signal password. Required for uploading Signal stickers.",
         "signal_get_auth": "Generate Signal uuid and password.",
         "telegram_token": "Set Telegram token. Required for uploading and downloading Telegram stickers.",
-        "telegram_userid": "Set telegram user_id (From real account, not bot account). Required for uploading Telegram stickers.",
+        "telegram_userid": "Set Telegram user_id (From real account, not bot account). Required for uploading Telegram stickers.",
+        "telethon_setup": "Setup Telethon",
         "kakao_auth_token": "Set Kakao auth_token. Required for downloading animated stickers from https://e.kakao.com/t/xxxxx",
         "kakao_get_auth": "Generate Kakao auth_token by simulating login. Kakao username, password, country code and phone number are also required.",
         "kakao_get_auth_desktop": "Get Kakao auth_token from Kakao Desktop application.\n(Only working on Windows.)",
@@ -75,6 +76,6 @@
         "viber_bin_path": "Specify location of Viber Desktop application.\nUseful for portable installation.",
         "discord_get_auth": "Get Discord token.",
         "discord_token": "Set Discord token. Required for downloading Discord stickers and emojis.",
-        "save_cred": "Save Signal and Telegram credentials."
+        "save_cred": "Save credentials."
     }
 }

sticker_convert/resources/input.json

@@ -29,6 +29,16 @@
             "author": false
         }
     },
+    "telegram_telethon": {
+        "full_name": "Download from Telegram with Telethon",
+        "help": "Download telegram stickers from a URL as input with Telethon",
+        "example": "Example: https://telegram.me/addstickers/xxxxx\n OR https://telegram.me/addemoji/xxxxx",
+        "address_lbls": "URL address",
+        "metadata_provides": {
+            "title": true,
+            "author": false
+        }
+    },
     "line": {
         "full_name": "Download from Line",
         "help": "Download line stickers from a URL / ID as input",

sticker_convert/resources/output.json

@@ -23,6 +23,22 @@
             "author": false
         }
     },
+    "telegram_telethon": {
+        "full_name": "Upload to Telegram with Telethon",
+        "help": "Upload to Telegram with Telethon *Not recommended, but allow link not end with _by_xxxbot*",
+        "metadata_requirements": {
+            "title": true,
+            "author": false
+        }
+    },
+    "telegram_emoji_telethon": {
+        "full_name": "Upload to Telegram with Telethon (Custom emoji)",
+        "help": "Upload to Telegram with Telethon (Custom emoji) *Not recommended, but allow link not end with _by_xxxbot*",
+        "metadata_requirements": {
+            "title": true,
+            "author": false
+        }
+    },
     "viber": {
         "full_name": "Upload to Viber",
         "help": "Upload to Viber",