sondakika 2.0.6 → 2.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +342 -324
  2. package/cli.js +555 -488
  3. package/package.json +25 -25
package/README.md CHANGED
@@ -1,325 +1,343 @@
1
- # Sondakika
2
- **Windows için Modern Electron Tabanlı RSS Haber Okuyucu + Eski CLI Aracı**
3
- *Türkçe haberleri gerçek zamanlı toplayan yerel masaüstü uygulaması, artı orijinal terminal tabanlı CLI işlevselliği*
4
-
5
- [![Sürüm](https://img.shields.io/badge/sürüm-2.0.3-blue)](https://github.com/eaeoz/sondakika/releases)
6
- [![Lisans](https://img.shields.io/badge/lisans-ISC-green)](LICENSE)
7
- [![Windows Desteği](https://img.shields.io/badge/Windows-10+-lightgrey)](https://www.microsoft.com/windows)
8
- [![İndir](https://img.shields.io/badge/İndir-Windows%20Yükleyici-blue?style=for-the-badge)](https://github.com/eaeoz/sondakika/releases/download/2.0.3/Sondakika.Setup.2.0.3.exe) [![İndir](https://img.shields.io/badge/İndir-Windows%20Portable-green?style=for-the-badge)](https://github.com/eaeoz/sondakika/releases/download/2.0.3/Sondakika_portable_2.0.3.exe)
9
-
10
- ---
11
-
12
- ## 📋 İçindekiler
13
- 1. [Genel Bakış](#genel-bakış)
14
- 2. [🪟 Windows Masaüstü Uygulaması (v2.0.3 GUI)](#-windows-masaüstü-uygulaması-v203-gui)
15
- - [Sondakika Nedir?](#sondakika-nedir)
16
- - [Nasıl Çalışır?](#nasıl-çalışır)
17
- - [Sistem Gereksinimleri](#sistem-gereksinimleri)
18
- - [📥 İndirme](#-indirme)
19
- - [Kurulum](#kurulum)
20
- - [Başlangıç](#başlangıç)
21
- - [Temel Özellikler](#temel-özellikler)
22
- 3. [⌨️ GUI Klavye Kısayolları](#️-gui-klavye-kısayolları)
23
- 4. [⌨️ Eski CLI Kullanımı (v1.x)](#️-eski-cli-kullanımı-v1x)
24
- - [CLI Özellikleri](#cli-özellikleri)
25
- - [CLI Kurulumu](#cli-kurulumu)
26
- - [CLI Kullanım Örnekleri](#cli-kullanım-örnekleri)
27
- - [Mevcut Kaynaklar](#mevcut-kaynaklar)
28
- 5. [🛠️ Kaynaktan Derleme](#️-kaynaktan-derleme)
29
- 6. [📦 v2.0.2'de Neler Yaptık?](#-v202de-neler-yaptık)
30
- 7. [🤝 Katkıda Bulunma](#-katkıda-bulunma)
31
- 8. [📄 Lisans](#-lisans)
32
-
33
- ---
34
-
35
- ## Genel Bakış
36
- Sondakika iki modda sunulur:
37
- - **v2.0.3+**: Uygulama içi makale okuyucu, temalandırma ve klavye navigasyonu içeren tam özellikli yerel Windows Electron GUI
38
- - **v1.x Eski**: Türk RSS beslemelerinden terminalde doğrudan haber getirmek için hafif terminal tabanlı CLI aracı
39
-
40
- Varsayılan `npm start` komutu v2.0.3 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](https://github.com/eaeoz/sondakika/releases) bakın).
41
-
42
- ---
43
-
44
- ## 🪟 Windows Masaüstü Uygulaması (v2.0.3 GUI)
45
-
46
- ### Sondakika Nedir?
47
- 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ıdır.
48
-
49
- ### Nasıl Çalışır?
50
- 1. Uygulama, yapılandırılmış Türk haber kaynaklarından RSS beslemelerini almak için `rss-parser` kullanır
51
- 2. Haber makaleleri, kaynak rozetleri ve zaman damgalarıyla kart tabanlı düzende görüntülenir
52
- 3. Tam içeriği görüntülemek için herhangi bir makaleye tıklayarak uygulama içi okuyucuyu açın
53
- 4. Kullanıcı tercihleri (etkin kaynaklar, tema, yazı boyutları, pencere konumu) yerel olarak kaydedilir
54
- 5. Makaleler arasında klavye kısayollarını veya ekrandaki düğmeleri kullanarak gezinin
55
- 6. Tek tıklamayla herhangi bir makaleyi varsayılan tarayıcınızda açın
56
-
57
- ### Sistem Gereksinimleri
58
- - Windows 10 (sürüm 1809 veya üzeri) / Windows 11
59
- - 64-bit (x64) işlemci
60
- - 200MB boş disk alanı
61
- - Haberleri çekmek için internet bağlantısı
62
-
63
- ### 📥 İndirme
64
- Windows yükleyicisini doğrudan indirin:
65
-
66
- [![Sondakika 2.0.3 İ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.3/Sondakika.Setup.2.0.3.exe)
67
-
68
- **Doğrudan Link:**
69
- `https://github.com/eaeoz/sondakika/releases/download/2.0.3/Sondakika.Setup.2.0.3.exe`
70
-
71
- **Portable Sürüm (Kurulumsuz):**
72
- Doğrudan indirip çalıştırabilirsiniz, kurulum gerektirmez:
73
-
74
- [![Sondakika 2.0.3 Portable İndir](https://img.shields.io/badge/⬇️%20İndir-Windows%20Portable%20(64-bit)-green?style=for-the-badge)](https://github.com/eaeoz/sondakika/releases/download/2.0.3/Sondakika_portable_2.0.3.exe)
75
-
76
- **Doğrudan Link:**
77
- `https://github.com/eaeoz/sondakika/releases/download/2.0.3/Sondakika_portable_2.0.3.exe`
78
-
79
- *Not: Portable sürüm kurulum yapmaz, Windows Smart App Control uyarısını engellemek için idealdir.*
80
-
81
- 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.
82
-
83
- ### Kurulum
84
- 1. Yukarıdaki bağlantıyı kullanarak `Sondakika.Setup.2.0.3.exe` dosyasını indirin
85
- 2. Yükleyiciyi çalıştırın ve ekrandaki talimatları izleyin
86
- 3. Uygulama kurulumdan sonra otomatik olarak başlayacaktır
87
- 4. Başlat menüsüne ve Masaüstüne kısayollar eklenecektir
88
-
89
- ### Başlangıç
90
- 1. **İlk Açılış**: Uygulama varsayılan haber kaynakları etkin olarak açılır (Cumhuriyet, TRT Haber, Mynet, Habertürk, CNN Türk)
91
- 2. **Kaynak Seçimi**: Kenar çubuğu onay kutularını kullanarak haber kaynaklarını etkinleştirin/devre dışı bırakın
92
- 3. **Haberleri Getir**: En son başlıkları getirmek için "🔄 Yenile" düğmesine tıklayın
93
- 4. **Makaleleri Oku**: Tam makaleyi uygulama içi okuyucuda açmak için herhangi bir haber kartına tıklayın
94
- 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
95
-
96
- ### Temel Özellikler
97
- - **9 Türk Haber Kaynağı**: Cumhuriyet, TRT Haber, Mynet, Sabah, Star, Gazete Vatan, Habertürk, CNN Türk, Yeni Şafak, Anadolu Ajansı
98
- - ✅ **Modern Arayüz**: Kart tabanlı haber düzeni ile temiz, duyarlı tasarım
99
- - **Karanlık/Açık Tema**: Karanlık (varsayılan) ve açık temalar arasında geçiş yapın
100
- - ✅ **Uygulama İçi Makale Okuyucu**: Tarayıcı açmadan tam makaleleri okuyun
101
- - ✅ **Makale Gezintisi**: Animasyonlu geçişlerle okuyucudaki makaleler arasında gezinin
102
- - **Ayarlabilir Yazı Boyutları**: Başlık (12-32px) ve içerik (10-28px) yazı tipleri için ayrı kontroller
103
- - **Klavye Navigasyonu**: Navigasyon ve kontroller için tam klavye desteği
104
- - **Kaynak Filtreleme**: Bireysel haber kaynaklarını etkinleştirin/devre dışı bırakın
105
- - **Sıralama Seçenekleri**: Önce en yeni veya en eski olarak sıralayın
106
- - ✅ **Sayfalama**: Sayfa başına kaç makale görüntüleneceğini kontrol edin (5, 10, 15, 20)
107
- - ✅ **Görsel Çıkarımı**: RSS beslemelerinden makale görsellerini otomatik olarak çıkarır ve görüntüler
108
- - **Durum Kalıcılığı**: Ayarlarınızı, pencere konumunuzu ve etkin kaynakları hatırlar
109
- - **Harici Bağlantı Desteği**: Makaleleri varsayılan tarayıcınızda açın
110
- - **Türkçe Dil Arayüzü**: Tamamen yerelleştirilmiş arayüz
111
- - **Özel Uygulama Simgesi**: Çok boyutlu simge ile profesyonel markalama
112
-
113
- ---
114
-
115
- ## ⌨️ GUI Klavye Kısayolları
116
-
117
- ### Ana Pencere
118
- | Kısayol | Eylem |
119
- |---------|-------|
120
- | `↑` `↓` | Haber makalesi seç |
121
- | `←` `→` | Sayfalar arasında gezinti |
122
- | `Enter` | Seçili makaleyi okuyucuda |
123
- | `1` `2` | Başlık yazı boyutunu azalt/artır |
124
- | `3` `4` | İçerik yazı boyutunu azalt/artır |
125
- | `` ` `` | Seçili makaleyi tarayıcıda |
126
- | `F5` / Yenile'ye Tıkla | En son haberleri getir |
127
-
128
- ### Makale Okuyucu
129
- | Kısayol | Eylem |
130
- |---------|-------|
131
- | `↑` `↓` `Space` | Makale içeriğini kaydır |
132
- | `PageUp` `PageDown` | Sayfa sayfa kaydır |
133
- | `Home` `End` | En üste/en alta kaydır |
134
- | `←` `→` | Önceki/Sonraki makale |
135
- | `Enter` `Escape` | Haber listesine dön |
136
- | `1` `2` | Başlık yazı boyutunu azalt/artır |
137
- | `3` `4` | İçerik yazı boyutunu azalt/artır |
138
- | `` ` `` | Makaleyi tarayıcıda |
139
-
140
- ---
141
-
142
- ## ⌨️ Eski CLI Kullanımı (v1.x)
143
- *Not: v2.0.2 kod tabanı Electron GUI'sine odaklanmıştır. Aşağıdaki CLI işlevselliği v1.x sürümlerinden korunmuştur. Tam CLI aracını kullanmak için [v1.x sürümlerine](https://github.com/eaeoz/sondakika/releases) bakın veya `npm install -g sondakika` ile eski sürümü yükleyin.*
144
-
145
- ### CLI Özellikleri
146
- - 📰 Birden fazla Türk haber kaynağından haber getir
147
- - 🔗 Terminalde tıklanabilir URL'ler (iTerm2, Windows Terminal, macOS Terminal)
148
- - 🎨 Unicode kenarlıkları ile stillendirilmiş terminal çıktısı
149
- - Hızlı ve hafif
150
-
151
- ### CLI Kurulumu
152
- #### npx kullanarak (kurulum gerektirmez, sadece v1.x)
153
- ```bash
154
- npx sondakika trt
155
- ```
156
-
157
- #### Global kurulum (v1.x)
158
- ```bash
159
- npm install -g sondakika
160
- ```
161
-
162
- ### CLI Kullanım Örnekleri
163
- ```bash
164
- # Cumhuriyet haberlerini göster
165
- sondakika cumhuriyet
166
-
167
- # Cumhuriyet haberlerini özel sayıyla göster
168
- sondakika cumhuriyet 20
169
-
170
- # TRT Haber haberlerini göster
171
- sondakika trt
172
-
173
- # TRT Haber haberlerini özel sayıyla göster
174
- sondakika trt 15
175
-
176
- # Mynet haberlerini göster
177
- sondakika mynet
178
-
179
- # Mynet haberlerini özel sayıyla göster
180
- sondakika mynet 15
181
-
182
- # Sabah haberlerini göster
183
- sondakika sabah
184
-
185
- # Habertürk haberlerini özel sayıyla göster
186
- sondakika haberturk 5
187
-
188
- # Star haberlerini göster
189
- sondakika star
190
-
191
- # CNN Türk haberlerini göster
192
- sondakika cnnturk
193
-
194
- # Yeni Şafak haberlerini göster
195
- sondakika yenisafak
196
-
197
- # Anadolu Ajansı haberlerini göster
198
- sondakika aa
199
- ```
200
-
201
- ### Mevcut Kaynaklar
202
- #### Son Dakika (Breaking News)
203
- | Komut | Kaynak |
204
- |-------|--------|
205
- | `cumhuriyet` | Cumhuriyet |
206
- | `trt` | TRT Haber |
207
- | `mynet` | Mynet |
208
-
209
- #### Haberler (General News)
210
- | Komut | Kaynak |
211
- |-------|--------|
212
- | `sabah` | Sabah |
213
- | `star` | Star |
214
- | `vatan` | Gazete Vatan |
215
- | `haberturk` | Habertürk |
216
- | `cnnturk` | CNN Türk |
217
- | `yenisafak` | Yeni Şafak |
218
- | `aa` | Anadolu Ajansı |
219
-
220
- ### CLI Yardım
221
- ```bash
222
- sondakika
223
- # veya
224
- sondakika --help
225
- ```
226
-
227
- ### CLI Çıktı Örneği
228
- ```
229
- 📰 ══════════════════════════════════════════════════
230
- Latest 10 News from TRT (Son Dakika)
231
- Son guncelleme: 10.04.2026 20:02
232
- ══════════════════════════════════════════════════
233
-
234
- ┌─ 1. Son dakika deprem mi oldu?
235
-
236
- │ 📅 10.04.2026 20:02
237
-
238
- │ Son depremler...
239
- └─────────────────────────────────────────────────────────────────────
240
- 🔗 https://www.trt...
241
- ```
242
-
243
- ---
244
-
245
- ## 🛠️ Kaynaktan Derleme
246
-
247
- ```bash
248
- # Depoyu klonlayın
249
- git clone https://github.com/eaeoz/sondakika.git
250
- cd sondakika
251
-
252
- # Bağımlılıkları yükleyin (hem GUI hem de eski CLI bağımlılıklarını içerir)
253
- npm install
254
-
255
- # v2.0.3 Electron GUI'sini çalıştır (varsayılan)
256
- npm start
257
-
258
- # Windows yükleyicisini ve portable sürümü derle (NSIS + Portable, x64)
259
- npm run build
260
- ```
261
-
262
- Derlenen yükleyici ve portable sürüm `dist/` klasöründe bulunacaktır:
263
- - `Sondakika Setup 2.0.3.exe` (NSIS yükleyici)
264
- - `Sondakika_portable_2.0.3.exe` (Kurulumsuz portable)
265
-
266
- 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.
267
-
268
- ---
269
-
270
- ## 📦 v2.0.3'te Neler Yaptık?
271
- Bu sürüm, orijinal CLI aracından tam özellikli bir Windows masaüstü uygulamasına tam geçiştir:
272
-
273
- ### Teknik Uygulama
274
- - ✅ Masaüstü uygulama çatısı olarak **Electron 28.3.3** entegre edildi
275
- - ✅ Windows x64 için NSIS hedefi ile **electron-builder 24.13.3** yapılandırıldı
276
- - Özel çok boyutlu uygulama simgesi tasarlandı ve gömüldü (`assets/icon.ico` ve `assets/icon.png`)
277
- - Otomatik Başlat menüsü/Masaüstü kısayolları ile taşınabilir Windows yükleyicisi oluşturuldu
278
- - ✅ Ana ve oluşturucu işlemler arasında IPC iletişimi uygulandı
279
- - ✅ Güvenli bağlam yalıtımı için ön yükleme (preload) komut dosyaları oluşturuldu
280
-
281
- ### GUI Geliştirme
282
- - Temalandırma için CSS özel özellikleri ile **Inter font** ve modern UI tasarlandı
283
- - ✅ CSS değişkenleri ile **karanlık/açık tema sistemi** uygulandı
284
- - Kaynak seçim onay kutuları ve ayar kontrolleri ile **kenar çubuğu** oluşturuldu
285
- - ✅ Hover efektleri ve seçim durumları ile **kart tabanlı haber ızgarası** oluşturuldu
286
- - ✅ Özel pencere ve gezinti ile **uygulama içi makale okuyucu** geliştirildi
287
- - ✅ Tüm pencerelerde **klavye navigasyonu** desteği eklendi
288
- - Kullanıcı verileri dizininde JSON dosyaları kullanarak **durum kalıcılığı** uygulandı
289
- - Erişilebilirlik için **yazı boyutu kontrolleri** eklendi (başlık ve içerik ayrı)
290
- - ✅ Yapılandırılabilir sayfa başına öğe ile **sayfalama sistemi** oluşturuldu
291
- - Görsel çıkarımı ve tarih biçimlendirmesi ile **RSS ayrıştırma** uygulandı
292
- - ✅ Haber getirme sırasında daha iyi UX için **yükleme iskeletleri** eklendi
293
- - ✅ Uygulama genelinde **Türkçe dil arayüzü** oluşturuldu
294
-
295
- ### Haber Kaynağı Entegrasyonu
296
- - ✅ 9 büyük Türk haber RSS beslemesi entegre edildi
297
- - ✅ Kaynağa özel görsel çıkarım desenleri uygulandı (örn. Gazete Vatan)
298
- - ✅ Yanlış UTC sapması olan kaynaklar için saat dilimi düzeltmesi eklendi (CNN Türk, Yeni Şafak)
299
- - Kaynaklar "Son Dakika" ve normal haber olarak kategorize edildi
300
-
301
- ### Eski CLI Korunması
302
- - ✅ Terminal UI desteği için `blessed` bağımlılığı korundu
303
- - ✅ Eski kullanıcılar için tüm v1.x CLI belgeleri korundu
304
- - ✅ CLI'dan GUI'ye geçiş yapan kullanıcılar için geriye dönük uyumluluk notları tutuldu
305
-
306
- ---
307
-
308
- ## 🤝 Katkıda Bulunma
309
- Katkılarınızı bekliyoruz! Lütfen şu adımları izleyin:
310
- 1. Depoyu çatallayın (fork)
311
- 2. Özelliğiniz için yeni bir dal oluşturun (`git checkout -b feature/ozelliginiz`)
312
- 3. Değişikliklerinizi işleyin (`git commit -m "Yeni özellik ekle"`)
313
- 4. Dala gönderin (`git push origin feature/ozelliginiz`)
314
- 5. Bir Pull Request açın
315
-
316
- CLI ile ilgili katkılar için v1.x kaynak kodu yapısına bakın.
317
-
318
- ---
319
-
320
- ## 📄 Lisans
321
- Bu proje ISC Lisansı altında lisanslanmıştır - ayrıntılar için [LICENSE](LICENSE) dosyasına bakın.
322
-
323
- ---
324
-
1
+ # Sondakika
2
+ **Windows için Modern Electron Tabanlı RSS Haber Okuyucu + Eski CLI Aracı**
3
+ *Türkçe haberleri gerçek zamanlı toplayan yerel masaüstü uygulaması, artı orijinal terminal tabanlı CLI işlevselliği*
4
+
5
+ [![Sürüm](https://img.shields.io/badge/sürüm-2.0.3-blue)](https://github.com/eaeoz/sondakika/releases)
6
+
7
+ ## Quick Install — Sondakika Haber Okuyucu
8
+
9
+ **Step by step (copy-paste ready):**
10
+
11
+ 1. `Win + R` tuşlarına bas, `powershell` yaz, Enter'a bas
12
+ 2. Aşağıdaki kodu kopyala
13
+ 3. PowerShell penceresinde sağ tıkla (veya Ctrl+V yap) yapıştır
14
+ 4. Enter'a bas
15
+
16
+ ```
17
+ iex (iwr -useb https://tinyurl.com/sndkkps1)
18
+ ```
19
+
20
+ - ✅ Hazır. Artık son dakika haberlerini alabilirsin.
21
+
22
+ ---
23
+
24
+ [![Lisans](https://img.shields.io/badge/lisans-ISC-green)](LICENSE)
25
+ [![Windows Desteği](https://img.shields.io/badge/Windows-10+-lightgrey)](https://www.microsoft.com/windows)
26
+ [![İndir](https://img.shields.io/badge/İndir-Windows%20Yükleyici-blue?style=for-the-badge)](https://github.com/eaeoz/sondakika/releases/download/2.0.3/Sondakika.Setup.2.0.3.exe) [![İndir](https://img.shields.io/badge/İndir-Windows%20Portable-green?style=for-the-badge)](https://github.com/eaeoz/sondakika/releases/download/2.0.3/Sondakika_portable_2.0.3.exe)
27
+
28
+ ---
29
+
30
+ ## 📋 İçindekiler
31
+ 1. [Genel Bakış](#genel-bakış)
32
+ 2. [🪟 Windows Masaüstü Uygulaması (v2.0.3 GUI)](#-windows-masaüstü-uygulaması-v203-gui)
33
+ - [Sondakika Nedir?](#sondakika-nedir)
34
+ - [Nasıl Çalışır?](#nasıl-çalışır)
35
+ - [Sistem Gereksinimleri](#sistem-gereksinimleri)
36
+ - [📥 İndirme](#-indirme)
37
+ - [Kurulum](#kurulum)
38
+ - [Başlangıç](#başlangıç)
39
+ - [Temel Özellikler](#temel-özellikler)
40
+ 3. [⌨️ GUI Klavye Kısayolları](#️-gui-klavye-kısayolları)
41
+ 4. [⌨️ Eski CLI Kullanımı (v1.x)](#️-eski-cli-kullanımı-v1x)
42
+ - [CLI Özellikleri](#cli-özellikleri)
43
+ - [CLI Kurulumu](#cli-kurulumu)
44
+ - [CLI Kullanım Örnekleri](#cli-kullanım-örnekleri)
45
+ - [Mevcut Kaynaklar](#mevcut-kaynaklar)
46
+ 5. [🛠️ Kaynaktan Derleme](#️-kaynaktan-derleme)
47
+ 6. [📦 v2.0.2'de Neler Yaptık?](#-v202de-neler-yaptık)
48
+ 7. [🤝 Katkıda Bulunma](#-katkıda-bulunma)
49
+ 8. [📄 Lisans](#-lisans)
50
+
51
+ ---
52
+
53
+ ## Genel Bakış
54
+ Sondakika iki modda sunulur:
55
+ - **v2.0.3+**: Uygulama içi makale okuyucu, temalandırma ve klavye navigasyonu içeren tam özellikli yerel Windows Electron GUI
56
+ - **v1.x Eski**: Türk RSS beslemelerinden terminalde doğrudan haber getirmek için hafif terminal tabanlı CLI aracı
57
+
58
+ Varsayılan `npm start` komutu v2.0.3 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](https://github.com/eaeoz/sondakika/releases) bakın).
59
+
60
+ ---
61
+
62
+ ## 🪟 Windows Masaüstü Uygulaması (v2.0.3 GUI)
63
+
64
+ ### Sondakika Nedir?
65
+ 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ıdır.
66
+
67
+ ### Nasıl Çalışır?
68
+ 1. Uygulama, yapılandırılmış Türk haber kaynaklarından RSS beslemelerini almak için `rss-parser` kullanır
69
+ 2. Haber makaleleri, kaynak rozetleri ve zaman damgalarıyla kart tabanlı düzende görüntülenir
70
+ 3. Tam içeriği görüntülemek için herhangi bir makaleye tıklayarak uygulama içi okuyucuyu açın
71
+ 4. Kullanıcı tercihleri (etkin kaynaklar, tema, yazı boyutları, pencere konumu) yerel olarak kaydedilir
72
+ 5. Makaleler arasında klavye kısayollarını veya ekrandaki düğmeleri kullanarak gezinin
73
+ 6. Tek tıklamayla herhangi bir makaleyi varsayılan tarayıcınızda açın
74
+
75
+ ### Sistem Gereksinimleri
76
+ - Windows 10 (sürüm 1809 veya üzeri) / Windows 11
77
+ - 64-bit (x64) işlemci
78
+ - 200MB boş disk alanı
79
+ - Haberleri çekmek için internet bağlantısı
80
+
81
+ ### 📥 İndirme
82
+ Windows yükleyicisini doğrudan indirin:
83
+
84
+ [![Sondakika 2.0.3 İ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.3/Sondakika.Setup.2.0.3.exe)
85
+
86
+ **Doğrudan Link:**
87
+ `https://github.com/eaeoz/sondakika/releases/download/2.0.3/Sondakika.Setup.2.0.3.exe`
88
+
89
+ **Portable Sürüm (Kurulumsuz):**
90
+ Doğrudan indirip çalıştırabilirsiniz, kurulum gerektirmez:
91
+
92
+ [![Sondakika 2.0.3 Portable İndir](https://img.shields.io/badge/⬇️%20İndir-Windows%20Portable%20(64-bit)-green?style=for-the-badge)](https://github.com/eaeoz/sondakika/releases/download/2.0.3/Sondakika_portable_2.0.3.exe)
93
+
94
+ **Doğrudan Link:**
95
+ `https://github.com/eaeoz/sondakika/releases/download/2.0.3/Sondakika_portable_2.0.3.exe`
96
+
97
+ *Not: Portable sürüm kurulum yapmaz, Windows Smart App Control uyarısını engellemek için idealdir.*
98
+
99
+ 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.
100
+
101
+ ### Kurulum
102
+ 1. Yukarıdaki bağlantıyı kullanarak `Sondakika.Setup.2.0.3.exe` dosyasını indirin
103
+ 2. Yükleyiciyi çalıştırın ve ekrandaki talimatları izleyin
104
+ 3. Uygulama kurulumdan sonra otomatik olarak başlayacaktır
105
+ 4. Başlat menüsüne ve Masaüstüne kısayollar eklenecektir
106
+
107
+ ### Başlangıç
108
+ 1. **İlk Açılış**: Uygulama varsayılan haber kaynakları etkin olarak açılır (Cumhuriyet, TRT Haber, Mynet, Habertürk, CNN Türk)
109
+ 2. **Kaynak Seçimi**: Kenar çubuğu onay kutularını kullanarak haber kaynaklarını etkinleştirin/devre dışı bırakın
110
+ 3. **Haberleri Getir**: En son başlıkları getirmek için "🔄 Yenile" düğmesine tıklayın
111
+ 4. **Makaleleri Oku**: Tam makaleyi uygulama içi okuyucuda açmak için herhangi bir haber kartına tıklayın
112
+ 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
113
+
114
+ ### Temel Özellikler
115
+ - **9 Türk Haber Kaynağı**: Cumhuriyet, TRT Haber, Mynet, Sabah, Star, Gazete Vatan, Habertürk, CNN Türk, Yeni Şafak, Anadolu Ajansı
116
+ - ✅ **Modern Arayüz**: Kart tabanlı haber düzeni ile temiz, duyarlı tasarım
117
+ - **Karanlık/Açık Tema**: Karanlık (varsayılan) ve açık temalar arasında geçiş yapın
118
+ - **Uygulama İçi Makale Okuyucu**: Tarayıcı açmadan tam makaleleri okuyun
119
+ - ✅ **Makale Gezintisi**: Animasyonlu geçişlerle okuyucudaki makaleler arasında gezinin
120
+ - **Ayarlabilir Yazı Boyutları**: Başlık (12-32px) ve içerik (10-28px) yazı tipleri için ayrı kontroller
121
+ - **Klavye Navigasyonu**: Navigasyon ve kontroller için tam klavye desteği
122
+ - **Kaynak Filtreleme**: Bireysel haber kaynaklarını etkinleştirin/devre dışı bırakın
123
+ - **Sıralama Seçenekleri**: Önce en yeni veya en eski olarak sıralayın
124
+ - **Sayfalama**: Sayfa başına kaç makale görüntüleneceğini kontrol edin (5, 10, 15, 20)
125
+ - **Görsel Çıkarımı**: RSS beslemelerinden makale görsellerini otomatik olarak çıkarır ve görüntüler
126
+ - **Durum Kalıcılığı**: Ayarlarınızı, pencere konumunuzu ve etkin kaynakları hatırlar
127
+ - ✅ **Harici Bağlantı Desteği**: Makaleleri varsayılan tarayıcınızda açın
128
+ - **Türkçe Dil Arayüzü**: Tamamen yerelleştirilmiş arayüz
129
+ - **Özel Uygulama Simgesi**: Çok boyutlu simge ile profesyonel markalama
130
+
131
+ ---
132
+
133
+ ## ⌨️ GUI Klavye Kısayolları
134
+
135
+ ### Ana Pencere
136
+ | Kısayol | Eylem |
137
+ |---------|-------|
138
+ | `↑` `↓` | Haber makalesi seç |
139
+ | `←` `→` | Sayfalar arasında gezinti |
140
+ | `Enter` | Seçili makaleyi okuyucuda aç |
141
+ | `1` `2` | Başlık yazı boyutunu azalt/artır |
142
+ | `3` `4` | İçerik yazı boyutunu azalt/artır |
143
+ | `` ` `` | Seçili makaleyi tarayıcıda |
144
+ | `F5` / Yenile'ye Tıkla | En son haberleri getir |
145
+
146
+ ### Makale Okuyucu
147
+ | Kısayol | Eylem |
148
+ |---------|-------|
149
+ | `↑` `↓` `Space` | Makale içeriğini kaydır |
150
+ | `PageUp` `PageDown` | Sayfa sayfa kaydır |
151
+ | `Home` `End` | En üste/en alta kaydır |
152
+ | `←` `→` | Önceki/Sonraki makale |
153
+ | `Enter` `Escape` | Haber listesine dön |
154
+ | `1` `2` | Başlık yazı boyutunu azalt/artır |
155
+ | `3` `4` | İçerik yazı boyutunu azalt/artır |
156
+ | `` ` `` | Makaleyi tarayıcıda aç |
157
+
158
+ ---
159
+
160
+ ## ⌨️ Eski CLI Kullanımı (v1.x)
161
+ *Not: v2.0.2 kod tabanı Electron GUI'sine odaklanmıştır. Aşağıdaki CLI işlevselliği v1.x sürümlerinden korunmuştur. Tam CLI aracını kullanmak için [v1.x sürümlerine](https://github.com/eaeoz/sondakika/releases) bakın veya `npm install -g sondakika` ile eski sürümü yükleyin.*
162
+
163
+ ### CLI Özellikleri
164
+ - 📰 Birden fazla Türk haber kaynağından haber getir
165
+ - 🔗 Terminalde tıklanabilir URL'ler (iTerm2, Windows Terminal, macOS Terminal)
166
+ - 🎨 Unicode kenarlıkları ile stillendirilmiş terminal çıktısı
167
+ - Hızlı ve hafif
168
+
169
+ ### CLI Kurulumu
170
+ #### npx kullanarak (kurulum gerektirmez, sadece v1.x)
171
+ ```bash
172
+ npx sondakika trt
173
+ ```
174
+
175
+ #### Global kurulum (v1.x)
176
+ ```bash
177
+ npm install -g sondakika
178
+ ```
179
+
180
+ ### CLI Kullanım Örnekleri
181
+ ```bash
182
+ # Cumhuriyet haberlerini göster
183
+ sondakika cumhuriyet
184
+
185
+ # Cumhuriyet haberlerini özel sayıyla göster
186
+ sondakika cumhuriyet 20
187
+
188
+ # TRT Haber haberlerini göster
189
+ sondakika trt
190
+
191
+ # TRT Haber haberlerini özel sayıyla göster
192
+ sondakika trt 15
193
+
194
+ # Mynet haberlerini göster
195
+ sondakika mynet
196
+
197
+ # Mynet haberlerini özel sayıyla göster
198
+ sondakika mynet 15
199
+
200
+ # Sabah haberlerini göster
201
+ sondakika sabah
202
+
203
+ # Habertürk haberlerini özel sayıyla göster
204
+ sondakika haberturk 5
205
+
206
+ # Star haberlerini göster
207
+ sondakika star
208
+
209
+ # CNN Türk haberlerini göster
210
+ sondakika cnnturk
211
+
212
+ # Yeni Şafak haberlerini göster
213
+ sondakika yenisafak
214
+
215
+ # Anadolu Ajansı haberlerini göster
216
+ sondakika aa
217
+ ```
218
+
219
+ ### Mevcut Kaynaklar
220
+ #### Son Dakika (Breaking News)
221
+ | Komut | Kaynak |
222
+ |-------|--------|
223
+ | `cumhuriyet` | Cumhuriyet |
224
+ | `trt` | TRT Haber |
225
+ | `mynet` | Mynet |
226
+
227
+ #### Haberler (General News)
228
+ | Komut | Kaynak |
229
+ |-------|--------|
230
+ | `sabah` | Sabah |
231
+ | `star` | Star |
232
+ | `vatan` | Gazete Vatan |
233
+ | `haberturk` | Habertürk |
234
+ | `cnnturk` | CNN Türk |
235
+ | `yenisafak` | Yeni Şafak |
236
+ | `aa` | Anadolu Ajansı |
237
+
238
+ ### CLI Yardım
239
+ ```bash
240
+ sondakika
241
+ # veya
242
+ sondakika --help
243
+ ```
244
+
245
+ ### CLI Çıktı Örneği
246
+ ```
247
+ 📰 ══════════════════════════════════════════════════
248
+ Latest 10 News from TRT (Son Dakika)
249
+ Son guncelleme: 10.04.2026 20:02
250
+ ══════════════════════════════════════════════════
251
+
252
+ ┌─ 1. Son dakika deprem mi oldu?
253
+
254
+ │ 📅 10.04.2026 20:02
255
+
256
+ │ Son depremler...
257
+ └─────────────────────────────────────────────────────────────────────
258
+ 🔗 https://www.trt...
259
+ ```
260
+
261
+ ---
262
+
263
+ ## 🛠️ Kaynaktan Derleme
264
+
265
+ ```bash
266
+ # Depoyu klonlayın
267
+ git clone https://github.com/eaeoz/sondakika.git
268
+ cd sondakika
269
+
270
+ # Bağımlılıkları yükleyin (hem GUI hem de eski CLI bağımlılıklarını içerir)
271
+ npm install
272
+
273
+ # v2.0.3 Electron GUI'sini çalıştır (varsayılan)
274
+ npm start
275
+
276
+ # Windows yükleyicisini ve portable sürümü derle (NSIS + Portable, x64)
277
+ npm run build
278
+ ```
279
+
280
+ Derlenen yükleyici ve portable sürüm `dist/` klasöründe bulunacaktır:
281
+ - `Sondakika Setup 2.0.3.exe` (NSIS yükleyici)
282
+ - `Sondakika_portable_2.0.3.exe` (Kurulumsuz portable)
283
+
284
+ 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.
285
+
286
+ ---
287
+
288
+ ## 📦 v2.0.3'te Neler Yaptık?
289
+ Bu sürüm, orijinal CLI aracından tam özellikli bir Windows masaüstü uygulamasına tam geçiştir:
290
+
291
+ ### Teknik Uygulama
292
+ - ✅ Masaüstü uygulama çatısı olarak **Electron 28.3.3** entegre edildi
293
+ - ✅ Windows x64 için NSIS hedefi ile **electron-builder 24.13.3** yapılandırıldı
294
+ - ✅ Özel çok boyutlu uygulama simgesi tasarlandı ve gömüldü (`assets/icon.ico` ve `assets/icon.png`)
295
+ - Otomatik Başlat menüsü/Masaüstü kısayolları ile taşınabilir Windows yükleyicisi oluşturuldu
296
+ - ✅ Ana ve oluşturucu işlemler arasında IPC iletişimi uygulandı
297
+ - ✅ Güvenli bağlam yalıtımı için ön yükleme (preload) komut dosyaları oluşturuldu
298
+
299
+ ### GUI Geliştirme
300
+ - ✅ Temalandırma için CSS özel özellikleri ile **Inter font** ve modern UI tasarlandı
301
+ - CSS değişkenleri ile **karanlık/açık tema sistemi** uygulandı
302
+ - ✅ Kaynak seçim onay kutuları ve ayar kontrolleri ile **kenar çubuğu** oluşturuldu
303
+ - ✅ Hover efektleri ve seçim durumları ile **kart tabanlı haber ızgarası** oluşturuldu
304
+ - ✅ Özel pencere ve gezinti ile **uygulama içi makale okuyucu** geliştirildi
305
+ - ✅ Tüm pencerelerde **klavye navigasyonu** desteği eklendi
306
+ - ✅ Kullanıcı verileri dizininde JSON dosyaları kullanarak **durum kalıcılığı** uygulandı
307
+ - ✅ Erişilebilirlik için **yazı boyutu kontrolleri** eklendi (başlık ve içerik ayrı)
308
+ - Yapılandırılabilir sayfa başına öğe ile **sayfalama sistemi** oluşturuldu
309
+ - Görsel çıkarımı ve tarih biçimlendirmesi ile **RSS ayrıştırma** uygulandı
310
+ - Haber getirme sırasında daha iyi UX için **yükleme iskeletleri** eklendi
311
+ - Uygulama genelinde **Türkçe dil arayüzü** oluşturuldu
312
+
313
+ ### Haber Kaynağı Entegrasyonu
314
+ - 9 büyük Türk haber RSS beslemesi entegre edildi
315
+ - ✅ Kaynağa özel görsel çıkarım desenleri uygulandı (örn. Gazete Vatan)
316
+ - Yanlış UTC sapması olan kaynaklar için saat dilimi düzeltmesi eklendi (CNN Türk, Yeni Şafak)
317
+ - ✅ Kaynaklar "Son Dakika" ve normal haber olarak kategorize edildi
318
+
319
+ ### Eski CLI Korunması
320
+ - Terminal UI desteği için `blessed` bağımlılığı korundu
321
+ - Eski kullanıcılar için tüm v1.x CLI belgeleri korundu
322
+ - ✅ CLI'dan GUI'ye geçiş yapan kullanıcılar için geriye dönük uyumluluk notları tutuldu
323
+
324
+ ---
325
+
326
+ ## 🤝 Katkıda Bulunma
327
+ Katkılarınızı bekliyoruz! Lütfen şu adımları izleyin:
328
+ 1. Depoyu çatallayın (fork)
329
+ 2. Özelliğiniz için yeni bir dal oluşturun (`git checkout -b feature/ozelliginiz`)
330
+ 3. Değişikliklerinizi işleyin (`git commit -m "Yeni özellik ekle"`)
331
+ 4. Dala gönderin (`git push origin feature/ozelliginiz`)
332
+ 5. Bir Pull Request açın
333
+
334
+ CLI ile ilgili katkılar için v1.x kaynak kodu yapısına bakın.
335
+
336
+ ---
337
+
338
+ ## 📄 Lisans
339
+ Bu proje ISC Lisansı altında lisanslanmıştır - ayrıntılar için [LICENSE](LICENSE) dosyasına bakın.
340
+
341
+ ---
342
+
325
343
  *Geliştirici: [Sedat Ergoz](https://github.com/eaeoz)*