- 🖥️ Cross-Platform: Native desktop app for Windows, macOS, and Linux
- 🌐 Auto-Translation: Translate article titles and content using translate service or AI
- 🔍 Smart Feed Discovery: Automatically discover new feeds from friend links and related sources
- ⭐ Favorites & Reading Tracking: Save articles and track read/unread status
- 📝 Article Summarization: Generate article summaries using local TF-IDF/TextRank algorithms or AI
- 🎨 Modern UI: Clean, responsive interface with dark mode support
- 📦 OPML Import/Export: Easy migration from other RSS readers
- ⌨️ Keyboard Shortcuts: Boost productivity with customizable keyboard shortcuts for quick navigation and actions
- 📋 Smart Filtering Rules: Automate feed organization with powerful custom rules
- 🏭 Custom Automation Scripts: Support for running user-defined automation scripts to fetch feeds
Download the latest installer for your platform from the Releases page:
- Windows:
MrRSS-{version}-windows-amd64-installer.exe/MrRSS-{version}-windows-arm64-installer.exe - macOS:
MrRSS-{version}-darwin-universal.dmg - Linux:
MrRSS-{version}-linux-amd64.AppImage/MrRSS-{version}-linux-arm64.AppImage
Click to expand the build from source guide
Before you begin, ensure you have the following installed:
Linux only: You also need to install system dependencies:
# Ubuntu/Debian
sudo apt-get install libgtk-3-dev libwebkit2gtk-4.1-dev gcc pkg-config
# For older Ubuntu versions (before 24.04), use:
# sudo apt-get install libgtk-3-dev libwebkit2gtk-4.0-dev gcc pkg-config-
Clone the repository
git clone https://github.com/WCY-dt/MrRSS.git cd MrRSS -
Install frontend dependencies
cd frontend npm install cd ..
-
Build the application
# Using Makefile (recommended) make build # Or manually with wails (requires -skipbindings flag) wails build -skipbindings
The executable will be created in the
build/bindirectory. -
Run the application
- Windows:
build/bin/MrRSS.exe - macOS:
build/bin/MrRSS.app - Linux:
build/bin/MrRSS
- Windows:
MrRSS stores all user data (database, settings) in platform-specific directories:
- Windows:
%APPDATA%\MrRSS\(e.g.,C:\Users\YourName\AppData\Roaming\MrRSS\) - macOS:
~/Library/Application Support/MrRSS/ - Linux:
~/.local/share/MrRSS/
This ensures your data persists across application updates and reinstalls.
Click to expand the development guide
Start the application with hot reloading:
wails devWe provide a Makefile with common development tasks (works on Linux/macOS/Windows with Make installed):
# Show all available commands
make help
# Run full check (lint + test + build)
make check
# Clean build artifacts
make clean
# Setup development environment
make setupCross-platform scripts are available in the scripts/ directory:
Linux/macOS:
# Run all checks
./scripts/check.sh
# Pre-release checks
./scripts/pre-release.shWindows (PowerShell):
# Run all checks
.\scripts\check.ps1
# Pre-release checks
.\scripts\pre-release.ps1This project uses pre-commit hooks to ensure code quality:
# Install hooks
pre-commit install
# Run on all files
pre-commit run --all-files# Backend tests
go test ./...
# Frontend tests
cd frontend
npm testWe welcome contributions! Please see our Contributing Guidelines for details.
Before contributing:
- Read the Code of Conduct
- Check existing issues or create a new one
- Fork the repository and create a feature branch
- Make your changes and add tests
- Submit a pull request
If you discover a security vulnerability, please follow our Security Policy.
This project is licensed under the GPLv3 License - see the LICENSE file for details.
- Built with Wails - Go + Web framework
- UI powered by Vue.js 3 and Tailwind CSS
- Icons from Phosphor Icons
- RSS parsing with gofeed
- Issues: GitHub Issues
- Repository: github.com/WCY-dt/MrRSS
Made with ❤️ by the MrRSS Team
⭐ Star us on GitHub if you find this project useful!