sticker-convert 2.7.7__py3-none-any.whl → 2.7.9__py3-none-any.whl

sticker_convert/cli.py

@@ -114,6 +114,7 @@ class CLI:
         )
         flags_comp_float = ("fps_power", "res_power", "quality_power", "color_power")
         flags_comp_str = (
+            "bg_color",
             "vid_format",
             "img_format",
             "cache_dir",
@@ -350,6 +351,9 @@ class CLI:
             duration_max=self.compression_presets[preset]["duration"]["max"]
             if args.duration_max is None
             else args.duration_max,
+            bg_color=self.compression_presets[preset]["bg_color"]
+            if args.bg_color is None
+            else args.bg_color,
             steps=self.compression_presets[preset]["steps"]
             if args.steps is None
             else args.steps,

sticker_convert/converter.py

@@ -6,10 +6,11 @@ from io import BytesIO
 from math import ceil, floor
 from pathlib import Path
 from queue import Queue
-from typing import TYPE_CHECKING, Any, List, Literal, Optional, Tuple, Union, cast
+from typing import TYPE_CHECKING, Any, Dict, List, Literal, Optional, Tuple, Union, cast
 
 import numpy as np
 from PIL import Image
+from PIL import __version__ as PillowVersion
 
 from sticker_convert.job_option import CompOption
 from sticker_convert.utils.callback import Callback, CallbackReturn, CbQueueItemType
@@ -378,10 +379,10 @@ class StickerConvert:
                 self.frames_raw.append(np.asarray(im.convert("RGBA")))
 
     def _frames_import_pyav(self) -> None:
-        import av  # type: ignore
-        from av.codec.context import CodecContext  # type: ignore
-        from av.container.input import InputContainer  # type: ignore
-        from av.video.codeccontext import VideoCodecContext  # type: ignore
+        import av
+        from av.codec.context import CodecContext
+        from av.container.input import InputContainer
+        from av.video.codeccontext import VideoCodecContext
 
         # Crashes when handling some webm in yuv420p and convert to rgba
         # https://github.com/PyAV-Org/PyAV/issues/1166
@@ -390,16 +391,17 @@ class StickerConvert:
             file = self.in_f.as_posix()
         else:
             file = BytesIO(self.in_f)
-        with av.open(file) as container:  # type: ignore
+        with av.open(file) as container:
             container = cast(InputContainer, container)
             context = container.streams.video[0].codec_context
             if context.name == "vp8":
-                context = CodecContext.create("libvpx", "r")  # type: ignore
+                context = cast(VideoCodecContext, CodecContext.create("libvpx", "r"))
             elif context.name == "vp9":
-                context = CodecContext.create("libvpx-vp9", "r")  # type: ignore
-            context = cast(VideoCodecContext, context)
+                context = cast(
+                    VideoCodecContext, CodecContext.create("libvpx-vp9", "r")
+                )
 
-            for packet in container.demux(container.streams.video):  # type: ignore
+            for packet in container.demux(container.streams.video):
                 for frame in context.decode(packet):
                     if frame.width % 2 != 0:
                         width = frame.width - 1
@@ -410,22 +412,22 @@ class StickerConvert:
                     else:
                         height = frame.height
                     if frame.format.name == "yuv420p":
-                        rgb_array = frame.to_ndarray(format="rgb24")  # type: ignore
+                        rgb_array = frame.to_ndarray(format="rgb24")
                         cast("np.ndarray[Any, Any]", rgb_array)
                         rgba_array = np.dstack(
                             (
                                 rgb_array,
                                 np.zeros(rgb_array.shape[:2], dtype=np.uint8) + 255,
-                            )  # type: ignore
+                            )
                         )
                     else:
                         # yuva420p may cause crash
                         # https://github.com/laggykiller/sticker-convert/issues/114
-                        frame = frame.reformat(  # type: ignore
+                        frame = frame.reformat(
                             width=width,
                             height=height,
                             format="yuva420p",
-                            dst_colorspace=1,  # type: ignore
+                            dst_colorspace=1,
                         )
 
                         # https://stackoverflow.com/questions/72308308/converting-yuv-to-rgb-in-python-coefficients-work-with-array-dont-work-with-n
@@ -522,7 +524,27 @@ class StickerConvert:
         elif self.opt_comp.scale_filter == "lanczos":
             resample = Image.LANCZOS
         else:
-            resample = Image.LANCZOS
+            resample = Image.BICUBIC
+
+        if not self.opt_comp.bg_color:
+            # Calculate average color of all frames for selecting background color
+            frames_raw_np = np.array(self.frames_raw)
+            s = frames_raw_np.shape
+            colors = frames_raw_np.reshape((-1, s[3]))  # type: ignore
+            # Do not count in alpha=0
+            # If alpha > 0, use alpha as weight
+            colors = colors[colors[:, 3] != 0]
+            if colors.shape[0] == 0:
+                bg = (0, 0, 0, 0)
+            else:
+                colors = colors * (colors[3] / 255)
+                if np.mean(colors[:, :3]) < 128:
+                    bg = (255, 255, 255, 0)
+                else:
+                    bg = (0, 0, 0, 0)
+        else:
+            r, g, b = bytes.fromhex(self.opt_comp.bg_color)
+            bg = (r, g, b, 0)
 
         for frame in frames_in:
             with Image.fromarray(frame, "RGBA") as im:  # type: ignore
@@ -541,10 +563,8 @@ class StickerConvert:
                 width_new = width * self.res_h // height
 
             with im.resize((width_new, height_new), resample=resample) as im_resized:
-                with Image.new(
-                    "RGBA", (self.res_w, self.res_h), (0, 0, 0, 0)
-                ) as im_new:
-                    im_new.paste(
+                with Image.new("RGBA", (self.res_w, self.res_h), bg) as im_new:
+                    im_new.alpha_composite(
                         im_resized,
                         ((self.res_w - width_new) // 2, (self.res_h - height_new) // 2),
                     )
@@ -615,6 +635,8 @@ class StickerConvert:
                 self._frames_export_png()
         elif self.out_f.suffix == ".webp" and is_animated:
             self._frames_export_webp()
+        elif self.out_f.suffix == ".gif":
+            self._frames_export_gif()
         elif self.out_f.suffix in (".webm", ".mp4", ".mkv") or is_animated:
             self._frames_export_pyav()
         else:
@@ -629,22 +651,17 @@ class StickerConvert:
             )
 
     def _frames_export_pyav(self) -> None:
-        import av  # type: ignore
-        from av.container import OutputContainer  # type: ignore
-        from av.video.stream import VideoStream  # type: ignore
+        import av
+        from av.video.stream import VideoStream
 
-        options = {}
+        options: Dict[str, str] = {}
 
         if isinstance(self.quality, int):
             # Seems not actually working
             options["quality"] = str(self.quality)
             options["lossless"] = "0"
 
-        if self.out_f.suffix == ".gif":
-            codec = "gif"
-            pixel_format = "rgb8"
-            options["loop"] = "0"
-        elif self.out_f.suffix in (".apng", ".png"):
+        if self.out_f.suffix in (".apng", ".png"):
             codec = "apng"
             pixel_format = "rgba"
             options["plays"] = "0"
@@ -657,11 +674,10 @@ class StickerConvert:
             pixel_format = "yuv420p"
             options["loop"] = "0"
 
-        with av.open(  # type: ignore
+        with av.open(
             self.tmp_f, "w", format=self.out_f.suffix.replace(".", "")
         ) as output:
-            output = cast(OutputContainer, output)  # type: ignore
-            out_stream = output.add_stream(codec, rate=self.fps, options=options)  # type: ignore
+            out_stream = output.add_stream(codec, rate=self.fps, options=options)
             out_stream = cast(VideoStream, out_stream)
             assert isinstance(self.res_w, int) and isinstance(self.res_h, int)
             out_stream.width = self.res_w
@@ -669,12 +685,49 @@ class StickerConvert:
             out_stream.pix_fmt = pixel_format
 
             for frame in self.frames_processed:
-                av_frame = av.VideoFrame.from_ndarray(frame, format="rgba")  # type: ignore
-                for packet in out_stream.encode(av_frame):  # type: ignore
-                    output.mux(packet)  # type: ignore
-
-            for packet in out_stream.encode():  # type: ignore
-                output.mux(packet)  # type: ignore
+                av_frame = av.VideoFrame.from_ndarray(frame, format="rgba")
+                output.mux(out_stream.encode(av_frame))
+            output.mux(out_stream.encode())
+
+    def _frames_export_gif(self) -> None:
+        extra_kwargs: Dict[str, Any] = {}
+
+        # disposal=2 on gif cause flicker in image with transparency
+        # Occurs in Pillow == 10.2.0
+        # https://github.com/python-pillow/Pillow/issues/7787
+        if PillowVersion == "10.2.0":
+            extra_kwargs["optimize"] = False
+        else:
+            extra_kwargs["optimize"] = True
+
+        # Only enable transparency if all pixels have alpha channel
+        # with value of 0 or 255
+        alpha_channel_values = np.unique(np.array(self.frames_raw)[:, :, :, 3])
+        illegals = np.setxor1d(
+            alpha_channel_values, [0, 255]
+        )  # Find all values not 0 or 255
+        if illegals.size == 0:
+            extra_kwargs["transparency"] = 0
+            extra_kwargs["disposal"] = 2
+            im_out = [self.quantize(Image.fromarray(i)) for i in self.frames_processed]
+        else:
+            im_out = [
+                self.quantize(Image.fromarray(i).convert("RGB")).convert("RGB")
+                for i in self.frames_processed
+            ]
+
+        if self.fps:
+            extra_kwargs["save_all"] = True
+            extra_kwargs["append_images"] = im_out[1:]
+            extra_kwargs["duration"] = int(1000 / self.fps)
+            extra_kwargs["loop"] = 0
+
+        im_out[0].save(
+            self.tmp_f,
+            format="GIF",
+            quality=self.quality,
+            **extra_kwargs,
+        )
 
     def _frames_export_webp(self) -> None:
         import webp  # type: ignore

sticker_convert/gui.py

@@ -12,6 +12,7 @@ from threading import Thread
 from typing import Any, Callable, Dict, Optional, Union
 from urllib.parse import urlparse
 
+from mergedeep import merge  # type: ignore
 from PIL import ImageFont
 from ttkbootstrap import BooleanVar, DoubleVar, IntVar, StringVar, Toplevel, Window  # type: ignore
 from ttkbootstrap.dialogs import Messagebox, Querybox  # type: ignore
@@ -127,6 +128,7 @@ class GUI(Window):
         self.img_size_max_var = IntVar(self)
         self.vid_size_max_var = IntVar(self)
         self.size_disable_var = BooleanVar()
+        self.bg_color_var = StringVar()
         self.img_format_var = StringVar(self)
         self.vid_format_var = StringVar(self)
         self.fake_vid_var = BooleanVar()
@@ -265,7 +267,12 @@ class GUI(Window):
     def save_config(self) -> None:
         # Only update comp_custom if custom preset is selected
         if self.comp_preset_var.get() == "custom":
-            comp_custom = self.get_opt_comp().to_dict()
+            comp_custom: Dict[Any, Any] = merge(  # type: ignore
+                self.compression_presets.get("custom"),  # type: ignore
+                self.get_opt_comp().to_dict(),
+            )
+            comp_custom["format"]["img"] = comp_custom["format"]["img"][0]
+            comp_custom["format"]["vid"] = comp_custom["format"]["vid"][0]
             del comp_custom["preset"]
             del comp_custom["no_compress"]
         else:
@@ -332,7 +339,9 @@ class GUI(Window):
         )
         comp_custom = self.settings.get("comp_custom")
         if comp_custom:
-            self.compression_presets["custom"] = comp_custom
+            self.compression_presets["custom"] = merge(
+                self.compression_presets["custom"], comp_custom
+            )
         self.cache_dir_var.set(self.settings.get("comp", {}).get("cache_dir", ""))
         self.processes_var.set(
             self.settings.get("comp", {}).get("processes", ceil(cpu_count() / 2))
@@ -509,6 +518,7 @@ class GUI(Window):
             duration_max=self.duration_max_var.get()
             if not self.duration_disable_var.get()
             else None,
+            bg_color=self.bg_color_var.get(),
             steps=self.steps_var.get(),
             fake_vid=self.fake_vid_var.get(),
             scale_filter=self.scale_filter_var.get(),

sticker_convert/gui_components/frames/comp_frame.py

@@ -110,73 +110,33 @@ class CompFrame(LabelFrame):
             else:
                 self.gui.no_compress_var.set(False)
 
-        self.gui.fps_min_var.set(self.gui.compression_presets[selection]["fps"]["min"])
-        self.gui.fps_max_var.set(self.gui.compression_presets[selection]["fps"]["max"])
-        self.gui.fps_power_var.set(
-            self.gui.compression_presets[selection]["fps"]["power"]
-        )
-        self.gui.res_w_min_var.set(
-            self.gui.compression_presets[selection]["res"]["w"]["min"]
-        )
-        self.gui.res_w_max_var.set(
-            self.gui.compression_presets[selection]["res"]["w"]["max"]
-        )
-        self.gui.res_h_min_var.set(
-            self.gui.compression_presets[selection]["res"]["h"]["min"]
-        )
-        self.gui.res_h_max_var.set(
-            self.gui.compression_presets[selection]["res"]["h"]["max"]
-        )
-        self.gui.res_power_var.set(
-            self.gui.compression_presets[selection]["res"]["power"]
-        )
-        self.gui.quality_min_var.set(
-            self.gui.compression_presets[selection]["quality"]["min"]
-        )
-        self.gui.quality_max_var.set(
-            self.gui.compression_presets[selection]["quality"]["max"]
-        )
-        self.gui.quality_power_var.set(
-            self.gui.compression_presets[selection]["quality"]["power"]
-        )
-        self.gui.color_min_var.set(
-            self.gui.compression_presets[selection]["color"]["min"]
-        )
-        self.gui.color_max_var.set(
-            self.gui.compression_presets[selection]["color"]["max"]
-        )
-        self.gui.color_power_var.set(
-            self.gui.compression_presets[selection]["color"]["power"]
-        )
-        self.gui.duration_min_var.set(
-            self.gui.compression_presets[selection]["duration"]["min"]
-        )
-        self.gui.duration_max_var.set(
-            self.gui.compression_presets[selection]["duration"]["max"]
-        )
-        self.gui.img_size_max_var.set(
-            self.gui.compression_presets[selection]["size_max"]["img"]
-        )
-        self.gui.vid_size_max_var.set(
-            self.gui.compression_presets[selection]["size_max"]["vid"]
-        )
-        self.gui.img_format_var.set(
-            self.gui.compression_presets[selection]["format"]["img"]
-        )
-        self.gui.vid_format_var.set(
-            self.gui.compression_presets[selection]["format"]["vid"]
-        )
-        self.gui.fake_vid_var.set(self.gui.compression_presets[selection]["fake_vid"])
-        self.gui.scale_filter_var.set(
-            self.gui.compression_presets[selection]["scale_filter"]
-        )
-        self.gui.quantize_method_var.set(
-            self.gui.compression_presets[selection]["quantize_method"]
-        )
-        self.gui.default_emoji_var.set(
-            self.gui.compression_presets[selection]["default_emoji"]
-        )
-        self.gui.steps_var.set(self.gui.compression_presets[selection]["steps"])
+        preset = self.gui.compression_presets[selection]
+        self.gui.fps_min_var.set(preset.get("fps", {}).get("min"))
+        self.gui.fps_max_var.set(preset.get("fps", {}).get("max"))
+        self.gui.fps_power_var.set(preset.get("fps", {}).get("power"))
+        self.gui.res_w_min_var.set(preset.get("res", {}).get("w", {}).get("min"))
+        self.gui.res_w_max_var.set(preset.get("res", {}).get("w", {}).get("max"))
+        self.gui.res_h_min_var.set(preset.get("res", {}).get("h", {}).get("min"))
+        self.gui.res_h_max_var.set(preset.get("res", {}).get("h", {}).get("max"))
+        self.gui.res_power_var.set(preset.get("res", {}).get("power"))
+        self.gui.quality_min_var.set(preset.get("quality", {}).get("min"))
+        self.gui.quality_max_var.set(preset.get("quality", {}).get("max"))
+        self.gui.quality_power_var.set(preset.get("quality", {}).get("power"))
+        self.gui.color_min_var.set(preset.get("color", {}).get("min"))
+        self.gui.color_max_var.set(preset.get("color", {}).get("max"))
+        self.gui.color_power_var.set(preset.get("color", {}).get("power"))
+        self.gui.duration_min_var.set(preset.get("duration", {}).get("min"))
+        self.gui.duration_max_var.set(preset.get("duration", {}).get("max"))
+        self.gui.img_size_max_var.set(preset.get("size_max", {}).get("img"))
+        self.gui.vid_size_max_var.set(preset.get("size_max", {}).get("vid"))
+        self.gui.img_format_var.set(preset.get("format", {}).get("img"))
+        self.gui.vid_format_var.set(preset.get("format", {}).get("vid"))
+        self.gui.bg_color_var.set(preset.get("bg_color"))
+        self.gui.fake_vid_var.set(preset.get("fake_vid"))
+        self.gui.scale_filter_var.set(preset.get("scale_filter"))
+        self.gui.quantize_method_var.set(preset.get("quantize_method"))
+        self.gui.default_emoji_var.set(preset.get("default_emoji"))
+        self.gui.steps_var.set(preset.get("steps"))
 
         self.cb_no_compress()
         self.gui.highlight_fields()

sticker_convert/gui_components/windows/advanced_compression_window.py

@@ -2,6 +2,7 @@
 from __future__ import annotations
 
 from functools import partial
+from tkinter import colorchooser
 from typing import Any, List, Tuple
 
 from PIL import Image, ImageDraw, ImageTk
@@ -13,7 +14,7 @@ from sticker_convert.gui_components.windows.base_window import BaseWindow
 
 
 class AdvancedCompressionWindow(BaseWindow):
-    emoji_column_per_row = 10
+    emoji_column_per_row = 8
     emoji_visible_rows = 5
     emoji_btns: List[Tuple[Button, ImageTk.PhotoImage]] = []
 
@@ -33,15 +34,7 @@ class AdvancedCompressionWindow(BaseWindow):
 
         self.frame_advcomp.grid_columnconfigure(6, weight=1)
 
-        cb_msg_block_adv_comp_win = partial(self.gui.cb_msg_block, parent=self)
-
-        self.fps_help_btn = Button(
-            self.frame_advcomp,
-            text="?",
-            width=1,
-            command=lambda: cb_msg_block_adv_comp_win(self.gui.help["comp"]["fps"]),
-            bootstyle="secondary",  # type: ignore
-        )
+        self.fps_help_btn = self.add_help_btn(self.gui.help["comp"]["fps"])
         self.fps_lbl = Label(self.frame_advcomp, text="Output FPS")
         self.fps_min_lbl = Label(self.frame_advcomp, text="Min:")
         self.fps_min_entry = Entry(
@@ -63,13 +56,7 @@ class AdvancedCompressionWindow(BaseWindow):
             bootstyle="danger-round-toggle",  # type: ignore
         )
 
-        self.res_w_help_btn = Button(
-            self.frame_advcomp,
-            text="?",
-            width=1,
-            command=lambda: cb_msg_block_adv_comp_win(self.gui.help["comp"]["res"]),
-            bootstyle="secondary",  # type: ignore
-        )
+        self.res_w_help_btn = self.add_help_btn(self.gui.help["comp"]["res"])
         self.res_w_lbl = Label(self.frame_advcomp, text="Output resolution (Width)")
         self.res_w_min_lbl = Label(self.frame_advcomp, text="Min:")
         self.res_w_min_entry = Entry(
@@ -91,13 +78,7 @@ class AdvancedCompressionWindow(BaseWindow):
             bootstyle="danger-round-toggle",  # type: ignore
         )
 
-        self.res_h_help_btn = Button(
-            self.frame_advcomp,
-            text="?",
-            width=1,
-            command=lambda: cb_msg_block_adv_comp_win(self.gui.help["comp"]["res"]),
-            bootstyle="secondary",  # type: ignore
-        )
+        self.res_h_help_btn = self.add_help_btn(self.gui.help["comp"]["res"])
         self.res_h_lbl = Label(self.frame_advcomp, text="Output resolution (Height)")
         self.res_h_min_lbl = Label(self.frame_advcomp, text="Min:")
         self.res_h_min_entry = Entry(
@@ -119,13 +100,7 @@ class AdvancedCompressionWindow(BaseWindow):
             bootstyle="danger-round-toggle",  # type: ignore
         )
 
-        self.quality_help_btn = Button(
-            self.frame_advcomp,
-            text="?",
-            width=1,
-            command=lambda: cb_msg_block_adv_comp_win(self.gui.help["comp"]["quality"]),
-            bootstyle="secondary",  # type: ignore
-        )
+        self.quality_help_btn = self.add_help_btn(self.gui.help["comp"]["quality"])
         self.quality_lbl = Label(self.frame_advcomp, text="Output quality (0-100)")
         self.quality_min_lbl = Label(self.frame_advcomp, text="Min:")
         self.quality_min_entry = Entry(
@@ -147,13 +122,7 @@ class AdvancedCompressionWindow(BaseWindow):
             bootstyle="danger-round-toggle",  # type: ignore
         )
 
-        self.color_help_btn = Button(
-            self.frame_advcomp,
-            text="?",
-            width=1,
-            command=lambda: cb_msg_block_adv_comp_win(self.gui.help["comp"]["color"]),
-            bootstyle="secondary",  # type: ignore
-        )
+        self.color_help_btn = self.add_help_btn(self.gui.help["comp"]["color"])
         self.color_lbl = Label(self.frame_advcomp, text="Colors (0-256)")
         self.color_min_lbl = Label(self.frame_advcomp, text="Min:")
         self.color_min_entry = Entry(
@@ -175,15 +144,7 @@ class AdvancedCompressionWindow(BaseWindow):
             bootstyle="danger-round-toggle",  # type: ignore
         )
 
-        self.duration_help_btn = Button(
-            self.frame_advcomp,
-            text="?",
-            width=1,
-            command=lambda: cb_msg_block_adv_comp_win(
-                self.gui.help["comp"]["duration"]
-            ),
-            bootstyle="secondary",  # type: ignore
-        )
+        self.duration_help_btn = self.add_help_btn(self.gui.help["comp"]["duration"])
         self.duration_lbl = Label(self.frame_advcomp, text="Duration (Miliseconds)")
         self.duration_min_lbl = Label(self.frame_advcomp, text="Min:")
         self.duration_min_entry = Entry(
@@ -205,13 +166,7 @@ class AdvancedCompressionWindow(BaseWindow):
             bootstyle="danger-round-toggle",  # type: ignore
         )
 
-        self.size_help_btn = Button(
-            self.frame_advcomp,
-            text="?",
-            width=1,
-            command=lambda: cb_msg_block_adv_comp_win(self.gui.help["comp"]["size"]),
-            bootstyle="secondary",  # type: ignore
-        )
+        self.size_help_btn = self.add_help_btn(self.gui.help["comp"]["size"])
         self.size_lbl = Label(self.frame_advcomp, text="Maximum file size (bytes)")
         self.img_size_max_lbl = Label(self.frame_advcomp, text="Img:")
         self.img_size_max_entry = Entry(
@@ -233,13 +188,7 @@ class AdvancedCompressionWindow(BaseWindow):
             bootstyle="danger-round-toggle",  # type: ignore
         )
 
-        self.format_help_btn = Button(
-            self.frame_advcomp,
-            text="?",
-            width=1,
-            command=lambda: cb_msg_block_adv_comp_win(self.gui.help["comp"]["format"]),
-            bootstyle="secondary",  # type: ignore
-        )
+        self.format_help_btn = self.add_help_btn(self.gui.help["comp"]["format"])
         self.format_lbl = Label(self.frame_advcomp, text="File format")
         self.img_format_lbl = Label(self.frame_advcomp, text="Img:")
         self.img_format_entry = Entry(
@@ -252,15 +201,7 @@ class AdvancedCompressionWindow(BaseWindow):
         )
         self.vid_format_entry.bind("<Button-3><ButtonRelease-3>", RightClicker)
 
-        self.power_help_btn1 = Button(
-            self.frame_advcomp,
-            text="?",
-            width=1,
-            command=lambda: cb_msg_block_adv_comp_win(
-                self.gui.help["comp"]["fps_power"]
-            ),
-            bootstyle="secondary",  # type: ignore
-        )
+        self.power_help_btn1 = self.add_help_btn(self.gui.help["comp"]["fps_power"])
         self.power_lbl1 = Label(self.frame_advcomp, text="Power (Importance)")
         self.fps_power_lbl = Label(self.frame_advcomp, text="FPS:")
         self.fps_power_entry = Entry(
@@ -273,15 +214,7 @@ class AdvancedCompressionWindow(BaseWindow):
         )
         self.res_power_entry.bind("<Button-3><ButtonRelease-3>", RightClicker)
 
-        self.power_help_btn2 = Button(
-            self.frame_advcomp,
-            text="?",
-            width=1,
-            command=lambda: cb_msg_block_adv_comp_win(
-                self.gui.help["comp"]["fps_power"]
-            ),
-            bootstyle="secondary",  # type: ignore
-        )
+        self.power_help_btn2 = self.add_help_btn(self.gui.help["comp"]["fps_power"])
         self.power_lbl2 = Label(self.frame_advcomp, text="Power (Importance)")
         self.quality_power_lbl = Label(self.frame_advcomp, text="Quality:")
         self.quality_power_entry = Entry(
@@ -294,15 +227,7 @@ class AdvancedCompressionWindow(BaseWindow):
         )
         self.color_power_entry.bind("<Button-3><ButtonRelease-3>", RightClicker)
 
-        self.fake_vid_help_btn = Button(
-            self.frame_advcomp,
-            text="?",
-            width=1,
-            command=lambda: cb_msg_block_adv_comp_win(
-                self.gui.help["comp"]["fake_vid"]
-            ),
-            bootstyle="secondary",  # type: ignore
-        )
+        self.fake_vid_help_btn = self.add_help_btn(self.gui.help["comp"]["fake_vid"])
         self.fake_vid_lbl = Label(
             self.frame_advcomp, text="Convert (faking) image to video"
         )
@@ -314,15 +239,21 @@ class AdvancedCompressionWindow(BaseWindow):
             bootstyle="success-round-toggle",  # type: ignore
         )
 
-        self.scale_filter_help_btn = Button(
+        self.bg_color_help_btn = self.add_help_btn(self.gui.help["comp"]["bg_color"])
+        self.bg_color_lbl = Label(self.frame_advcomp, text="Background color")
+        self.bg_color_entry = Entry(
+            self.frame_advcomp, textvariable=self.gui.bg_color_var, width=8
+        )
+        self.bg_color_btn = Button(
             self.frame_advcomp,
-            text="?",
-            width=1,
-            command=lambda: cb_msg_block_adv_comp_win(
-                self.gui.help["comp"]["scale_filter"]
-            ),
+            text="Set",
+            command=self.cb_bg_color,
             bootstyle="secondary",  # type: ignore
         )
+
+        self.scale_filter_help_btn = self.add_help_btn(
+            self.gui.help["comp"]["scale_filter"]
+        )
         self.scale_filter_lbl = Label(self.frame_advcomp, text="Scale filter")
         self.scale_filter_opt = OptionMenu(
             self.frame_advcomp,
@@ -337,14 +268,8 @@ class AdvancedCompressionWindow(BaseWindow):
             bootstyle="secondary",  # type: ignore
         )
 
-        self.quantize_method_help_btn = Button(
-            self.frame_advcomp,
-            text="?",
-            width=1,
-            command=lambda: cb_msg_block_adv_comp_win(
-                self.gui.help["comp"]["quantize_method"]
-            ),
-            bootstyle="secondary",  # type: ignore
+        self.quantize_method_help_btn = self.add_help_btn(
+            self.gui.help["comp"]["quantize_method"]
         )
         self.quantize_method_lbl = Label(self.frame_advcomp, text="Quantize method")
         self.quantize_method_opt = OptionMenu(
@@ -357,29 +282,15 @@ class AdvancedCompressionWindow(BaseWindow):
             bootstyle="secondary",  # type: ignore
         )
 
-        self.cache_dir_help_btn = Button(
-            self.frame_advcomp,
-            text="?",
-            width=1,
-            command=lambda: cb_msg_block_adv_comp_win(
-                self.gui.help["comp"]["cache_dir"]
-            ),
-            bootstyle="secondary",  # type: ignore
-        )
+        self.cache_dir_help_btn = self.add_help_btn(self.gui.help["comp"]["cache_dir"])
         self.cache_dir_lbl = Label(self.frame_advcomp, text="Custom cache directory")
         self.cache_dir_entry = Entry(
             self.frame_advcomp, textvariable=self.gui.cache_dir_var, width=30
         )
         self.cache_dir_entry.bind("<Button-3><ButtonRelease-3>", RightClicker)
 
-        self.default_emoji_help_btn = Button(
-            self.frame_advcomp,
-            text="?",
-            width=1,
-            command=lambda: cb_msg_block_adv_comp_win(
-                self.gui.help["comp"]["default_emoji"]
-            ),
-            bootstyle="secondary",  # type: ignore
+        self.default_emoji_help_btn = self.add_help_btn(
+            self.gui.help["comp"]["default_emoji"]
         )
         self.default_emoji_lbl = Label(self.frame_advcomp, text="Default emoji")
         self.im: Image.Image = Image.new("RGBA", (32, 32), (255, 255, 255, 0))
@@ -467,27 +378,32 @@ class AdvancedCompressionWindow(BaseWindow):
         self.fake_vid_lbl.grid(column=1, row=12, sticky="w", padx=3, pady=3)
         self.fake_vid_cbox.grid(column=6, row=12, sticky="nes", padx=3, pady=3)
 
-        self.scale_filter_help_btn.grid(column=0, row=13, sticky="w", padx=3, pady=3)
-        self.scale_filter_lbl.grid(column=1, row=13, sticky="w", padx=3, pady=3)
+        self.bg_color_help_btn.grid(column=0, row=13, sticky="w", padx=3, pady=3)
+        self.bg_color_lbl.grid(column=1, row=13, sticky="w", padx=3, pady=3)
+        self.bg_color_entry.grid(column=5, row=13, sticky="w", padx=3, pady=3)
+        self.bg_color_btn.grid(column=6, row=13, sticky="nes", padx=3, pady=3)
+
+        self.scale_filter_help_btn.grid(column=0, row=14, sticky="w", padx=3, pady=3)
+        self.scale_filter_lbl.grid(column=1, row=14, sticky="w", padx=3, pady=3)
         self.scale_filter_opt.grid(
-            column=2, row=13, columnspan=4, sticky="nes", padx=3, pady=3
+            column=2, row=14, columnspan=4, sticky="nes", padx=3, pady=3
         )
 
-        self.quantize_method_help_btn.grid(column=0, row=14, sticky="w", padx=3, pady=3)
-        self.quantize_method_lbl.grid(column=1, row=14, sticky="w", padx=3, pady=3)
+        self.quantize_method_help_btn.grid(column=0, row=15, sticky="w", padx=3, pady=3)
+        self.quantize_method_lbl.grid(column=1, row=15, sticky="w", padx=3, pady=3)
         self.quantize_method_opt.grid(
-            column=2, row=14, columnspan=4, sticky="nes", padx=3, pady=3
+            column=2, row=15, columnspan=4, sticky="nes", padx=3, pady=3
         )
 
-        self.cache_dir_help_btn.grid(column=0, row=15, sticky="w", padx=3, pady=3)
-        self.cache_dir_lbl.grid(column=1, row=15, sticky="w", padx=3, pady=3)
+        self.cache_dir_help_btn.grid(column=0, row=16, sticky="w", padx=3, pady=3)
+        self.cache_dir_lbl.grid(column=1, row=16, sticky="w", padx=3, pady=3)
         self.cache_dir_entry.grid(
-            column=2, row=15, columnspan=4, sticky="nes", padx=3, pady=3
+            column=2, row=16, columnspan=4, sticky="nes", padx=3, pady=3
         )
 
-        self.default_emoji_help_btn.grid(column=0, row=16, sticky="w", padx=3, pady=3)
-        self.default_emoji_lbl.grid(column=1, row=16, sticky="w", padx=3, pady=3)
-        self.default_emoji_dsp.grid(column=6, row=16, sticky="nes", padx=3, pady=3)
+        self.default_emoji_help_btn.grid(column=0, row=17, sticky="w", padx=3, pady=3)
+        self.default_emoji_lbl.grid(column=1, row=17, sticky="w", padx=3, pady=3)
+        self.default_emoji_dsp.grid(column=6, row=17, sticky="nes", padx=3, pady=3)
 
         # https://stackoverflow.com/questions/43731784/tkinter-canvas-scrollbar-with-grid
         # Create a frame for the canvas with non-zero row&column weights
@@ -647,6 +563,42 @@ class AdvancedCompressionWindow(BaseWindow):
 
         self.fake_vid_cbox.config(state=state)
 
+    def cb_bg_color(self, *_: Any) -> None:
+        color = colorchooser.askcolor(title="Choose color")[1]
+        if color:
+            self.gui.bg_color_var.set(color.replace("#", ""))
+        self.lift()
+        self.attributes("-topmost", True)  # type: ignore
+        self.attributes("-topmost", False)  # type: ignore
+
+    def cb_bound_to_mousewheel(self, event: Any) -> None:
+        for i in self.mousewheel:
+            self.emoji_canvas.bind_all(i, self.cb_on_mousewheel)
+
+    def cb_unbound_to_mousewheel(self, event: Any) -> None:
+        for i in self.mousewheel:
+            self.emoji_canvas.unbind_all(i)
+
+    def cb_on_mousewheel(self, event: Any) -> None:
+        self.emoji_canvas.yview_scroll(
+            int(-1 * (event.delta / self.delta_divide)), "units"
+        )  # type: ignore
+
+    def cb_set_emoji(self, emoji: str) -> None:
+        self.gui.default_emoji_var.set(emoji)
+        self.set_emoji_btn()
+
+    def add_help_btn(self, msg: str) -> Button:
+        cb_msg_block_adv_comp_win = partial(self.gui.cb_msg_block, parent=self)
+
+        return Button(
+            self.frame_advcomp,
+            text="?",
+            width=1,
+            command=lambda: cb_msg_block_adv_comp_win(msg),
+            bootstyle="secondary",  # type: ignore
+        )
+
     def set_emoji_btn(self) -> None:
         self.im = Image.new("RGBA", (128, 128), (255, 255, 255, 0))
         ImageDraw.Draw(self.im).text(  # type: ignore
@@ -736,20 +688,3 @@ class AdvancedCompressionWindow(BaseWindow):
         # https://stackoverflow.com/questions/17355902/tkinter-binding-mousewheel-to-scrollbar
         self.emoji_canvas.bind("<Enter>", self.cb_bound_to_mousewheel)
         self.emoji_canvas.bind("<Leave>", self.cb_unbound_to_mousewheel)
-
-    def cb_bound_to_mousewheel(self, event: Any) -> None:
-        for i in self.mousewheel:
-            self.emoji_canvas.bind_all(i, self.cb_on_mousewheel)
-
-    def cb_unbound_to_mousewheel(self, event: Any) -> None:
-        for i in self.mousewheel:
-            self.emoji_canvas.unbind_all(i)
-
-    def cb_on_mousewheel(self, event: Any) -> None:
-        self.emoji_canvas.yview_scroll(
-            int(-1 * (event.delta / self.delta_divide)), "units"
-        )  # type: ignore
-
-    def cb_set_emoji(self, emoji: str) -> None:
-        self.gui.default_emoji_var.set(emoji)
-        self.set_emoji_btn()

sticker_convert/job.py

@@ -29,7 +29,6 @@ from sticker_convert.utils.files.json_resources_loader import OUTPUT_JSON
 from sticker_convert.utils.files.metadata_handler import MetadataHandler
 from sticker_convert.utils.media.codec_info import CodecInfo
 
-CbQueueType = Queue[CbQueueItemType]
 WorkListItemType = Optional[Tuple[Callable[..., Any], Tuple[Any, ...]]]
 if TYPE_CHECKING:
     # mypy complains about this
@@ -59,7 +58,7 @@ class Executor:
         # Especially when using scale_filter=nearest
         self.work_list: WorkListType = self.manager.list()
         self.results_queue: Queue[Any] = self.manager.Queue()
-        self.cb_queue: CbQueueType = self.manager.Queue()
+        self.cb_queue: Queue[CbQueueItemType] = self.manager.Queue()
         self.cb_return = CallbackReturn()
         self.processes: List[Process] = []
 
@@ -76,7 +75,7 @@ class Executor:
 
     def cb_thread(
         self,
-        cb_queue: CbQueueType,
+        cb_queue: Queue[CbQueueItemType],
         cb_return: CallbackReturn,
     ) -> None:
         for i in iter(cb_queue.get, None):
@@ -113,7 +112,7 @@ class Executor:
     def worker(
         work_list: WorkListType,
         results_queue: Queue[Any],
-        cb_queue: CbQueueType,
+        cb_queue: Queue[CbQueueItemType],
         cb_return: CallbackReturn,
     ) -> None:
         while True:
@@ -412,6 +411,15 @@ class Job:
             error_msg += f"[X] quantize_method {self.opt_comp.quantize_method} is not valid option"
             error_msg += "    Valid options: imagequant, fastoctree, none"
 
+        if self.opt_comp.bg_color:
+            try:
+                _, _, _ = bytes.fromhex(self.opt_comp.bg_color)
+            except ValueError:
+                error_msg += "\n"
+                error_msg += (
+                    f"[X] bg_color {self.opt_comp.bg_color} is not valid color hex"
+                )
+
         # Warn about unable to download animated Kakao stickers with such link
         if (
             self.opt_output.option == "kakao"

sticker_convert/job_option.py

@@ -67,6 +67,8 @@ class CompOption(BaseOption):
     duration_min: Optional[int] = None
     duration_max: Optional[int] = None
 
+    bg_color: Optional[str] = None
+
     steps: int = 1
     fake_vid: Optional[bool] = None
     quantize_method: Optional[str] = None
@@ -101,7 +103,9 @@ class CompOption(BaseOption):
             },
             "duration": {"min": self.duration_min, "max": self.duration_max},
             "steps": self.steps,
+            "bg_color": self.bg_color,
             "fake_vid": self.fake_vid,
+            "quantize_method": self.quantize_method,
             "scale_filter": self.scale_filter,
             "cache_dir": self.cache_dir,
             "default_emoji": self.default_emoji,

sticker_convert/resources/compression.json

@@ -38,9 +38,10 @@
             "min": 0,
             "max": 10000
         },
+        "bg_color": "",
         "steps": 16,
         "fake_vid": false,
-        "scale_filter": "lanczos",
+        "scale_filter": "bicubic",
         "quantize_method": "imagequant",
         "default_emoji": "😀"
     },
@@ -83,9 +84,10 @@
             "min": 0,
             "max": 3000
         },
+        "bg_color": "",
         "steps": 16,
         "fake_vid": false,
-        "scale_filter": "lanczos",
+        "scale_filter": "bicubic",
         "quantize_method": "imagequant",
         "default_emoji": "😀"
     },
@@ -128,9 +130,10 @@
             "min": 0,
             "max": 3000
         },
+        "bg_color": "",
         "steps": 16,
         "fake_vid": false,
-        "scale_filter": "lanczos",
+        "scale_filter": "bicubic",
         "quantize_method": "imagequant",
         "default_emoji": "😀"
     },
@@ -173,9 +176,10 @@
             "min": 0,
             "max": 3000
         },
+        "bg_color": "",
         "steps": 16,
         "fake_vid": false,
-        "scale_filter": "lanczos",
+        "scale_filter": "bicubic",
         "quantize_method": "imagequant",
         "default_emoji": "😀"
     },
@@ -218,9 +222,10 @@
             "min": 8,
             "max": 10000
         },
+        "bg_color": "",
         "steps": 16,
         "fake_vid": true,
-        "scale_filter": "lanczos",
+        "scale_filter": "bicubic",
         "quantize_method": "imagequant",
         "default_emoji": "😀"
     },
@@ -263,9 +268,10 @@
             "min": 83,
             "max": 4000
         },
+        "bg_color": "",
         "steps": 16,
         "fake_vid": false,
-        "scale_filter": "lanczos",
+        "scale_filter": "bicubic",
         "quantize_method": "imagequant",
         "default_emoji": "😀"
     },
@@ -308,9 +314,10 @@
             "min": 0,
             "max": 5000
         },
+        "bg_color": "",
         "steps": 16,
         "fake_vid": false,
-        "scale_filter": "lanczos",
+        "scale_filter": "bicubic",
         "quantize_method": "imagequant",
         "default_emoji": "😀"
     },
@@ -353,9 +360,10 @@
             "min": 0,
             "max": 2000
         },
+        "bg_color": "",
         "steps": 16,
         "fake_vid": false,
-        "scale_filter": "lanczos",
+        "scale_filter": "bicubic",
         "quantize_method": "imagequant",
         "default_emoji": "😀"
     },
@@ -398,9 +406,10 @@
             "min": 0,
             "max": 2000
         },
+        "bg_color": "",
         "steps": 16,
         "fake_vid": false,
-        "scale_filter": "lanczos",
+        "scale_filter": "bicubic",
         "quantize_method": "imagequant",
         "default_emoji": "😀"
     },
@@ -443,9 +452,10 @@
             "min": 0,
             "max": 2000
         },
+        "bg_color": "",
         "steps": 16,
         "fake_vid": false,
-        "scale_filter": "lanczos",
+        "scale_filter": "bicubic",
         "quantize_method": "imagequant",
         "default_emoji": "😀"
     },
@@ -488,9 +498,10 @@
             "min": 0,
             "max": 10000
         },
+        "bg_color": "",
         "steps": 16,
         "fake_vid": false,
-        "scale_filter": "lanczos",
+        "scale_filter": "bicubic",
         "quantize_method": "imagequant",
         "default_emoji": "😀"
     }

sticker_convert/resources/help.json

@@ -38,6 +38,7 @@
         "duration": "Change playback speed if outside of duration limit.\nDuration set in miliseconds.\n0 will disable limit.",
         "duration_min": "Set minimum output duration in miliseconds.",
         "duration_max": "Set maximum output duration in miliseconds.",
+        "bg_color": "Set custom background color.\nExample: 00ff00 for green.\nIf this is not set, background color would be auto set to black if image is bright, or white if image is dark.\nNote: The color should not be visible if output format supports transparency.",
         "size": "Set maximum file size in bytes for video and image.",
         "vid_size_max": "Set maximum file size limit for animated stickers.",
         "img_size_max": "Set maximum file size limit for static stickers.",
@@ -45,7 +46,7 @@
         "vid_format": "Set file format if input is animated.",
         "img_format": "Set file format if input is static.",
         "fake_vid": "Convert (faking) image to video.\nUseful if:\n(1) Size limit for video is larger than image;\n(2) Mix image and video into same pack.",
-        "scale_filter": "Set scale filter. Default as lanczos. Valid options are:\n- nearest = Use nearest neighbour (Suitable for pixel art)\n-box = Similar to nearest, but better downscaling\n- bilinear = Linear interpolation\n- hamming = Similar to bilinear, but better downscaling\n- bicubic = Cubic spline interpolation\n- lanczos = A high-quality downsampling filter",
+        "scale_filter": "Set scale filter. Default as bicubic. Valid options are:\n- nearest = Use nearest neighbour (Suitable for pixel art)\n-box = Similar to nearest, but better downscaling\n- bilinear = Linear interpolation\n- hamming = Similar to bilinear, but better downscaling\n- bicubic = Cubic spline interpolation\n- lanczos = A high-quality downsampling filter",
         "quantize_method": "Set method for quantizing image. Default as imagequant. Valid options are:\n- imagequant = Best quality but slow\n- fastoctree = Fast but image looks chunky\n- none = No image quantizing, large image size as result",
         "cache_dir": "Set custom cache directory.\nUseful for debugging, or speed up conversion if cache_dir is on RAM disk.",
         "default_emoji": "Set the default emoji for uploading Signal and Telegram sticker packs."

sticker_convert/utils/media/codec_info.py

@@ -230,8 +230,8 @@ class CodecInfo:
         frames_to_iterate: Optional[int] = None,
         frames_only: bool = False,
     ) -> Tuple[int, int]:
-        import av  # type: ignore
-        from av.container.input import InputContainer  # type: ignore
+        import av
+        from av.container.input import InputContainer
 
         # Getting fps and frame count from metadata is not reliable
         # Example: https://github.com/laggykiller/sticker-convert/issues/114
@@ -242,7 +242,7 @@ class CodecInfo:
         else:
             file_ref = BytesIO(file)
 
-        with av.open(file_ref) as container:  # type: ignore
+        with av.open(file_ref) as container:
             container = cast(InputContainer, container)
             stream = container.streams.video[0]
             if container.duration:
@@ -257,7 +257,7 @@ class CodecInfo:
 
             frame_count = 0
             last_frame = None
-            for frame_count, frame in enumerate(container.decode(stream)):  # type: ignore
+            for frame_count, frame in enumerate(container.decode(stream)):
                 if frames_to_iterate is not None and frame_count == frames_to_iterate:
                     break
                 last_frame = frame
@@ -310,11 +310,11 @@ class CodecInfo:
         if codec is not None:
             return codec.lower()
 
-        import av  # type: ignore
-        from av.error import InvalidDataError  # type: ignore
+        import av
+        from av.error import InvalidDataError
 
         try:
-            with av.open(file_ref) as container:  # type: ignore
+            with av.open(file_ref) as container:
                 return container.streams.video[0].codec_context.name.lower()
         except InvalidDataError:
             pass
@@ -354,7 +354,7 @@ class CodecInfo:
             else:
                 file_ref = BytesIO(file)
 
-            with av.open(file_ref) as container:  # type: ignore
+            with av.open(file_ref) as container:
                 stream = container.streams.video[0]
                 width = stream.width
                 height = stream.height

sticker_convert/version.py

@@ -1,3 +1,3 @@
 #!/usr/bin/env python3
 
-__version__ = "2.7.7"
+__version__ = "2.7.9"

{sticker_convert-2.7.7.dist-info → sticker_convert-2.7.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: sticker-convert
-Version: 2.7.7
+Version: 2.7.9
 Summary: Convert (animated) stickers to/from WhatsApp, Telegram, Signal, Line, Kakao, iMessage. Written in Python.
 Author-email: laggykiller <chaudominic2@gmail.com>
 Maintainer-email: laggykiller <chaudominic2@gmail.com>
@@ -367,13 +367,14 @@ License-File: LICENSE
 Requires-Dist: aiolimiter ~=1.1.0
 Requires-Dist: anyio ~=3.7.1
 Requires-Dist: apngasm-python ~=1.2.3
-Requires-Dist: av ~=11.0.0
+Requires-Dist: av ~=12.0.0
 Requires-Dist: beautifulsoup4 ~=4.12.3
 Requires-Dist: rookiepy ~=0.3.6
 Requires-Dist: imagequant ~=1.1.1
 Requires-Dist: memory-tempfile ~=2.2.3
+Requires-Dist: mergedeep ~=1.3.4
 Requires-Dist: numpy >=1.22.4
-Requires-Dist: Pillow ~=10.2.0
+Requires-Dist: Pillow ==10.1.0
 Requires-Dist: pyoxipng ~=9.0.0
 Requires-Dist: python-telegram-bot ~=20.5
 Requires-Dist: requests ~=2.31.0
@@ -482,18 +483,19 @@ usage: sticker-convert.py [-h] [--version] [--no-confirm] [--input-dir INPUT_DIR
                           [--preset {auto,signal,telegram,telegram_emoji,whatsapp,line,kakao,imessage_small,imessage_medium,imessage_large,custom}]
                           [--steps STEPS] [--processes PROCESSES] [--fps-min FPS_MIN] [--fps-max FPS_MAX]
                           [--fps-power FPS_POWER] [--res-min RES_MIN] [--res-max RES_MAX] [--res-w-min RES_W_MIN]
-                          [--res-w-max RES_W_MAX] [--res-h-min RES_H_MIN] [--res-h-max RES_H_MAX] [--res-power RES_POWER]
+                          [--res-w-max RES_W_MAX] [--res-h-min RES_H_MIN] [--res-h-max RES_H_MAX] [--res-power RES_POWER]        
                           [--quality-min QUALITY_MIN] [--quality-max QUALITY_MAX] [--quality-power QUALITY_POWER]
                           [--color-min COLOR_MIN] [--color-max COLOR_MAX] [--color-power COLOR_POWER]
-                          [--duration-min DURATION_MIN] [--duration-max DURATION_MAX] [--vid-size-max VID_SIZE_MAX]
-                          [--img-size-max IMG_SIZE_MAX] [--vid-format VID_FORMAT] [--img-format IMG_FORMAT] [--fake-vid]
-                          [--scale-filter SCALE_FILTER] [--quantize-method QUANTIZE_METHOD] [--cache-dir CACHE_DIR]
-                          [--default-emoji DEFAULT_EMOJI] [--signal-uuid SIGNAL_UUID] [--signal-password SIGNAL_PASSWORD]
-                          [--signal-get-auth] [--signal-data-dir SIGNAL_DATA_DIR] [--telegram-token TELEGRAM_TOKEN]
+                          [--duration-min DURATION_MIN] [--duration-max DURATION_MAX] [--bg-color BG_COLOR]
+                          [--vid-size-max VID_SIZE_MAX] [--img-size-max IMG_SIZE_MAX] [--vid-format VID_FORMAT]
+                          [--img-format IMG_FORMAT] [--fake-vid] [--scale-filter SCALE_FILTER]
+                          [--quantize-method QUANTIZE_METHOD] [--cache-dir CACHE_DIR] [--default-emoji DEFAULT_EMOJI]
+                          [--signal-uuid SIGNAL_UUID] [--signal-password SIGNAL_PASSWORD] [--signal-get-auth]
+                          [--signal-data-dir SIGNAL_DATA_DIR] [--telegram-token TELEGRAM_TOKEN]
                           [--telegram-userid TELEGRAM_USERID] [--kakao-auth-token KAKAO_AUTH_TOKEN] [--kakao-get-auth]
                           [--kakao-username KAKAO_USERNAME] [--kakao-password KAKAO_PASSWORD]
-                          [--kakao-country-code KAKAO_COUNTRY_CODE] [--kakao-phone-number KAKAO_PHONE_NUMBER]
-                          [--line-get-auth] [--line-cookies LINE_COOKIES] [--save-cred SAVE_CRED]
+                          [--kakao-country-code KAKAO_COUNTRY_CODE] [--kakao-phone-number KAKAO_PHONE_NUMBER] [--line-get-auth]  
+                          [--line-cookies LINE_COOKIES] [--save-cred SAVE_CRED]
 
 CLI for stickers-convert
 
@@ -538,7 +540,7 @@ Output options:
 
 Compression options:
   --no-compress         Do not compress files. Useful for only downloading stickers.
-  --preset {auto,signal,telegram,telegram_emoji,whatsapp,line,kakao,imessage_small,imessage_medium,imessage_large,custom}
+  --preset {auto,signal,telegram,telegram_emoji,whatsapp,line,kakao,imessage_small,imessage_medium,imessage_large,custom}        
                         Apply preset for compression.
   --steps STEPS         Set number of divisions between min and max settings.
                         Steps higher = Slower but yields file more closer to the specified file size limit.
@@ -579,6 +581,10 @@ Compression options:
                         Set minimum output duration in miliseconds.
   --duration-max DURATION_MAX
                         Set maximum output duration in miliseconds.
+  --bg-color BG_COLOR   Set custom background color.
+                        Example: 00ff00 for green.
+                        If this is not set, background color would be auto set to black if image is bright, or white if image is dark.
+                        Note: The color should not be visible if output format supports transparency.
   --vid-size-max VID_SIZE_MAX
                         Set maximum file size limit for animated stickers.
   --img-size-max IMG_SIZE_MAX
@@ -592,7 +598,7 @@ Compression options:
                         (1) Size limit for video is larger than image;
                         (2) Mix image and video into same pack.
   --scale-filter SCALE_FILTER
-                        Set scale filter. Default as lanczos. Valid options are:
+                        Set scale filter. Default as bicubic. Valid options are:
                         - nearest = Use nearest neighbour (Suitable for pixel art)
                         -box = Similar to nearest, but better downscaling
                         - bilinear = Linear interpolation
@@ -622,10 +628,10 @@ Credentials options:
   --telegram-token TELEGRAM_TOKEN
                         Set Telegram token. Required for uploading and downloading Telegram stickers.
   --telegram-userid TELEGRAM_USERID
-                        Set telegram user_id (From real account, not bot account). Required for uploading Telegram stickers.
+                        Set telegram user_id (From real account, not bot account). Required for uploading Telegram stickers.     
   --kakao-auth-token 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. Kakao username, password, country code and phone number are also required.
+                        Set Kakao auth_token. Required for downloading animated stickers from https://e.kakao.com/t/xxxxx        
+  --kakao-get-auth      Generate Kakao auth_token. Kakao username, password, country code and phone number are also required.    
   --kakao-username KAKAO_USERNAME
                         Set Kakao username, which is email or phone number used for signing up Kakao account
                         Example: +447700900142

{sticker_convert-2.7.7.dist-info → sticker_convert-2.7.9.dist-info}/RECORD

@@ -1,12 +1,12 @@
 sticker_convert/__init__.py,sha256=iQnv6UOOA69c3soAn7ZOnAIubTIQSUxtq1Uhh8xRWvU,102
 sticker_convert/__main__.py,sha256=6RJauR-SCSSTT3TU7FFB6B6PVwsCxO2xZXtmZ3jc2Is,463
-sticker_convert/cli.py,sha256=LXX-LPlFeFKZLc7LKjdtDDLtOqmognEze0kMSr8Vj50,17543
-sticker_convert/converter.py,sha256=ZAuRO6Ic6e1nhJc_pBsBlPMVyHZzy87q5Gk_naCRShI,31241
+sticker_convert/cli.py,sha256=Ex5Nculo1cbkfhLPibnYR6-SM431ODGPb324Bos0z6k,17702
+sticker_convert/converter.py,sha256=XYt6bt7hnCJSWK-oWvVUQGCHP2Z-g2xVQWyu4j7oQek,32955
 sticker_convert/definitions.py,sha256=ZhP2ALCEud-w9ZZD4c3TDG9eHGPZyaAL7zPUsJAbjtE,2073
-sticker_convert/gui.py,sha256=N3JTsxYtzcHIjrY1FrMczCe3U_bt8E_-3BAdHH0t8L8,30104
-sticker_convert/job.py,sha256=tvK2JrL33DX4swErEihw1sLFv-IP_JQPoPpIpg6JSQ0,25833
-sticker_convert/job_option.py,sha256=niPTGZ4X1iUdkxyVc29oM67bpsUNBX9Um7OOJNa3piE,7521
-sticker_convert/version.py,sha256=jSfFumyqVCtgQ0gUWQGbYTxqs9lhLwaV1Vi6ncCy0cY,46
+sticker_convert/gui.py,sha256=TqdgFbHBRYgcXWWrsfxLUJ8Zu9WeE11vYyZMX6nalik,30599
+sticker_convert/job.py,sha256=hJgjMAvv50PZ4eYB_ZV7uXc8ZqF7sKnbRvCzs1YzgGE,26144
+sticker_convert/job_option.py,sha256=1YVhyTfu2cWz3qpAKbdIM11jbL0CJz0ksOYAeg8v6dc,7649
+sticker_convert/version.py,sha256=YtYyLos6wcoE1gtu4LiuT2txOQo9u2LqLrvBoQ9NGb4,46
 sticker_convert/downloaders/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sticker_convert/downloaders/download_base.py,sha256=5R7c8kwahAflOOYrtSQPnBVQ4T-DsprPUMP7G9wcJX4,2824
 sticker_convert/downloaders/download_kakao.py,sha256=RYrebTxEjKjXAr9xw18r0dMW0dFjSqZxzi8dpaq56TY,8581
@@ -16,7 +16,7 @@ sticker_convert/downloaders/download_telegram.py,sha256=OZdg7WuJV5VurZVC6dZSnzCW
 sticker_convert/gui_components/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sticker_convert/gui_components/gui_utils.py,sha256=okho2cA1Scem_m6rPiYifreFzpFrM21-yUkiAv64EUI,3431
 sticker_convert/gui_components/frames/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sticker_convert/gui_components/frames/comp_frame.py,sha256=Bqdw1cRVIq1ub0TanXN7zBhQdxGuRzR9UvOgOMG5oWA,8137
+sticker_convert/gui_components/frames/comp_frame.py,sha256=9k_UntKKi2G_g0byzoj1rdTqOq7q9mcnXiy799bYnr0,7257
 sticker_convert/gui_components/frames/config_frame.py,sha256=b3X4QAnGpde0OhthXHmjSyU_Yb5tYRUFXmy04Yi8Zmo,4316
 sticker_convert/gui_components/frames/control_frame.py,sha256=_XiOJ9JPUfiysDghGG04sEVLrXG9TMVlDZ60W0LhYVI,835
 sticker_convert/gui_components/frames/cred_frame.py,sha256=I3XrOv7kUOsvFWquuzWWpZWbLclqKQXgD7dx5pcTuY4,6499
@@ -25,7 +25,7 @@ sticker_convert/gui_components/frames/output_frame.py,sha256=n2WLk22h61DoZli8WbF
 sticker_convert/gui_components/frames/progress_frame.py,sha256=LWUZg_iL7iiNTfu7N5Ct_pklZdghxihENi7DP9YozOE,4915
 sticker_convert/gui_components/frames/right_clicker.py,sha256=dGIvSzEChrkguR80pzUemBNJ39uzJjVJQKeDNUoW3Gk,721
 sticker_convert/gui_components/windows/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sticker_convert/gui_components/windows/advanced_compression_window.py,sha256=1UulI_3ZtXdc34aq-hzFyV2WBZOC5OWGFUAMdf7ipU0,32105
+sticker_convert/gui_components/windows/advanced_compression_window.py,sha256=I3I3seZ5xLTEIsJt3A4t4vsF9ZFY3DmxJVo_yD4HSfA,30639
 sticker_convert/gui_components/windows/base_window.py,sha256=xBE1peGMPvWsdrFej0CJUVhmQ57GJGvz-cX03nIIhkE,1108
 sticker_convert/gui_components/windows/kakao_get_auth_window.py,sha256=AvXB2Q8pAPkKILHTvlLGV9jfBcvskCA4arko4nvBTdo,7115
 sticker_convert/gui_components/windows/line_get_auth_window.py,sha256=S4ES_lk2-GDvPokZtYALnUc5zW1VbS4WulNqO9K1aSs,3375
@@ -66,9 +66,9 @@ sticker_convert/resources/NotoColorEmoji.ttf,sha256=LurIVaCIA8bSCfjrdO1feYr0bhKL
 sticker_convert/resources/appicon.icns,sha256=FB2DVTOQcFfQNZ9RcyG3z9c9k7eOiI1qw0IJhXMRFg4,5404
 sticker_convert/resources/appicon.ico,sha256=-ldugcl2Yq2pBRTktnhGKWInpKyWzRjCiPvMr3XPTlc,38078
 sticker_convert/resources/appicon.png,sha256=6XBEQz7PnerqS43aRkwpWolFG4WvKMuQ-st1ly-_JPg,5265
-sticker_convert/resources/compression.json,sha256=WxC_KejpEreXrd_3YfW0NhDKn6xqBSaRqalVohLq5eI,10569
+sticker_convert/resources/compression.json,sha256=vwn6wLsfsPnNnpjhJHRvzozBI4F_kkb9-eBR8IlyYLo,10833
 sticker_convert/resources/emoji.json,sha256=sXSuKusyG1L2Stuf9BL5ZqfzOIOdeAeE3RXcrXAsLdY,413367
-sticker_convert/resources/help.json,sha256=PQcISwdoGTZhyxgOBhNJ47z8t3rCiawewbDFHE53f3k,5988
+sticker_convert/resources/help.json,sha256=dYLh751rhhriSwc2p_xKVdWPCgUZTPyNJ1QFZdUjA2M,6259
 sticker_convert/resources/input.json,sha256=sRz8qWaLh2KTjjlPIxz2UfynVn2Bn0olywbb8-qT_Hc,2251
 sticker_convert/resources/output.json,sha256=QYP2gqDvEaAm5I9bH4NReaB1XMLboevv69u-V8YdZUs,1373
 sticker_convert/uploaders/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -89,12 +89,12 @@ sticker_convert/utils/files/metadata_handler.py,sha256=TJpQ-7KdnqQh09hwR6xB_scRL
 sticker_convert/utils/files/run_bin.py,sha256=QalA9je6liHxiOtxsjsFsIkc2t59quhcJCVpP1X3p50,1743
 sticker_convert/utils/files/sanitize_filename.py,sha256=HBklPGsHRJjFQUIC5rYTQsUrsuTtezZXIEA8CPhLP8A,2156
 sticker_convert/utils/media/apple_png_normalize.py,sha256=LbrQhc7LlYX4I9ek4XJsZE4l0MygBA1jB-PFiYLEkzk,3657
-sticker_convert/utils/media/codec_info.py,sha256=slKvwLxgJz1txJIN4gJ5dAFDLvZLhnTP29Pm8GYveSM,12984
+sticker_convert/utils/media/codec_info.py,sha256=JHHlfCLSpepYFv6TSL1XqwUJoVOpOPFxurRtduplPGY,12856
 sticker_convert/utils/media/decrypt_kakao.py,sha256=4wq9ZDRnFkx1WmFZnyEogBofiLGsWQM_X69HlA36578,1947
 sticker_convert/utils/media/format_verify.py,sha256=Xf94jyqk_6M9IlFGMy0wYIgQKn_yg00nD4XW0CgAbew,5732
-sticker_convert-2.7.7.dist-info/LICENSE,sha256=gXf5dRMhNSbfLPYYTY_5hsZ1r7UU1OaKQEAQUhuIBkM,18092
-sticker_convert-2.7.7.dist-info/METADATA,sha256=oLKVy7XCVQ5m6S2WDRiynT_ATYnahnL5PmG4t7tU7Ak,48379
-sticker_convert-2.7.7.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-sticker_convert-2.7.7.dist-info/entry_points.txt,sha256=MNJ7XyC--ugxi5jS1nzjDLGnxCyLuaGdsVLnJhDHCqs,66
-sticker_convert-2.7.7.dist-info/top_level.txt,sha256=r9vfnB0l1ZnH5pTH5RvkobnK3Ow9m0RsncaOMAtiAtk,16
-sticker_convert-2.7.7.dist-info/RECORD,,
+sticker_convert-2.7.9.dist-info/LICENSE,sha256=gXf5dRMhNSbfLPYYTY_5hsZ1r7UU1OaKQEAQUhuIBkM,18092
+sticker_convert-2.7.9.dist-info/METADATA,sha256=zUUav4-oua996FFdpYa9TqeXRVfj2X7w1jhK-Xcpg4I,48836
+sticker_convert-2.7.9.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+sticker_convert-2.7.9.dist-info/entry_points.txt,sha256=MNJ7XyC--ugxi5jS1nzjDLGnxCyLuaGdsVLnJhDHCqs,66
+sticker_convert-2.7.9.dist-info/top_level.txt,sha256=r9vfnB0l1ZnH5pTH5RvkobnK3Ow9m0RsncaOMAtiAtk,16
+sticker_convert-2.7.9.dist-info/RECORD,,