124 lines
2.8 KiB
Markdown
124 lines
2.8 KiB
Markdown
# YouTube Transcript RSS Feed Generator
|
||
|
||
YouTube video transkriptlerini otomatik olarak çıkarıp, tam metin içeren RSS feed'ine dönüştüren Docker tabanlı sistem.
|
||
|
||
## Özellikler
|
||
|
||
- ✅ **RSS-Bridge benzeri URL template** - Kanal adı/linki ile direkt feed
|
||
- ✅ **Web Server Modu** - Flask ile RESTful API
|
||
- ✅ RSS-Bridge entegrasyonu (100+ video desteği)
|
||
- ✅ Async rate limiting (AIOLimiter)
|
||
- ✅ SpaCy ile Sentence Boundary Detection
|
||
- ✅ SQLite veritabanı (durum yönetimi)
|
||
- ✅ Full-text RSS feed (`<content:encoded>`)
|
||
- ✅ Channel handle → Channel ID otomatik dönüştürme
|
||
- ✅ Atom ve RSS format desteği
|
||
|
||
## Hızlı Başlangıç
|
||
|
||
### Docker ile Web Server Modu (Önerilen)
|
||
|
||
```bash
|
||
# Build
|
||
docker-compose build
|
||
|
||
# Web server'ı başlat (port 5000)
|
||
docker-compose up -d
|
||
|
||
# Logları izle
|
||
docker-compose logs -f
|
||
```
|
||
|
||
### URL Template Kullanımı
|
||
|
||
RSS-Bridge benzeri URL template sistemi:
|
||
|
||
```
|
||
# Channel ID ile
|
||
http://localhost:5000/?channel_id=UC9h8BDcXwkhZtnqoQJ7PggA&format=Atom
|
||
|
||
# Channel Handle ile
|
||
http://localhost:5000/?channel=@tavakfi&format=Atom
|
||
|
||
# Channel URL ile
|
||
http://localhost:5000/?channel_url=https://www.youtube.com/@tavakfi&format=Atom
|
||
|
||
# RSS formatı
|
||
http://localhost:5000/?channel=@tavakfi&format=Rss
|
||
|
||
# Maksimum video sayısı
|
||
http://localhost:5000/?channel=@tavakfi&format=Atom&max_items=100
|
||
```
|
||
|
||
### Batch Mode (Manuel Çalıştırma)
|
||
|
||
```bash
|
||
# Tek seferlik çalıştırma
|
||
docker-compose run --rm yttranscriptrss python main.py
|
||
```
|
||
|
||
### Yerel Geliştirme
|
||
|
||
```bash
|
||
# Virtual environment oluştur
|
||
python -m venv venv
|
||
source venv/bin/activate # Linux/Mac
|
||
# veya
|
||
venv\Scripts\activate # Windows
|
||
|
||
# Bağımlılıkları kur
|
||
pip install -r requirements.txt
|
||
|
||
# SpaCy modelini indir
|
||
python -m spacy download en_core_web_sm
|
||
|
||
# Çalıştır
|
||
python main.py
|
||
```
|
||
|
||
## Yapılandırma
|
||
|
||
`config/config.yaml` dosyasını düzenleyin:
|
||
|
||
```yaml
|
||
channel:
|
||
id: "UC9h8BDcXwkhZtnqoQJ7PggA" # veya handle: "@username"
|
||
name: "Channel Name"
|
||
language: "tr"
|
||
|
||
rss_bridge:
|
||
base_url: "https://rss-bridge.org/bridge01"
|
||
format: "Atom"
|
||
max_items: 100
|
||
```
|
||
|
||
## Proje Yapısı
|
||
|
||
```
|
||
yttranscriptrss/
|
||
├── src/
|
||
│ ├── database.py # SQLite yönetimi
|
||
│ ├── video_fetcher.py # RSS-Bridge entegrasyonu
|
||
│ ├── transcript_extractor.py # Transcript çıkarımı
|
||
│ ├── transcript_cleaner.py # NLP ve temizleme
|
||
│ └── rss_generator.py # RSS feed oluşturma
|
||
├── config/
|
||
│ └── config.yaml # Yapılandırma
|
||
├── data/
|
||
│ └── videos.db # SQLite veritabanı
|
||
├── output/
|
||
│ └── transcript_feed.xml # RSS feed çıktısı
|
||
├── Dockerfile
|
||
├── docker-compose.yml
|
||
└── main.py
|
||
```
|
||
|
||
## Geliştirme Planı
|
||
|
||
Detaylı geliştirme planı için `development_plan.md` dosyasına bakın.
|
||
|
||
## Lisans
|
||
|
||
MIT
|
||
|