Skip to content

A lightweight, native macOS RSS Reader application built with Swift. Stay up-to-date with your favorite news sources, blogs, and websites through a clean, intuitive interface that lives in your menu bar.

License

Notifications You must be signed in to change notification settings

AlbertoBarrago/RSS-Reader

Repository files navigation

RSS Reader

GitHub last commit GitHub tag (latest by date) GitHub repo size GitHub stars

A lightweight, native macOS RSS Reader application built with Swift. Stay up-to-date with your favorite news sources, blogs, and websites through a clean, intuitive interface that lives in your menu bar.

RSS Reader Screenshot

Features

  • 📰 Clean Interface: Minimalist design focused on readability
  • Menu Bar Integration: Quick access without cluttering your dock
  • 🔄 Real-time Updates: Automatically fetches the latest articles
  • 🎯 Native macOS: Built specifically for macOS using Swift
  • 💾 Lightweight: Minimal resource usage and fast performance

Requirements

  • macOS 10.15+ (Catalina or later)
  • Xcode 12.0+ (for building from source)

Installation

Build from Source

  1. Clone the repository:
   git clone https://github.com/AlbertoBarrago/RSS-Reader.git
   cd RSS-Reader
  1. Open in xCode
  open RSSReader.xcodeproj
  1. Configure target: Select "My Mac" from the destination menu in Xcode Ensure you're targeting macOS (not iOS simulator)

  2. Build and run: Press Cmd + R or click the Run button For command-line builds, see RUN.md

Usage

  • Launch the app - it will appear in your menu bar
  • Click the RSS Reader icon in the menu bar
  • Add your favorite RSS feeds using the "+" button
  • Browse articles and click to read in your default browser
  • Use the refresh button to manually update feeds

Contributing

Contributions are welcome! Please feel free to:

  • 🐛 Report bugs by opening an issue
  • 💡 Suggest new features
  • 🔧 Submit pull requests

Development Setup

  • Fork the repository
  • Create a feature branch (git checkout -b feature/amazing-feature)
  • Commit your changes (git commit -m 'Add amazing feature')
  • Push to the branch (git push origin feature/amazing-feature)
  • Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

⭐ If you find this project useful, please consider giving it a star!

About

A lightweight, native macOS RSS Reader application built with Swift. Stay up-to-date with your favorite news sources, blogs, and websites through a clean, intuitive interface that lives in your menu bar.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published