sondakika 1.0.8 → 2.0.0

package/README.md

@@ -1,91 +1,203 @@
 # Sondakika
 
-Terminal-based CLI tool to fetch and display breaking news from RSS feeds.
-
-![sondakika](https://img.shields.io/badge/sondakika-news%20CLI-blue)
-![Node.js](https://img.shields.io/badge/Node.js-14%2B-green)
-![License](https://img.shields.io/badge/License-ISC-yellow)
-
-## Features
-
-- 📰 Fetch news from multiple Turkish news sources
-- 🔗 Clickable URLs in terminal (iTerm2, Windows Terminal, macOS Terminal)
-- 🎨 Styled terminal output with Unicode borders
-- ⚡ Fast and lightweight
-
-## Installation
-
-### Using npx (no install)
-
+**Windows için Modern Electron Tabanlı RSS Haber Okuyucu + Eski CLI Aracı**  
+*Türkçe haberleri gerçek zamanlı toplayan yerel masaüstü uygulaması, artı orijinal terminal tabanlı CLI işlevselliği*
+
+[![Sürüm](https://img.shields.io/badge/sürüm-2.0.0-blue)](https://github.com/eaeoz/sondakika/releases)  
+[![Lisans](https://img.shields.io/badge/lisans-ISC-green)](LICENSE)  
+[![Windows Desteği](https://img.shields.io/badge/Windows-10+-lightgrey)](https://www.microsoft.com/windows)  
+[![İndir](https://img.shields.io/badge/İndir-Windows%20Yükleyici-blue?style=for-the-badge)](https://github.com/eaeoz/sondakika/releases/download/2.0.0/Sondakika.Setup.2.0.0.exe)
+
+---
+
+## 📋 İçindekiler
+1. [Genel Bakış](#-genel-bakış-1)
+2. [🪟 Windows Masaüstü Uygulaması (v2.0.0 GUI)](#-windows-masaüstü-uygulaması-v200-gui-1)
+   - [Sondakika Nedir?](#sondakika-nedir)
+   - [Nasıl Çalışır?](#nasıl-çalışır)
+   - [Sistem Gereksinimleri](#sistem-gereksinimleri)
+   - [📥 İndirme](#-indirme)
+   - [Kurulum](#kurulum)
+   - [Başlangıç](#başlangıç)
+   - [Temel Özellikler](#temel-özellikler)
+3. [⌨️ GUI Klavye Kısayolları](#️-gui-klavye-kısayolları)
+4. [⌨️ Eski CLI Kullanımı (v1.x)](#️-eski-cli-kullanımı-v1x)
+   - [CLI Özellikleri](#cli-özellikleri)
+   - [CLI Kurulumu](#cli-kurulumu)
+   - [CLI Kullanım Örnekleri](#cli-kullanım-örnekleri)
+   - [Mevcut Kaynaklar](#mevcut-kaynaklar)
+5. [🛠️ Kaynaktan Derleme](#️-kaynaktan-derleme)
+6. [📦 v2.0.0'da Neler Yaptık?](#-v200da-neler-yaptık)
+7. [🤝 Katkıda Bulunma](#-katkıda-bulunma)
+8. [📄 Lisans](#-lisans-1)
+
+---
+
+## 📖 Genel Bakış
+Sondakika iki modda mevcuttur:
+- **v2.0.0+**: Uygulama içi makale okuyucu, temalandırma ve klavye navigasyonu içeren tam özellikli yerel Windows Electron GUI
+- **v1.x Eski**: Türk RSS beslemelerinden terminalinizde doğrudan haber getirmek ve görüntülemek için hafif terminal tabanlı CLI aracı
+
+Varsayılan `npm start` komutu v2.0.0 Electron GUI'sini çalıştırır. Eski CLI işlevselliği, terminal tabanlı iş akışlarını tercih eden kullanıcılar için korunmuştur (tam CLI kodu için v1.x sürümlerine bakın).
+
+---
+
+## 🪟 Windows Masaüstü Uygulaması (v2.0.0 GUI)
+
+### Sondakika Nedir?
+9 büyük Türk haber kaynağından (Cumhuriyet, TRT Haber, Mynet, Sabah, Star, Gazete Vatan, Habertürk, CNN Türk, Yeni Şafak, Anadolu Ajansı) gerçek zamanlı haberleri modern ve kolay okunabilir bir arayüzde getiren yerel bir Windows uygulaması.
+
+### Nasıl Çalışır?
+1. Uygulama, yapılandırılmış Türk haber kaynaklarından RSS beslemelerini almak için `rss-parser` kullanır
+2. Haber makaleleri, kaynak rozetleri ve zaman damgalarıyla kart tabanlı düzende görüntülenir
+3. Tam içeriği görüntülemek için herhangi bir makaleye tıklayarak uygulama içi okuyucuyu açın
+4. Kullanıcı tercihleri (etkin kaynaklar, tema, yazı boyutları, pencere konumu) yerel olarak kaydedilir
+5. Makaleler arasında klavye kısayollarını veya ekrandaki düğmeleri kullanarak gezinin
+6. Tek tıklamayla herhangi bir makaleyi varsayılan tarayıcınızda açın
+
+### Sistem Gereksinimleri
+- Windows 10 (sürüm 1809 veya üzeri) / Windows 11
+- 64-bit (x64) işlemci
+- 200MB boş disk alanı
+- Haberleri çekmek için internet bağlantısı
+
+### 📥 İndirme
+
+Windows yükleyicisini doğrudan indirin:
+
+[![Sondakika 2.0.0 İndir](https://img.shields.io/badge/⬇️%20İndir-Windows%20Yükleyici%20(64-bit)-blue?style=for-the-badge)](https://github.com/eaeoz/sondakika/releases/download/2.0.0/Sondakika.Setup.2.0.0.exe)
+
+**Doğrudan Link:**  
+`https://github.com/eaeoz/sondakika/releases/download/2.0.0/Sondakika.Setup.2.0.0.exe`
+
+Veya tüm sürümler için (v1.x CLI-only sürümleri dahil) [GitHub Releases sayfasını](https://github.com/eaeoz/sondakika/releases) ziyaret edin.
+
+### Kurulum
+1. Yukarıdaki bağlantıyı kullanarak `Sondakika.Setup.2.0.0.exe` dosyasını indirin
+2. Yükleyiciyi çalıştırın ve ekrandaki talimatları izleyin
+3. Uygulama kurulumdan sonra otomatik olarak başlayacaktır
+4. Başlat menüsüne ve Masaüstüne kısayollar eklenecektir
+
+### Başlangıç
+1. **İlk Açılış**: Uygulama varsayılan haber kaynakları etkin olarak açılır (Cumhuriyet, TRT Haber, Mynet, Habertürk, CNN Türk)
+2. **Kaynak Seçimi**: Kenar çubuğu onay kutularını kullanarak haber kaynaklarını etkinleştirin/devre dışı bırakın
+3. **Haberleri Getir**: En son başlıkları getirmek için "🔄 Yenile" düğmesine tıklayın
+4. **Makaleleri Oku**: Tam makaleyi uygulama içi okuyucuda açmak için herhangi bir haber kartına tıklayın
+5. **Özelleştir**: Kenar çubuğu seçeneklerini kullanarak temayı, yazı boyutlarını, sıralama düzenini ve sayfa başına öğe sayısını değiştirin
+
+### Temel Özellikler
+- ✅ **9 Türk Haber Kaynağı**: Cumhuriyet, TRT Haber, Mynet, Sabah, Star, Gazete Vatan, Habertürk, CNN Türk, Yeni Şafak, Anadolu Ajansı
+- ✅ **Modern Arayüz**: Kart tabanlı haber düzeni ile temiz, duyarlı tasarım
+- ✅ **Karanlık/Açık Tema**: Karanlık (varsayılan) ve açık temalar arasında geçiş yapın
+- ✅ **Uygulama İçi Makale Okuyucu**: Tarayıcı açmadan tam makaleleri okuyun
+- ✅ **Makale Gezintisi**: Animasyonlu geçişlerle okuyucudaki makaleler arasında gezinin
+- ✅ **Ayarlabilir Yazı Boyutları**: Başlık (12-32px) ve içerik (10-28px) yazı tipleri için ayrı kontroller
+- ✅ **Klavye Navigasyonu**: Navigasyon ve kontroller için tam klavye desteği
+- ✅ **Kaynak Filtreleme**: Bireysel haber kaynaklarını etkinleştirin/devre dışı bırakın
+- ✅ **Sıralama Seçenekleri**: Önce en yeni veya en eski olarak sıralayın
+- ✅ **Sayfalama**: Sayfa başına kaç makale görüntüleneceğini kontrol edin (5, 10, 15, 20)
+- ✅ **Görsel Çıkarımı**: RSS beslemelerinden makale görsellerini otomatik olarak çıkarır ve görüntüler
+- ✅ **Durum Kalıcılığı**: Ayarlarınızı, pencere konumunuzu ve etkin kaynakları hatırlar
+- ✅ **Harici Bağlantı Desteği**: Makaleleri varsayılan tarayıcınızda açın
+- ✅ **Türkçe Dil Arayüzü**: Tamamen yerelleştirilmiş arayüz
+- ✅ **Özel Uygulama Simgesi**: Çok boyutlu simge ile profesyonel markalama
+
+---
+
+## ⌨️ GUI Klavye Kısayolları
+
+### Ana Pencere
+| Kısayol | Eylem |
+|---------|-------|
+| `↑` `↓` | Haber makalesi seç |
+| `←` `→` | Sayfalar arasında gezinti |
+| `Enter` | Seçili makaleyi okuyucuda aç |
+| `1` `2` | Başlık yazı boyutunu azalt/artır |
+| `3` `4` | İçerik yazı boyutunu azalt/artır |
+| `` ` `` | Seçili makaleyi tarayıcıda aç |
+| `F5` / Yenile'ye Tıkla | En son haberleri getir |
+
+### Makale Okuyucu
+| Kısayol | Eylem |
+|---------|-------|
+| `↑` `↓` `Space` | Makale içeriğini kaydır |
+| `PageUp` `PageDown` | Sayfa sayfa kaydır |
+| `Home` `End` | En üste/en alta kaydır |
+| `←` `→` | Önceki/Sonraki makale |
+| `Enter` `Escape` | Haber listesine dön |
+| `1` `2` | Başlık yazı boyutunu azalt/artır |
+| `3` `4` | İçerik yazı boyutunu azalt/artır |
+| `` ` `` | Makaleyi tarayıcıda aç |
+
+---
+
+### CLI Özellikleri
+- 📰 Birden fazla Türk haber kaynağından haber getir
+- 🔗 Terminalde tıklanabilir URL'ler (iTerm2, Windows Terminal, macOS Terminal)
+- 🎨 Unicode kenarlıkları ile stillendirilmiş terminal çıktısı
+- ⚡ Hızlı ve hafif
+
+### CLI Kurulumu
+#### npx kullanarak (kurulum gerektirmez, sadece v1.x)
 ```bash
-npx sondakika ntv
+npx sondakika trt
 ```
 
-### Global install
-
+#### Global kurulum (v1.x)
 ```bash
 npm install -g sondakika
 ```
 
-## Usage Examples
-
+### CLI Kullanım Örnekleri
 ```bash
-# Show NTV news (default 10 items)
-sondakika ntv
-
-# Show 15 NTV news items
-sondakika ntv 15
-
-# Show Cumhuriyet news
+# Cumhuriyet haberlerini göster
 sondakika cumhuriyet
 
-# Show Cumhuriyet news with custom count
+# Cumhuriyet haberlerini özel sayıyla göster
 sondakika cumhuriyet 20
 
-# Show TRT Haber news
+# TRT Haber haberlerini göster
 sondakika trt
 
-# Show TRT Haber news with custom count
+# TRT Haber haberlerini özel sayıyla göster
 sondakika trt 15
 
-# Show Mynet news
+# Mynet haberlerini göster
 sondakika mynet
 
-# Show Mynet news with custom count
+# Mynet haberlerini özel sayıyla göster
 sondakika mynet 15
 
-# Show Sabah news
+# Sabah haberlerini göster
 sondakika sabah
 
-# Show Habertürk news with custom count
+# Habertürk haberlerini özel sayıyla göster
 sondakika haberturk 5
 
-# Show Star news
+# Star haberlerini göster
 sondakika star
 
-# Show CNN Türk news
+# CNN Türk haberlerini göster
 sondakika cnnturk
 
-# Show Yeni Şafak news
+# Yeni Şafak haberlerini göster
 sondakika yenisafak
 
-# Show Anadolu Ajansı news
+# Anadolu Ajansı haberlerini göster
 sondakika aa
 ```
 
-### Available Sources
-
+### Mevcut Kaynaklar
 #### Son Dakika (Breaking News)
-| Command | Source |
-|---------|--------|
-| `ntv` | NTV (Son Dakika) |
+| Komut | Kaynak |
+|-------|--------|
 | `cumhuriyet` | Cumhuriyet |
 | `trt` | TRT Haber |
 | `mynet` | Mynet |
 
 #### Haberler (General News)
-| Command | Source |
-|---------|--------|
+| Komut | Kaynak |
+|-------|--------|
 | `sabah` | Sabah |
 | `star` | Star |
 | `vatan` | Gazete Vatan |
@@ -94,19 +206,17 @@ sondakika aa
 | `yenisafak` | Yeni Şafak |
 | `aa` | Anadolu Ajansı |
 
-### Help
-
+### CLI Yardım
 ```bash
 sondakika
-# or
+# veya
 sondakika --help
 ```
 
-## Output Example
-
+### CLI Çıktı Örneği
 ```
 📰 ══════════════════════════════════════════════════
-   Latest 10 News from NTV (Son Dakika)
+   Latest 10 News from TRT (Son Dakika)
    Son guncelleme: 10.04.2026 20:02
    ══════════════════════════════════════════════════
 
@@ -116,26 +226,88 @@ sondakika --help
   │
   │   Son depremler...
   └─────────────────────────────────────────────────────────────────────
-  🔗 https://www.ntv.com.tr/...
+  🔗 https://www.trt...
 ```
 
-## Development
+---
+
+## 🛠️ Kaynaktan Derleme
 
 ```bash
-# Clone and install
+# Depoyu klonlayın
+git clone https://github.com/eaeoz/sondakika.git
+cd sondakika
+
+# Bağımlılıkları yükleyin (hem GUI hem de eski CLI bağımlılıklarını içerir)
 npm install
 
-# Run locally
+# v2.0.0 Electron GUI'sini çalıştır (varsayılan)
 npm start
 
-# Link for global testing
-npm link
+# Windows yükleyicisini derle (NSIS formatı, x64)
+npm run build
 ```
 
-## License
+Derlenen yükleyici `dist/` klasöründe `Sondakika.Setup.2.0.0.exe` olarak bulunacaktır.
+
+Eski CLI işlevselliği üzerinde çalışmak için [eski sürümlerdeki](https://github.com/eaeoz/sondakika/releases) v1.x kaynak koduna bakın.
+
+---
+
+## 📦 v2.0.0'da Neler Yaptık?
+
+Bu sürüm, orijinal CLI aracından tam özellikli bir Windows masaüstü uygulamasına tam geçiştir:
+
+### Teknik Uygulama
+- ✅ Masaüstü uygulama çatısı olarak **Electron 28.3.3** entegre edildi
+- ✅ Windows x64 için NSIS hedefi ile **electron-builder 24.13.3** yapılandırıldı
+- ✅ Özel çok boyutlu uygulama simgesi tasarlandı ve gömüldü (`assets/icon.ico` ve `assets/icon.png`)
+- ✅ Otomatik Başlat menüsü/Masaüstü kısayolları ile taşınabilir Windows yükleyicisi oluşturuldu
+- ✅ Ana ve oluşturucu işlemler arasında IPC iletişimi uygulandı
+- ✅ Güvenli bağlam yalıtımı için ön yükleme (preload) komut dosyaları oluşturuldu
+
+### GUI Geliştirme
+- ✅ Temalandırma için CSS özel özellikleri ile **Inter font** ve modern UI tasarlandı
+- ✅ CSS değişkenleri ile **karanlık/açık tema sistemi** uygulandı
+- ✅ Kaynak seçim onay kutuları ve ayar kontrolleri ile **kenar çubuğu** oluşturuldu
+- ✅ Hover efektleri ve seçim durumları ile **kart tabanlı haber ızgarası** oluşturuldu
+- ✅ Özel pencere ve gezinti ile **uygulama içi makale okuyucu** geliştirildi
+- ✅ Tüm pencerelerde **klavye navigasyonu** desteği eklendi
+- ✅ Kullanıcı verileri dizininde JSON dosyaları kullanarak **durum kalıcılığı** uygulandı
+- ✅ Erişilebilirlik için **yazı boyutu kontrolleri** eklendi (başlık ve içerik ayrı)
+- ✅ Yapılandırılabilir sayfa başına öğe ile **sayfalama sistemi** oluşturuldu
+- ✅ Görsel çıkarımı ve tarih biçimlendirmesi ile **RSS ayrıştırma** uygulandı
+- ✅ Haber getirme sırasında daha iyi UX için **yükleme iskeletleri** eklendi
+- ✅ Uygulama genelinde **Türkçe dil arayüzü** oluşturuldu
+
+### Haber Kaynağı Entegrasyonu
+- ✅ 9 büyük Türk haber RSS beslemesi entegre edildi
+- ✅ Kaynağa özel görsel çıkarım desenleri uygulandı (örn. Gazete Vatan)
+- ✅ Yanlış UTC sapması olan kaynaklar için saat dilimi düzeltmesi eklendi (CNN Türk, Yeni Şafak)
+- ✅ Kaynaklar "Son Dakika" ve normal haber olarak kategorize edildi
+
+### Eski CLI Korunması
+- ✅ Terminal UI desteği için `blessed` bağımlılığı korundu
+- ✅ Eski kullanıcılar için tüm v1.x CLI belgeleri korundu
+- ✅ CLI'dan GUI'ye geçiş yapan kullanıcılar için geriye dönük uyumluluk notları tutuldu
+
+---
+
+## 🤝 Katkıda Bulunma
+Katkılarınızı bekliyoruz! Lütfen şu adımları izleyin:
+1. Depoyu çatallayın (fork)
+2. Özelliğiniz için yeni bir dal oluşturun (`git checkout -b feature/ozelliginiz`)
+3. Değişikliklerinizi işleyin (`git commit -m "Yeni özellik ekle"`)
+4. Dala gönderin (`git push origin feature/ozelliginiz`)
+5. Bir Pull Request açın
+
+CLI ile ilgili katkılar için v1.x kaynak kodu yapısına bakın.
+
+---
 
-ISC
+## 📄 Lisans
+Bu proje ISC Lisansı altında lisanslanmıştır - ayrıntılar için [LICENSE](LICENSE) dosyasına bakın.
 
-## Author
+---
 
-Sedat ERGOZ
+*Geliştirici: [Sedat Ergoz](https://github.com/eaeoz)*

package/assets/icon.svg

@@ -0,0 +1,21 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" width="256" height="256">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#1a1a2e;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#16213e;stop-opacity:1" />
+    </linearGradient>
+  </defs>
+  <rect width="256" height="256" rx="40" fill="url(#bg)"/>
+  <rect x="48" y="40" width="160" height="176" rx="8" fill="#0f3460"/>
+  <rect x="56" y="48" width="144" height="160" rx="4" fill="white"/>
+  <line x1="56" y1="75" x2="200" y2="75" stroke="#e94560" stroke-width="3"/>
+  <rect x="68" y="85" width="60" height="8" rx="2" fill="#1a1a2e"/>
+  <rect x="68" y="100" width="80" height="6" rx="2" fill="#ccc"/>
+  <rect x="68" y="112" width="70" height="6" rx="2" fill="#ccc"/>
+  <rect x="68" y="124" width="75" height="6" rx="2" fill="#ccc"/>
+  <rect x="68" y="140" width="60" height="6" rx="2" fill="#ccc"/>
+  <rect x="68" y="152" width="65" height="6" rx="2" fill="#ccc"/>
+  <rect x="68" y="164" width="55" height="6" rx="2" fill="#ccc"/>
+  <rect x="140" y="85" width="56" height="85" rx="4" fill="#e94560" opacity="0.2"/>
+  <text x="168" y="135" font-family="Arial" font-size="32" font-weight="bold" fill="#e94560" text-anchor="middle">S</text>
+</svg>