KekikStream 0.4.5__tar.gz → 2.0.9__tar.gz

{kekikstream-0.4.5 → kekikstream-2.0.9}/KekikStream/CLI/pypi_kontrol.py

@@ -1,16 +1,16 @@
 # Bu araç @keyiflerolsun tarafından | @KekikAkademi için yazılmıştır.
 
-from .             import konsol
-from rich.panel    import Panel
-from pkg_resources import get_distribution
-from requests      import get
-from subprocess    import check_call
+from .          import konsol
+from rich.panel import Panel
+from importlib  import metadata
+from requests   import get
+from subprocess import check_call
 import sys
 
 def pypi_kontrol_guncelle(paket_adi: str):
     try:
         konsol.print(f"[bold cyan] {paket_adi} Güncellemesi kontrol ediliyor...[/bold cyan]")
-        mevcut_surum = get_distribution(paket_adi).version
+        mevcut_surum = metadata.version(paket_adi)
         konsol.print(Panel(f"[cyan]Yüklü sürüm:[/cyan] [bold yellow]{mevcut_surum}[/bold yellow]"))
 
         istek = get(f"https://pypi.org/pypi/{paket_adi}/json")

kekikstream-2.0.9/KekikStream/Core/Extractor/ExtractorBase.py

@@ -0,0 +1,49 @@
+# Bu araç @keyiflerolsun tarafından | @KekikAkademi için yazılmıştır.
+
+from abc              import ABC, abstractmethod
+from cloudscraper     import CloudScraper
+from httpx            import AsyncClient
+from typing           import Optional
+from .ExtractorModels import ExtractResult
+from urllib.parse     import urljoin
+
+class ExtractorBase(ABC):
+    # Çıkarıcının temel özellikleri
+    name     = "Extractor"
+    main_url = ""
+
+    def __init__(self):
+        # cloudscraper - for bypassing Cloudflare
+        self.cloudscraper = CloudScraper()
+
+        # httpx - lightweight and safe for most HTTP requests
+        self.httpx = AsyncClient(timeout = 10)
+        self.httpx.headers.update(self.cloudscraper.headers)
+        self.httpx.cookies.update(self.cloudscraper.cookies)
+        self.httpx.headers.update({
+            "User-Agent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 15.7; rv:135.0) Gecko/20100101 Firefox/135.0",
+            "Accept"     : "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"
+        })
+
+    def can_handle_url(self, url: str) -> bool:
+        # URL'nin bu çıkarıcı tarafından işlenip işlenemeyeceğini kontrol et
+        return self.main_url in url
+
+    @abstractmethod
+    async def extract(self, url: str, referer: Optional[str] = None) -> ExtractResult:
+        # Alt sınıflar tarafından uygulanacak medya çıkarma fonksiyonu
+        pass
+
+    async def close(self):
+        """Close HTTP client."""
+        await self.httpx.aclose()
+
+    def fix_url(self, url: str) -> str:
+        # Eksik URL'leri düzelt ve tam URL formatına çevir
+        if not url:
+            return ""
+
+        if url.startswith("http") or url.startswith("{\""):
+            return url
+
+        return f"https:{url}" if url.startswith("//") else urljoin(self.main_url, url)

kekikstream-2.0.9/KekikStream/Core/Extractor/ExtractorLoader.py

@@ -0,0 +1,98 @@
+# Bu araç @keyiflerolsun tarafından | @KekikAkademi için yazılmıştır.
+
+from ...CLI         import konsol, cikis_yap
+from .ExtractorBase import ExtractorBase
+from pathlib        import Path
+import os, importlib.util, traceback
+
+class ExtractorLoader:
+    def __init__(self, extractors_dir: str):
+        # Yerel ve global çıkarıcı dizinlerini ayarla
+        self.local_extractors_dir  = Path(extractors_dir)
+        self.global_extractors_dir = Path(__file__).parent.parent.parent / extractors_dir
+
+        # Dizin kontrolü
+        if not self.local_extractors_dir.exists() and not self.global_extractors_dir.exists():
+            # konsol.log(f"[red][!] Extractor dizini bulunamadı: {self.global_extractors_dir}[/red]")
+            cikis_yap(False)
+
+    def load_all(self) -> list[ExtractorBase]:
+        extractors = []
+
+        # Eğer yerel dizinde Extractor varsa, sadece onları yükle (eklenti geliştirme modu)
+        if self.local_extractors_dir.exists():
+            # konsol.log(f"[green][*] Yerel Extractor dizininden yükleniyor: {self.local_extractors_dir}[/green]")
+            local_extractors = self._load_from_directory(self.local_extractors_dir)
+            # konsol.log(f"[green]Yerel Extractor'lar: {[e.__name__ for e in local_extractors]}[/green]")
+
+            if local_extractors:
+                # konsol.log("[cyan][*] Yerel Extractor bulundu, global Extractor'lar atlanıyor (eklenti geliştirme modu)[/cyan]")
+                extractors.extend(local_extractors)
+
+        # Yerel dizinde Extractor yoksa, global'leri yükle
+        if not extractors and self.global_extractors_dir.exists():
+            # konsol.log(f"[green][*] Global Extractor dizininden yükleniyor: {self.global_extractors_dir}[/green]")
+            global_extractors = self._load_from_directory(self.global_extractors_dir)
+            # konsol.log(f"[green]Global Extractor'lar: {[e.__name__ for e in global_extractors]}[/green]")
+            extractors.extend(global_extractors)
+
+        # Benzersizliği sağlama (modül adı + sınıf adı bazında)
+        unique_extractors = []
+        seen_names = set()
+        for ext in extractors:
+            identifier = f"{ext.__module__}.{ext.__name__}"
+            if identifier not in seen_names:
+                unique_extractors.append(ext)
+                seen_names.add(identifier)
+
+        # konsol.log(f"[blue]Sonuç Extractor'lar: {[e.__name__ for e in unique_extractors]}[/blue]")
+
+        if not unique_extractors:
+            konsol.log("[yellow][!] Yüklenecek bir Extractor bulunamadı![/yellow]")
+
+        return unique_extractors
+
+    def _load_from_directory(self, directory: Path) -> list[ExtractorBase]:
+        extractors = []
+
+        # Dizindeki tüm .py dosyalarını tara
+        for file in os.listdir(directory):
+            if file.endswith(".py") and not file.startswith("__"):
+                module_name = file[:-3] # .py uzantısını kaldır
+                # konsol.log(f"[cyan]Okunan Dosya\t\t: {module_name}[/cyan]")
+                module_extractors = self._load_extractor(directory, module_name)
+                if module_extractors:
+                    # konsol.log(f"[magenta]Extractor Yüklendi\t: {[e.__name__ for e in module_extractors]}[/magenta]")
+                    extractors.extend(module_extractors)
+
+        # konsol.log(f"[yellow]{directory} dizininden yüklenen Extractor'lar: {[e.__name__ for e in extractors]}[/yellow]")
+        return extractors
+
+    def _load_extractor(self, directory: Path, module_name: str):
+        try:
+            # Modül dosyasını bul ve yükle
+            path = directory / f"{module_name}.py"
+            spec = importlib.util.spec_from_file_location(module_name, path)
+            if not spec or not spec.loader:
+                return []
+
+            # Modülü içe aktar
+            module = importlib.util.module_from_spec(spec)
+            spec.loader.exec_module(module)
+
+            # Yalnızca doğru modülden gelen ExtractorBase sınıflarını yükle (TÜM CLASS'LAR)
+            extractors = []
+            for attr in dir(module):
+                obj = getattr(module, attr)
+                # isinstance kontrolünü __module__ kontrolünden ÖNCE yap
+                if isinstance(obj, type) and issubclass(obj, ExtractorBase) and obj is not ExtractorBase and obj.__module__ == module_name:
+                    # konsol.log(f"[green]Yüklenen sınıf\t\t: {module_name}.{obj.__name__} ({obj.__module__}.{obj.__name__})[/green]")
+                    extractors.append(obj)
+            
+            return extractors
+
+        except Exception as hata:
+            konsol.log(f"[red][!] Extractor yüklenirken hata oluştu: {module_name}\nHata: {hata}")
+            konsol.print(f"[dim]{traceback.format_exc()}[/dim]")
+
+        return []

kekikstream-2.0.9/KekikStream/Core/Extractor/ExtractorManager.py

@@ -0,0 +1,75 @@
+# Bu araç @keyiflerolsun tarafından | @KekikAkademi için yazılmıştır.
+
+from .ExtractorLoader import ExtractorLoader
+from .ExtractorBase   import ExtractorBase
+
+class ExtractorManager:
+    def __init__(self, extractor_dir="Extractors"):
+        # Çıkarıcı yükleyiciyi başlat ve tüm çıkarıcıları yükle
+        self.extractor_loader = ExtractorLoader(extractor_dir)
+        self.extractors       = self.extractor_loader.load_all()  # Sadece class'lar
+
+        # Lazy loading: Instance'lar ilk kullanımda oluşturulacak
+        self._extractor_instances = None  # None = henüz oluşturulmadı
+        self._ytdlp_extractor     = None
+        self._initialized         = False
+
+    def _ensure_initialized(self):
+        """
+        Lazy initialization: İlk kullanımda TÜM extractorları initialize et
+
+        Startup'ta sadece class'ları yükledik (hızlı).
+        Şimdi instance'ları oluştur ve cache'le (bir kere).
+        """
+        if self._initialized:
+            return
+
+        # Instance listesi oluştur
+        self._extractor_instances = []
+
+        # TÜM extractorları instance'la
+        for extractor_cls in self.extractors:
+            instance = extractor_cls()
+
+            # YTDLP'yi ayrı tut
+            if instance.name == "yt-dlp":
+                self._ytdlp_extractor = instance
+            else:
+                self._extractor_instances.append(instance)
+
+        # YTDLP'yi EN BAŞA ekle
+        if self._ytdlp_extractor:
+            self._extractor_instances.insert(0, self._ytdlp_extractor)
+
+        self._initialized = True
+
+    def find_extractor(self, link) -> ExtractorBase:
+        """
+        Verilen bağlantıyı işleyebilecek çıkarıcıyı bul
+        """
+        # Lazy loading: İlk kullanımda extractorları initialize et
+        self._ensure_initialized()
+
+        # Cached instance'ları kullan
+        for extractor in self._extractor_instances:
+            if extractor.can_handle_url(link):
+                return extractor
+
+        return None
+
+    def map_links_to_extractors(self, links) -> dict:
+        """
+        Bağlantıları uygun çıkarıcılarla eşleştir
+        """
+        # Lazy loading: İlk kullanımda extractorları initialize et
+        self._ensure_initialized()
+
+        mapping = {}
+        for link in links:
+            # Cached instance'ları kullan
+            for extractor in self._extractor_instances:
+                if extractor.can_handle_url(link):
+                    mapping[link] = f"{extractor.name:<30} » {link.replace(extractor.main_url, '')}"
+                    break  # İlk eşleşmede dur
+
+        return mapping

{kekikstream-0.4.5/KekikStream/Core → kekikstream-2.0.9/KekikStream/Core/Extractor}/ExtractorModels.py

@@ -1,8 +1,6 @@
 # Bu araç @keyiflerolsun tarafından | @KekikAkademi için yazılmıştır.
 
 from pydantic import BaseModel
-from typing   import List, Optional
-
 
 class Subtitle(BaseModel):
     """Altyazı modeli."""
@@ -12,8 +10,8 @@ class Subtitle(BaseModel):
 
 class ExtractResult(BaseModel):
     """Extractor'ın döndürmesi gereken sonuç modeli."""
-    name      : str
-    url       : str
-    referer   : str
-    subtitles : List[Subtitle] = []
-    headers   : Optional[dict] = {}
+    name       : str
+    url        : str
+    referer    : str | None     = None
+    user_agent : str | None     = None
+    subtitles  : list[Subtitle] = []

kekikstream-2.0.9/KekikStream/Core/Extractor/YTDLPCache.py

@@ -0,0 +1,35 @@
+# Bu araç @keyiflerolsun tarafından | @KekikAkademi için yazılmıştır.
+
+from Kekik.cli        import konsol
+from yt_dlp.extractor import gen_extractors
+
+# Global cache (module-level singleton)
+_YTDLP_EXTRACTORS_CACHE = None
+_CACHE_INITIALIZED      = False
+
+def get_ytdlp_extractors() -> list:
+    """
+    yt-dlp extractorlarını cache'le ve döndür
+
+    Returns:
+        list: yt-dlp extractor sınıfları
+    """
+    global _YTDLP_EXTRACTORS_CACHE, _CACHE_INITIALIZED
+
+    if _CACHE_INITIALIZED:
+        return _YTDLP_EXTRACTORS_CACHE
+
+    try:
+        extractors = list(gen_extractors())
+        extractors = [ie for ie in extractors if ie.ie_key() != 'Generic']
+
+        _YTDLP_EXTRACTORS_CACHE = extractors
+        _CACHE_INITIALIZED      = True
+
+        return extractors
+
+    except Exception as e:
+        konsol.log(f"[red][⚠] yt-dlp extractor cache hatası: {e}[/red]")
+        _YTDLP_EXTRACTORS_CACHE = []
+        _CACHE_INITIALIZED      = True
+        return []

kekikstream-2.0.9/KekikStream/Core/Media/MediaHandler.py

@@ -0,0 +1,183 @@
+# Bu araç @keyiflerolsun tarafından | @KekikAkademi için yazılmıştır.
+
+from ...CLI                      import konsol
+from ..Extractor.ExtractorModels import ExtractResult
+import subprocess, os
+
+class MediaHandler:
+    def __init__(self, title: str = "KekikStream"):
+        self.title   = title
+        self.headers = {}
+
+    def play_media(self, extract_data: ExtractResult):
+        # user-agent ekle (varsayılan veya extract_data'dan)
+        user_agent = extract_data.user_agent or "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_5)"
+        self.headers["user-agent"] = user_agent
+
+        # referer ekle
+        if extract_data.referer:
+            self.headers["referer"] = extract_data.referer
+
+        # Özel Durumlar (RecTV vs. Googleusercontent)
+        if user_agent in ["googleusercontent", "Mozilla/5.0 (X11; Linux x86_64; rv:101.0) Gecko/20100101 Firefox/101.0"]:
+            return self.play_with_ytdlp(extract_data)
+
+        # İşletim sistemine göre oynatıcı seç (Android durumu)
+        if subprocess.check_output(['uname', '-o']).strip() == b'Android':
+            return self.play_with_android_mxplayer(extract_data)
+
+        # Oynatıcı öncelik sırası (fallback zincirleme)
+        players = [
+            ("MPV", self.play_with_mpv),
+            ("VLC", self.play_with_vlc),
+            ("yt-dlp", self.play_with_ytdlp)
+        ]
+
+        # Fallback zincirleme
+        for player_name, player_func in players:
+            try:
+                result = player_func(extract_data)
+                if result or result is None:  # None = MPV (exception yok)
+                    konsol.log(f"[green][✓] {player_name} ile başarılı[/green]")
+                    return True
+            except Exception as e:
+                konsol.log(f"[yellow][⚠] {player_name} hatası: {e}[/yellow]")
+                continue
+
+        konsol.print("[red][✗] Hiçbir oynatıcı çalışmadı![/red]")
+        return False
+
+    def play_with_vlc(self, extract_data: ExtractResult):
+        konsol.log(f"[yellow][»] VLC ile Oynatılıyor : {extract_data.url}")
+        # konsol.print(self.headers)
+        try:
+            vlc_command = ["vlc", "--quiet"]
+
+            if self.title:
+                vlc_command.extend([
+                    f"--meta-title={self.title}",
+                    f"--input-title-format={self.title}"
+                ])
+
+            if "user-agent" in self.headers:
+                vlc_command.append(f"--http-user-agent={self.headers.get('user-agent')}")
+
+            if "referer" in self.headers:
+                vlc_command.append(f"--http-referrer={self.headers.get('referer')}")
+
+            vlc_command.extend(
+                f"--sub-file={subtitle.url}" for subtitle in extract_data.subtitles
+            )
+            vlc_command.append(extract_data.url)
+
+            with open(os.devnull, "w") as devnull:
+                subprocess.run(vlc_command, stdout=devnull, stderr=devnull, check=True)
+
+            return True
+        except subprocess.CalledProcessError as hata:
+            konsol.print(f"[red]VLC oynatma hatası: {hata}[/red]")
+            konsol.print({"title": self.title, "url": extract_data.url, "headers": self.headers})
+            return False
+        except FileNotFoundError:
+            konsol.print("[red]VLC bulunamadı! VLC kurulu olduğundan emin olun.[/red]")
+            # konsol.print({"title": self.title, "url": extract_data.url, "headers": self.headers})
+            return False
+
+    def play_with_mpv(self, extract_data: ExtractResult):
+        konsol.log(f"[yellow][»] MPV ile Oynatılıyor : {extract_data.url}")
+        # konsol.print(self.headers)
+        try:
+            mpv_command = ["mpv"]
+
+            if self.title:
+                mpv_command.append(f"--force-media-title={self.title}")
+
+            for key, value in self.headers.items():
+                mpv_command.append(f"--http-header-fields={key}: {value}")
+
+            mpv_command.extend(
+                f"--sub-file={subtitle.url}" for subtitle in extract_data.subtitles
+            )
+            mpv_command.append(extract_data.url)
+
+            with open(os.devnull, "w") as devnull:
+                subprocess.run(mpv_command, stdout=devnull, stderr=devnull, check=True)
+
+            return True
+        except subprocess.CalledProcessError as hata:
+            konsol.print(f"[red]mpv oynatma hatası: {hata}[/red]")
+            konsol.print({"title": self.title, "url": extract_data.url, "headers": self.headers})
+            return False
+        except FileNotFoundError:
+            konsol.print("[red]mpv bulunamadı! mpv kurulu olduğundan emin olun.[/red]")
+            konsol.print({"title": self.title, "url": extract_data.url, "headers": self.headers})
+            return False
+
+    def play_with_ytdlp(self, extract_data: ExtractResult):
+        konsol.log(f"[yellow][»] yt-dlp ile Oynatılıyor : {extract_data.url}")
+        # konsol.print(self.headers)
+        try:
+            ytdlp_command = ["yt-dlp", "--quiet", "--no-warnings"]
+
+            for key, value in self.headers.items():
+                ytdlp_command.extend(["--add-header", f"{key}: {value}"])
+
+            ytdlp_command.extend([
+                "-o", "-",
+                extract_data.url
+            ])
+
+            mpv_command = ["mpv", "--really-quiet", "-"]
+
+            if self.title:
+                mpv_command.append(f"--force-media-title={self.title}")
+
+            mpv_command.extend(
+                f"--sub-file={subtitle.url}" for subtitle in extract_data.subtitles
+            )
+
+            with subprocess.Popen(ytdlp_command, stdout=subprocess.PIPE) as ytdlp_proc:
+                subprocess.run(mpv_command, stdin=ytdlp_proc.stdout, check=True)
+
+            return True
+        except subprocess.CalledProcessError as hata:
+            konsol.print(f"[red]Oynatma hatası: {hata}[/red]")
+            konsol.print({"title": self.title, "url": extract_data.url, "headers": self.headers})
+            return False
+        except FileNotFoundError:
+            konsol.print("[red]yt-dlp veya mpv bulunamadı! Kurulumlarından emin olun.[/red]")
+            konsol.print({"title": self.title, "url": extract_data.url, "headers": self.headers})
+            return False
+
+    def play_with_android_mxplayer(self, extract_data: ExtractResult):
+        konsol.log(f"[yellow][»] MxPlayer ile Oynatılıyor : {extract_data.url}")
+        # konsol.print(self.headers)
+        paketler = [
+            "com.mxtech.videoplayer.ad/.ActivityScreen",  # Free sürüm
+            "com.mxtech.videoplayer.pro/.ActivityScreen"  # Pro sürüm
+        ]
+
+        for paket in paketler:
+            try:
+                android_command = [
+                    "am", "start",
+                    "-a", "android.intent.action.VIEW",
+                    "-d", extract_data.url,
+                    "-n", paket
+                ]
+
+                if self.title:
+                    android_command.extend(["--es", "title", self.title])
+
+                with open(os.devnull, "w") as devnull:
+                    subprocess.run(android_command, stdout=devnull, stderr=devnull, check=True)
+
+                return True
+            except subprocess.CalledProcessError as hata:
+                konsol.print(f"[red]{paket} oynatma hatası: {hata}[/red]")
+                konsol.print({"title": self.title, "url": extract_data.url, "headers": self.headers})
+                return False
+            except FileNotFoundError:
+                konsol.print(f"Paket: {paket}, Hata: MX Player kurulu değil")
+                konsol.print({"title": self.title, "url": extract_data.url, "headers": self.headers})
+                return False

{kekikstream-0.4.5/KekikStream/Managers → kekikstream-2.0.9/KekikStream/Core/Media}/MediaManager.py

@@ -1,6 +1,6 @@
 # Bu araç @keyiflerolsun tarafından | @KekikAkademi için yazılmıştır.
 
-from ..Core import MediaHandler
+from .MediaHandler import MediaHandler
 
 class MediaManager:
     def __init__(self):
@@ -12,8 +12,5 @@ class MediaManager:
     def get_title(self):
         return self.media_handler.title
 
-    def set_headers(self, headers):
-        self.media_handler.headers.update(headers)
-
     def play_media(self, extract_data):
         self.media_handler.play_media(extract_data)

kekikstream-2.0.9/KekikStream/Core/Plugin/PluginBase.py

@@ -0,0 +1,122 @@
+# Bu araç @keyiflerolsun tarafından | @KekikAkademi için yazılmıştır.
+
+from abc                          import ABC, abstractmethod
+from cloudscraper                 import CloudScraper
+from httpx                        import AsyncClient
+from .PluginModels                import MainPageResult, SearchResult, MovieInfo
+from ..Media.MediaHandler         import MediaHandler
+from ..Extractor.ExtractorManager import ExtractorManager
+from urllib.parse                 import urljoin
+import re
+
+class PluginBase(ABC):
+    name        = "Plugin"
+    language    = "tr"
+    main_url    = "https://example.com"
+    favicon     = f"https://www.google.com/s2/favicons?domain={main_url}&sz=64"
+    description = "No description provided."
+
+    main_page   = {}
+
+    async def url_update(self, new_url: str):
+        self.favicon   = self.favicon.replace(self.main_url, new_url)
+        self.main_page = {url.replace(self.main_url, new_url): category for url, category in self.main_page.items()}
+        self.main_url  = new_url
+
+    def __init__(self):
+        # cloudscraper - for bypassing Cloudflare
+        self.cloudscraper = CloudScraper()
+
+        # httpx - lightweight and safe for most HTTP requests
+        self.httpx = AsyncClient(
+            timeout          = 3,
+            follow_redirects = True
+        )
+        self.httpx.headers.update(self.cloudscraper.headers)
+        self.httpx.cookies.update(self.cloudscraper.cookies)
+        self.httpx.headers.update({
+            "User-Agent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 15.7; rv:135.0) Gecko/20100101 Firefox/135.0",
+            "Accept"     : "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"
+        })
+
+        self.media_handler = MediaHandler()
+        self.ex_manager    = ExtractorManager()
+
+    @abstractmethod
+    async def get_main_page(self, page: int, url: str, category: str) -> list[MainPageResult]:
+        """Ana sayfadaki popüler içerikleri döndürür."""
+        pass
+
+    @abstractmethod
+    async def search(self, query: str) -> list[SearchResult]:
+        """Kullanıcı arama sorgusuna göre sonuç döndürür."""
+        pass
+
+    @abstractmethod
+    async def load_item(self, url: str) -> MovieInfo:
+        """Bir medya öğesi hakkında detaylı bilgi döndürür."""
+        pass
+
+    @abstractmethod
+    async def load_links(self, url: str) -> list[dict]:
+        """
+        Bir medya öğesi için oynatma bağlantılarını döndürür.
+        
+        Args:
+            url: Medya URL'si
+            
+        Returns:
+            Dictionary listesi, her biri şu alanları içerir:
+            - url (str, zorunlu): Video URL'si
+            - name (str, zorunlu): Gösterim adı (tüm bilgileri içerir)
+            - referer (str, opsiyonel): Referer header
+            - subtitles (list, opsiyonel): Altyazı listesi
+        
+        Example:
+            [
+                {
+                    "url": "https://example.com/video.m3u8",
+                    "name": "HDFilmCehennemi | 1080p TR Dublaj"
+                }
+            ]
+        """
+        pass
+
+    async def close(self):
+        """Close HTTP client."""
+        await self.httpx.aclose()
+
+    def fix_url(self, url: str) -> str:
+        if not url:
+            return ""
+
+        if url.startswith("http") or url.startswith("{\""):
+            return url
+
+        return f"https:{url}" if url.startswith("//") else urljoin(self.main_url, url)
+
+    @staticmethod
+    def clean_title(title: str) -> str:
+        suffixes = [
+            " izle", 
+            " full film", 
+            " filmini full",
+            " full türkçe",
+            " alt yazılı", 
+            " altyazılı", 
+            " tr dublaj",
+            " hd türkçe",
+            " türkçe dublaj",
+            " yeşilçam ",
+            " erotik fil",
+            " türkçe",
+            " yerli",
+            " tüekçe dublaj",
+        ]
+
+        cleaned_title = title.strip()
+
+        for suffix in suffixes:
+            cleaned_title = re.sub(f"{re.escape(suffix)}.*$", "", cleaned_title, flags=re.IGNORECASE).strip()
+
+        return cleaned_title