📡 Radar RSS

Real-time intelligent dynamic RSS news aggregator with Google Gemini AI curation, Windows and Linux desktop applications, 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.
• 🧩 Cross-Feed Story Clustering & Deduplication:
  • Automatically identifies and consolidates identical news events reported across multiple outlets (e.g. Reuters, The Verge, TechCrunch) into a unified story cluster.
  • Multi-signal similarity engine: token overlap, n-grams, named entity/number matching, action divergence protection (preventing false merges like "announces new iPhone" vs "raises iPhone price"), temporal decay, and canonical URL normalization.
  • Multi-source UI badge ("3 fontes"), expandable coverage drawer, and interactive source switcher inside the reader.
  • Consolidated multi-source AI executive briefings synthesizing all reporting viewpoints into a unified briefing without duplicates.
  • User-configurable clustering strategies (Balanced, Conservative, Aggressive) and time windows in Settings.
• 🧠 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 and Linux 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)

Linux (x64)

The Linux Desktop workflow builds the packages below as GitHub Actions artifacts for pull requests and manual runs. After Linux support is merged, pushing a vX.Y.Z tag also uploads them to GitHub Releases.

• AppImage: download radar-rss-X.Y.Z-x64.AppImage and run:

  chmod +x radar-rss-X.Y.Z-x64.AppImage
  ./radar-rss-X.Y.Z-x64.AppImage

  If FUSE is missing, install libfuse2 on Ubuntu 22.04 (libfuse2t64 on Ubuntu 24.04), or launch with --appimage-extract-and-run.
• Debian / Ubuntu: install radar-rss-X.Y.Z-amd64.deb:

  sudo apt install ./radar-rss-X.Y.Z-amd64.deb

  Launch Radar RSS from the application menu.

AppImage supports automatic updates when stored in a writable directory. For .deb, checking for updates opens the releases page so you can install the new package.

Start with the system uses XDG autostart. Linux closes the window normally by default; enable minimize-to-tray only when your desktop supports tray icons (GNOME may require an AppIndicator extension). Configure AI in the application, or put GEMINI_API_KEY=your_key in ${XDG_CONFIG_HOME:-~/.config}/Radar RSS/.env.

Build on Linux using Node.js 22 and npm:

npm ci
npm run build:linux

Both packages are generated in release/. Initial Linux support targets 64-bit Intel/AMD processors.

---

🚀 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:linux — Builds Linux x64 AppImage and Debian packages in release/.
• npm run test:desktop — Tests Linux and Windows autostart behavior.
• npm run publish:linux — Builds and uploads Linux packages to GitHub Releases.
• 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.