📡 Radar RSS

Real-time intelligent dynamic RSS news aggregator with Google Gemini AI curation, Windows desktop application, and native Android app support.

English • Português (Brasil)

📥 Download App • ✨ Key Features • 🚀 Getting Started • 🤖 AI Configuration • 🔄 Auto-Updates

---

📖 About the Project

Radar RSS monitors multiple news portals and RSS feeds in real time, automatically organizing articles into modular, customizable category blocks (such as Headlines, Technology, Finance & Business, World News, Gaming & Entertainment, and custom topics).

Powered by Google Gemini Artificial Intelligence, Radar RSS synthesizes executive bullet-point summaries, extracts key takeaways, evaluates urgency for instant breaking news alerts, and translates foreign feeds on the fly — eliminating clutter and saving you hours of reading time.

---

✨ Key Features

• ⚡ Real-Time Feed Aggregation: High-throughput async ingestion of national and international RSS/Atom feeds with continuous background updates.
• 🧠 Smart AI Curation (Google Gemini):
  • Instant executive bullet summaries per topic or article.
  • Contextual urgency evaluation with automatic Breaking News badges and sound alerts.
  • Multi-language translation and synthesis for global articles.
• 🖼️ Smart Image Extraction (SafeImage): Robust parsing for media:content, media:thumbnail, enclosure, and embedded HTML <img> elements with relative URL normalization, tracker pixel filtering (1x1 blocking), and graceful visual fallback placeholders.
• 🖥️ Windows Desktop App: High-performance native Electron window with titlebar integration, keyboard shortcuts, and background tray support.
• 📱 Native Android Mobile App: Seamless touch experience built with Capacitor, featuring pull-to-refresh gestures, haptic feedback, theme synchronization, and Text-to-Speech (TTS).
• 🔄 Seamless Auto-Updates: Built-in background update engine powered by official GitHub Releases.
• 🎨 Modern & Adaptive UI:
  • Dark and Light mode themes with custom accent color palettes (Amber, Emerald, Cyan, Violet, Pink, etc.).
  • Flexible block layouts: Hero Highlights, Responsive Grid, Compact Cards, and Editorial Lists.
  • Distraction-free Focus Reader Mode with adjustable typography and font scaling.

---

📥 Download & Installation (Windows & Android)

You can download pre-compiled releases directly from the GitHub Releases page:

Platform	Version	Description	Download Link
🪟 Windows	💿 Official Installer	Recommended. Installs shortcuts and receives silent auto-updates	Download Setup (.exe)
🪟 Windows	💼 Portable Edition	Standalone single executable. Runs instantly without installation	Download Portable (.exe)
📱 Android	📦 Native APK	Signed native mobile app for Android smartphones and tablets	Download APK (.apk)

---

🚀 Getting Started Locally

Prerequisites

• Node.js (v18.0.0 or higher)
• npm or equivalent package manager
• Android Studio / Android SDK (Optional, only needed if compiling the Android APK locally)

Step-by-Step Setup

1. Clone the repository:

   git clone https://github.com/dznass-cmd/RadarRSS.git
   cd RadarRSS

2. Install dependencies:

   npm install

3. Configure Google Gemini API Key (Optional for AI features): Create a .env.local file in the root directory:

   GEMINI_API_KEY=your_gemini_api_key_here

4. Start the local development server:

   npm run dev

   Open your browser at http://localhost:3000.

5. Launch in Electron desktop mode:

   npm run desktop

6. Build and synchronize with Android (Capacitor):

   npm run build:android
   npm run open:android

---

🤖 AI Configuration (Google Gemini)

Radar RSS uses the modern official @google/genai SDK:

1. Grab a free API key at Google AI Studio.
2. Development: Add GEMINI_API_KEY=your_key to .env.local.
3. Production / Desktop: Place a .env file containing GEMINI_API_KEY=your_key in the same directory as Radar RSS.exe.

Note: If no API key is configured, all core RSS reading, live updating, custom feed management, and filtering features continue to work normally, with AI summary badges gracefully disabled.

---

🛠️ Architecture & Tech Stack

Layer	Technologies
Frontend	React 19, TypeScript, Vite, Tailwind CSS 4
Local Server	Node.js, Express, rss-parser
Artificial Intelligence	Google Gemini API (@google/genai)
Mobile App	Capacitor (Native Android runtime)
Desktop Packaging	Electron, electron-builder
Auto-Updater & CI/CD	electron-updater, GitHub Actions
Icons & Micro-interactions	Lucide React, Motion

---

📦 Available Scripts

• npm run dev — Starts the Express backend paired with Vite hot-module replacement.
• npm run build — Compiles the React web application and bundles the server into dist/.
• npm run desktop — Launches the application in an Electron desktop shell.
• npm run build:win — Compiles Windows executables (NSIS installer + portable .exe) inside release/.
• npm run build:android — Compiles web assets and synchronizes the native Android project.
• npm run publish:win — Packages and publishes a release asset directly to GitHub.
• npm run lint — Performs static type checking via TypeScript (tsc --noEmit).

---

🔄 Automatic Updates

The Windows desktop installer features background update verification via GitHub Releases:

1. When launched, the application checks the GitHub Releases API for newer semantic version tags.
2. If an update is detected, the installer downloads quietly in the background.
3. Once ready, an update banner offers a single-click restart to apply the latest build.

To publish a new version, simply increment version in package.json and push a vX.Y.Z tag — GitHub Actions will automatically compile and publish the Windows binaries.

---

📄 License

This project is open-source and released under the MIT License.