explaingit

readyouapp/readyou

7,132KotlinAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A free open-source RSS reader app for Android with Material You design that collects articles from blogs and news sites into one place, with full-text view, read-aloud, and sync service support.

Mindmap

mindmap
  root((Read You))
    What it does
      RSS feed reading
      Full article fetch
      Read aloud
    Tech Stack
      Kotlin
      Jetpack Compose
      Android
    Sync Services
      FreshRSS
      Fever protocol
      Google Reader API
    Use Cases
      Follow blogs
      News aggregation
      Offline reading
    Distribution
      F-Droid
      GitHub releases
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Subscribe to your favorite blogs and news sites and read all new articles in one app without visiting each site individually.

USE CASE 2

Import your existing RSS subscriptions from another reader using the OPML format without losing your feeds.

USE CASE 3

Connect the app to a self-hosted FreshRSS or Fever-compatible service to keep read status in sync across Android devices.

Tech stack

KotlinJetpack ComposeAndroidGradle

Getting it running

Difficulty · easy Time to first run · 5min
Free to use and modify under GPL v3, but any version you distribute must also be open-source under the same GPL v3 license.

In plain English

Read You is a free, open-source RSS reader for Android. RSS is a format that websites and blogs use to publish updates, so a reader app like this lets you subscribe to many sites and read all their new articles in one place, without visiting each site individually. The app follows Android's Material You design system, which means it picks up your phone's color scheme and applies it to the app's interface. The feature list in the README shows what is currently working: subscribing to RSS feeds, importing and exporting your subscriptions in the standard OPML format, receiving notifications when new articles arrive, an article readability mode that strips away clutter, a feature that fetches and displays the full original article text rather than a short excerpt, multiple account support, and a read-aloud function. An Android home screen widget is listed as a planned but not yet completed feature. For people who already use a self-hosted or third-party RSS sync service, the app connects to Fever, Google Reader protocol-compatible services, and FreshRSS. Support for more services such as Miniflux and Tiny Tiny RSS is noted as planned. You can download the app from GitHub releases, a Telegram channel, or F-Droid, an alternative Android app store that only carries open-source software. Nightly builds are available via GitHub Actions for those who want to test the latest changes. The app is built using Jetpack Compose, Android's modern interface toolkit, and the README includes steps for cloning and building it in Android Studio. Translation contributions are accepted through Weblate. The project is licensed under GPL v3.

Copy-paste prompts

Prompt 1
Add an RSS feed from a tech blog to Read You and configure it to notify me when new articles are published.
Prompt 2
Export my Read You subscriptions as an OPML file so I can import them into a different RSS reader app.
Prompt 3
Set up Read You to fetch and display the full article text instead of the short excerpt from the RSS feed.
Prompt 4
Connect Read You to my self-hosted FreshRSS server and sync my reading progress across multiple Android devices.
Open on GitHub → Explain another repo

← readyouapp on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.