KekikStream

Modüler ve genişletilebilir medya streaming kütüphanesi Terminal üzerinden içerik arayın, VLC/MPV ile doğrudan izleyin veya kendi API’nizi kurun. 🚀

🚦 Ne Sunar?

KekikStream, Türkçe medya kaynaklarını tek CLI arayüzünde toplayarak hızlı arama ve oynatma sunar. Plugin mimarisi sayesinde yeni kaynaklar eklemek ve KekikStreamAPI ile web/API üzerinden yayın yapmak kolaydır.

• 🎥 Çoklu kaynak desteği: Onlarca Türkçe medya sitesi
• 🔌 Plugin mimarisi: Yeni kaynak eklemek dakikalar sürer
• 🎬 Çoklu oynatıcı: VLC, MPV, MX Player
• 🖥️ CLI & kütüphane: Terminalde veya kod içinde kullanın
• 🌐 API/Web UI: KekikStreamAPI üzerinden uzak erişim

🚀 Hızlı Başlangıç

Gereksinimler: Python 3.11+, sistemde VLC veya MPV kurulu olmalı (Android için MX Player + ADB).

# Kurulum
pip install KekikStream

# Güncelleme
pip install -U KekikStream

Temel Kullanım

CLI:

KekikStream

✨ Özellikler

🔌 Plugin Sistemi

KekikStream modüler bir plugin mimarisi kullanır; her medya kaynağı bağımsız bir plugin'dir.

Mevcut Pluginler (örnek): Dizilla, HDFilmCehennemi, Dizipal, Dizifon, RoketDizi, Sinefy, Moviesseed, FullHDFilmizlesene, HDBestMovies, SuperFilmGeldi, Sinezy ve daha fazlası.

Plugin Geliştirme:

from KekikStream.Core import HTMLHelper, PluginBase, MainPageResult, SearchResult, MovieInfo, Episode, SeriesInfo, Subtitle, ExtractResult

class MyPlugin(PluginBase):
    name        = "MyPlugin"
    language    = "en"
    main_url    = "https://example.com"
    favicon     = f"https://www.google.com/s2/favicons?domain={main_url}&sz=64"
    description = "MyPlugin description"

    main_page   = {
      f"{main_url}/category/" : "Category Name"
    }

    async def get_main_page(self, page: int, url: str, category: str) -> list[MainPageResult]:
        return results

    async def search(self, query: str) -> list[SearchResult]:
        return results

    async def load_item(self, url: str) -> MovieInfo | SeriesInfo:
        return details

    async def load_links(self, url: str) -> list[ExtractResult]:
        # self.collect_results(results, data)  — extract sonuçlarını topla
        # self.deduplicate(results)             — URL bazlı tekrar kaldırma
        # await self.async_cf_get(url)          — Cloudflare bypass (async)
        return links

🎬 Oynatıcı Desteği

Özel durumlar için (Google Drive vb.) arka planda otomatik olarak yt-dlp devreye girer.

🔗 Extractor Sistemi

Vidmoly, Filemoon, Sibnet, Sendvid, Voe, Doodstream, Streamtape, Upstream, Dailymotion, JWPlayer ve birçok kaynaktan direkt streaming linki çıkarır.

🏗️ Mimari

graph TB
    subgraph KekikStream[🎬 KekikStream]
        CLI[🖥️ CLI Interface]
        Manager[🔌 Plugin Manager]

        subgraph Plugins
            P1[📺 Dizilla]
            P2[🎬 HDFilmCehennemi]
            P3[🍿 Dizipal]
            PN[... 20+ Plugin]
        end

        subgraph Extractors
            E1[🔗 Vidmoly]
            E2[🔗 Filemoon]
            E3[🔗 Sibnet]
            EN[... Extractors]
        end

        subgraph Players
            MPV[🎥 MPV]
            VLC[🎥 VLC]
            MX[🎥 MX Player]
        end
    end

    CLI --> Manager
    Manager --> P1
    Manager --> P2
    Manager --> P3
    Manager --> PN

    %% Her plugin otomatik olarak ihtiyaç duyduğu extractor'ı kullanır
    P1 -.-> E1
    P1 -.-> E2
    P1 -.-> E3

    P2 -.-> E1
    P2 -.-> E2
    P2 -.-> E3

    P3 -.-> E1
    P3 -.-> E2
    P3 -.-> E3

    PN -.-> EN

    E1 --> VLC
    E2 --> VLC
    E3 --> VLC
    EN --> VLC

    E1 --> MPV
    E2 --> MPV
    E3 --> MPV
    EN --> MPV

    E1 --> MX
    E2 --> MX
    E3 --> MX
    EN --> MX

    style KekikStream fill:#2b2a29,stroke:#ef7f1a,stroke-width:2px
    style Plugins fill:#242322,stroke:#0087a3,stroke-width:2px
    style Extractors fill:#242322,stroke:#5a7c8c,stroke-width:2px
    style Players fill:#242322,stroke:#0087a3,stroke-width:2px

🛠️ Geliştirme

Proje Yapısı

KekikStream/
├── KekikStream/
│   ├── Core/              # Temel sınıflar
│   ├── Libs/              # Yardımcı kütüphaneler
│   ├── Plugins/           # Medya kaynak pluginleri
│   ├── Extractors/        # Video extractorları
│   └── __init__.py        # CLI entry point
├── Tests/                 # Örnek kullanım
└── requirements.txt

Yeni Plugin Ekleme

1. KekikStream/Plugins/ altına yeni dosya oluşturun.
2. PluginBase sınıfından türetin.
3. get_main_page, search, load_item, load_links metodlarını implemente edin.
4. Plugin'i test edin (örnek: Tests/Single.py).

🔧 Geliştirme Modu

KekikStream, eklenti geliştiricileri için otomatik bir geliştirme modu sunar:

Plugin Geliştirme:

• Çalışma dizininde Plugins/ klasörü oluşturup içine plugin dosyası eklerseniz, sadece bu local plugin'ler yüklenir
• Global plugin'ler (sisteme kurulu olanlar) otomatik olarak atlanır
• Bu sayede test sırasında diğer plugin'lerle karışma olmaz

Extractor Geliştirme:

• Çalışma dizininde Extractors/ klasörü oluşturup içine extractor dosyası eklerseniz, sadece bu local extractor'lar yüklenir
• Global extractor'lar otomatik olarak atlanır
• Kendi extractor'ınızı izole bir ortamda test edebilirsiniz

Örnek:

# Çalışma dizininizde
mkdir Plugins
touch Plugins/MyTestPlugin.py  # Plugin'inizi yazın

# KekikStream'i çalıştırın - sadece MyTestPlugin yüklenecek
KekikStream

💡 Not: Yerel dizinde herhangi bir Plugin/Extractor dosyası bulunmazsa, sistem normal şekilde global olanları yükler.

📊 Performans

🤝 Katkıda Bulunma

Projeyi geliştirmek için katkılarınızı bekliyoruz!

1. Yeni plugin ekleyin
2. Bug raporu açın
3. Feature request gönderin
4. Dokümantasyon iyileştirin

🎁 Teşekkürler

• DeoDorqnt387/aniwatch-tr

💻 Genişletme Referansları

• keyiflerolsun/Kekik-cloudstream
• keyiflerolsun/seyirTurk-Parser
• feroxx/Kekik-cloudstream
• kerimmkirac/cs-kerim
• Phisher98/Extractors
• cloudstream3/extractors
• hexated/cloudstream-extensions-hexated
• smy778/EncDecEndpoint

🌐 Telif Hakkı ve Lisans

Copyright (C) 2026 by keyiflerolsun ❤️️ GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Koşullarına göre lisanslanmıştır..

Bu proje @keyiflerolsun tarafından @KekikAkademi için geliştirilmiştir.

_{⭐ Beğendiyseniz yıldız vermeyi unutmayın!}