Timeline Studio

English | Español | Français | Deutsch | Русский | 中文 | Português | 日本語 | 한국어 | Türkçe | ไทย | العربية | فارسی

Proje Genel Bakış

Timeline Studio, Tauri mimarisi (Rust + React) üzerine inşa edilmiş modern bir video editörüdür.

Hedefimiz: Aşağıdakileri birleştiren bir editör oluşturmak: - DaVinci Resolve'un profesyonel gücü - düzenleme, renk derecelendirme, ses miksajı, görsel efektler, hareketli grafikler ve gelişmiş kompozisyon üzerinde tam kontrol - Kapsamlı yaratıcı kütüphane - Filmora gibi popüler editörlere kıyaslanabilir efektler, filtreler, geçişler, çoklu kamera şablonları, animasyonlu başlıklar, stil şablonları ve altyazı ön ayarları - AI komut dosyası ve otomasyon - farklı diller ve farklı platformlar için otomatik içerik üretimi

Temel yenilik: Kullanıcıların videoları, müzikleri ve diğer kaynakları yüklemesi yeterlidir ve AI, farklı dillerde ve farklı platformlar (YouTube, TikTok, Vimeo, Telegram) için optimize edilmiş bir dizi video otomatik olarak oluşturacaktır.

Proje Durumu (Haziran 2025)

Genel Tamamlanma: %75 - ✅ Temel düzenleme işlevselliği tamamlandı - ✅ GPU hızlandırmalı Video Derleyici - ✅ Tanıma modülü (YOLO v11) - ✅ Efektler, filtreler ve geçişler - ⚠️ Dışa aktarma UI'sının tamamlanması gerekiyor (%25) - ⚠️ Kaynak paneli geliştiriliyor (%40) - 🎯 MVP sürüm hedefi: Haziran 2025 sonu

Ana Özellikler

• 🎬 Çoklu parça zaman çizelgesiyle profesyonel video düzenleme
• 🖥️ Çapraz platform (Windows, macOS, Linux)
• 🚀 GPU hızlandırmalı video işleme (NVENC, QuickSync, VideoToolbox)
• 🤖 AI destekli nesne/yüz tanıma (YOLO v11)
• 🎨 30'dan fazla geçiş, görsel efekt ve filtre
• 📝 12 stil ve animasyonlu gelişmiş altyazı sistemi
• 🎵 Efektli çoklu parça ses düzenleme
• 🧠 XState v5 kullanarak durum yönetimi
• 🌐 Uluslararasılaştırma desteği (6 dil)
• 💾 Akıllı önbelleğe alma ve önizleme oluşturma
• 🎨 Tailwind CSS v4, shadcn-ui kullanarak modern UI
• 📚 %80'den fazla test kapsamıyla tam dokümantasyon

Başlarken

Ön Koşullar

• Node.js (v18 veya üzeri)
• Rust (en son kararlı sürüm)
• bun (en son kararlı sürüm)
• ffmpeg (en son kararlı sürüm)

Kurulum

1. Depoyu klonlayın:

git clone https://github.com/chatman-media/timeline-studio.git
cd timeline-studio

1. Bağımlılıkları yükleyin:

bun install

Geliştirme Modu Başlatma

bun run tauri dev

Sürüm Derlemesi

bun run tauri build

Dokümantasyon

📚 Ana Dokümantasyon

• 📚 Dokümantasyon Haritası - Tam dokümantasyon genel bakışı
• 🏗️ Mimari Kılavuzu - Sistem mimarisi
• 🧪 Test Kılavuzu - Test stratejileri
• 📡 API Referansı - Tauri komutları referansı
• 🚀 Dağıtım Kılavuzu - Derleme ve dağıtım
• 🛣️ Yol Haritası - Geliştirme yol haritası

📋 Proje Dokümantasyonu

• src/features/README.md - öncelikler ve durumla birlikte tüm özelliklerin genel bakışı
• Dil Sürümleri: Yukarıdaki değiştirici aracılığıyla 13 dilde mevcut

Geliştirme

Mevcut Betikler

• bun run dev - Geliştirme modunda Next.js başlat
• bun run tauri dev - Geliştirme modunda Tauri başlat
• bun run build - Next.js derle
• bun run tauri build - Tauri uygulaması derle

Linting ve Biçimlendirme

• bun run lint - ESLint ile JavaScript/TypeScript kodunu kontrol et
• bun run lint:fix - ESLint hatalarını düzelt
• bun run lint:css - Stylelint ile CSS kodunu kontrol et
• bun run lint:css:fix - Stylelint hatalarını düzelt
• bun run format:imports - İçe aktarmaları biçimlendir
• bun run lint:rust - Clippy ile Rust kodunu kontrol et
• bun run format:rust - rustfmt ile Rust kodunu biçimlendir
• bun run check:all - Tüm kontrolleri ve testleri çalıştır
• bun run fix:all - Tüm linting hatalarını düzelt

Test Etme

• bun run test - Testleri çalıştır
• bun run test:app - Sadece uygulama bileşenleri testlerini çalıştır
• bun run test:watch - İzleme modunda testleri çalıştır
• bun run test:ui - UI arayüzüyle testleri çalıştır
• bun run test:e2e - Playwright ile uçtan uca testleri çalıştır

Test Etme

Proje, birim testler için Vitest kullanır. Testler, özelliğin tests dizininde bulunur ve mock'lar mocks içindedir.

🧪 Test Kapsamı Durumu:

⨯ bun run test

 Test Files  258 passed | 1 skipped (259)
      Tests  3604 passed | 60 skipped (3664)
   Start at  20:08:23
   Duration  26.48s (transform 5.42s, setup 53.03s, collect 25.72s, tests 32.83s, environment 67.99s, prepare 16.45s)

⨯ bun run test:rust
   test result: ok. 366 passed; 0 failed; 2 ignored; 0 measured; 0 filtered out; finished in 12.26s

# İstemci testlerini çalıştır
bun run test

# Rust testlerini çalıştır
bun run test:rust

# Kapsam raporu ile testleri çalıştır
bun run test:coverage

# Belirli fonksiyon testlerini çalıştır
bun run test src/features/effects

Sürekli Entegrasyon ve Dağıtım

Proje, sürekli entegrasyon ve dağıtım için GitHub Actions kullanacak şekilde yapılandırılmıştır. İş akışları:

Doğrulama ve Derleme

• check-all.yml - Tüm kontrolleri ve testleri çalıştır
• lint-css.yml - Sadece CSS kodunu kontrol et (CSS dosyaları değiştiğinde çalışır)
• lint-rs.yml - Sadece Rust kodunu kontrol et (Rust dosyaları değiştiğinde çalışır)
• lint-js.yml - Sadece JavaScript/TypeScript kodunu kontrol et (JavaScript/TypeScript dosyaları değiştiğinde çalışır)

Dağıtım

• build.yml - Projeyi derle
• build-release.yml - Sürüm için projeyi derle
• deploy-promo.yml - GitHub Pages'de tanıtım sayfasını derle ve yayınla
• docs.yml - GitHub Pages'de API dokümantasyonu oluştur ve yayınla

Linter Yapılandırması

Stylelint (CSS)

Proje, CSS kodunu kontrol etmek için Stylelint kullanır. Yapılandırma .stylelintrc.json dosyasında bulunur. Ana özellikler:

• Tailwind CSS direktifleri desteği
• Tailwind uyumluluğu için yinelenen seçicileri yoksayma
• Dosyaları kaydederken otomatik hata düzeltme (VS Code'da)

CSS linter'ı çalıştırmak için komutu kullanın:

bun lint:css

Otomatik hata düzeltme için:

bun lint:css:fix

API Dokümantasyonu

API dokümantasyonu şu adreste mevcuttur: https://chatman-media.github.io/timeline-studio/api-docs/

Dokümantasyonu yerel olarak oluşturmak için komutu kullanın:

bun run docs

Dokümantasyon docs/ klasöründe mevcut olacaktır.

Gerçek zamanlı dokümantasyon geliştirme için:

bun run docs:watch

Dokümantasyon, GitHub Actions iş akışı docs.yml kullanılarak main dalındaki kaynak kod değişikliklerinde otomatik olarak güncellenir.

Tanıtım Sayfası

Proje tanıtım sayfası şu adreste mevcuttur: https://chatman-media.github.io/timeline-studio/

Tanıtım sayfası kaynak kodu promo/ klasöründe bulunur.

Tanıtım sayfasının yerel geliştirmesi için komutları kullanın:

cd promo
bun install
bun run dev

Tanıtım sayfasını derlemek için:

cd promo
bun run build

Tanıtım sayfası, GitHub Actions iş akışı deploy-promo.yml kullanılarak main dalındaki promo/ klasör dosya değişikliklerinde otomatik olarak güncellenir.

Ek Kaynaklar

• Tauri Dokümantasyonu
• XState Dokümantasyonu
• Vitest Dokümantasyonu
• Tailwind CSS Dokümantasyonu
• Shadcn UI Dokümantasyonu
• Stylelint Dokümantasyonu
• ESLint Dokümantasyonu
• Playwright Dokümantasyonu
• TypeDoc Dokümantasyonu
• ffmpeg Dokümantasyonu

Lisans

Bu proje, Commons Clause koşulu ile MIT Lisansı altında dağıtılmaktadır.

Ana şartlar:

• Açık Kaynak: MIT Lisans şartlarına göre kodu özgürce kullanabilir, değiştirebilir ve dağıtabilirsiniz.
• Ticari Kullanım Kısıtlaması: Commons Clause, yazar ile ayrı bir anlaşma olmaksızın yazılımı "satmayı" yasaklar.
• "Satmak", yazılım işlevselliğini kullanarak üçüncü taraflara ücret karşılığında ürün veya hizmet sağlamak anlamına gelir.

Bu lisans şunlara izin verir:

• Kişisel ve ticari olmayan projelerde kod kullanımı
• Kodu inceleme ve değiştirme
• Değişiklikleri aynı lisans altında dağıtma

Ancak şunları yasaklar:

• Lisans olmaksızın kod tabanlı ticari ürün veya hizmet oluşturma

Ticari lisans almak için yazara başvurun: ak.chatman.media@gmail.com

Tam lisans metni LICENSE dosyasında mevcuttur

GitHub Pages

Proje, API dokümantasyonu ve tanıtım sayfası barındırma için GitHub Pages kullanır:

• Tanıtım Sayfası: https://chatman-media.github.io/timeline-studio/
• API Dokümantasyonu: https://chatman-media.github.io/timeline-studio/api-docs/

Her iki sayfa da GitHub Actions iş akışları kullanılarak main dalındaki ilgili dosyalar değiştiğinde otomatik olarak güncellenir.