OpenSource-Hub
Y

yarr

SHA-256
3.8k stars·Developer Tools·SHA-256 checksum verified

A lightweight web-based RSS reader that works as a desktop app or self-hosted server. Single binary with embedded SQLite database.

Smart Download

Download Download Version

v2.6 · 5.8 MB

A minimal RSS reader that is one binary, cross-platform, works as a desktop app or self-hosted server.

Core Features

  • Single binary distribution, no dependencies
  • Embedded SQLite database
  • Desktop mode with system tray icon
  • Self-hosted server mode with auth, TLS, Fever API support
  • Cross-platform: Windows, macOS, Linux

What It Can't Do

  • macOS may require right-click -> Open to bypass Gatekeeper; Linux users need to run the install-linux.sh script for desktop integration. Self-hosted mode uses command-line flags (e.g., -auth) – set a strong password. No multi-user support.

Use Cases

  • Quick personal RSS setup
  • Desktop RSS reading without database hassle
  • Portable RSS tool for multiple machines

Detailed Introduction

yarr (yet another rss reader) is a minimal feed aggregator providing a clean reading experience. It runs as a single binary with an embedded SQLite database, requiring no external dependencies. You can use it as a desktop application with a system tray icon or deploy it as a personal self-hosted server (supports basic auth, TLS, and Fever API). Cross-platform support for Linux, macOS, and Windows. The name says it all – just another RSS reader, but done right with simplicity and portability in mind.

Troubleshooting & FAQ (1)

Troubleshooting
Why are images from RSS feeds not displaying in Yarr?

A bug prevented Yarr from rendering images provided via RSS <enclosure> tags. This was fixed in commit 0e3df33. Update Yarr to the latest version to get the fix. If you build from source, pull the latest changes.

GitHub Issue #284

Tags

rssfeed-readerself-hostedaggregatordesktop-app

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

Step 1: Download the appropriate zip from GitHub Releases (e.g., yarr_Windows_amd64_gui.zip)

4

Step 2: Extract and run the executable (Windows: double-click yarr.exe, macOS: move yarr.app to /Applications and open)

5

Step 3: Click the tray icon and select 'Open' to access the web UI. Import OPML or add feeds manually.

Install Guide
  1. Step 1: Download the appropriate zip from GitHub Releases (e.g., yarr_Windows_amd64_gui.zip)
  2. Step 2: Extract and run the executable (Windows: double-click yarr.exe, macOS: move yarr.app to /Applications and open)
  3. Step 3: Click the tray icon and select 'Open' to access the web UI. Import OPML or add feeds manually.
File Integrity

SHA-256 checksum verified

Checksum extracted from GitHub official Release page

SHA256 Checksum

842d124099c68d47804e623c40129dc9b4d2b46514a13d91a393a02c49e01f95

This checksum is extracted from the GitHub Release page. Verify file integrity after download.

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

Delete the extracted folder or executable. Remove config files if any (default location ~/.config/yarr). On macOS, delete yarr.app from Applications.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseMIT
Last Updated2026-06-27 04:35:05
GitHub RepositoryOfficial Website

Having issues? Check the FAQ below

1 FAQ

Similar Projects