A modern interface
for your FreshRSS

FriRSS connects to your FreshRSS server and reshapes how you read: three layouts, six themes, ten languages, and your articles offline on your phone.

Three layouts, plus full screen

Read next to the list in three columns, sort quickly in two, leaf through pictures in the grid, or give one article the whole screen. Each feed keeps its own layout.

Your articles, even without a network

Install FriRSS on your home screen like an app. Move between articles with a swipe, and prepare the last 30 days for offline reading, images included.

  • Installs from the browser
  • Swipe to move and refresh
  • 30 days of articles offline
See the mobile features

Six themes, 38 colours to adjust

Start from a built-in theme, then tune colours, text sizes and spacing. Save the result, export it and share it.

See the customisation options

Tune the interface,
down to each button

Change the list density, what each row shows, the buttons of the reading pane and of the bars. A hidden button stays in the command palette. Try it here.

Density
Options
Article action icons
Reading pane
List bar
Shortcut bar

Elsewhere in Preferences

  • Article order, newest or oldest first, feed by feed
  • A layout of its own for each feed
  • The view at launch: last view, All feeds or Unread
  • Mark as read on scroll
  • Size and format of grid cards
  • Your instance’s name and logo
  • Customisable keyboard shortcuts
  • The interface in ten languages
  • Counters for Favorites, Read later and labels: total, unread or both

What FriRSS adds to FreshRSS.

Read, sort and find things faster.

Fetches the full article

When a feed only sends an excerpt, Readability retrieves the whole text. You set it per feed.

Runs from the keyboard

⌘K or Ctrl+K opens feeds, tags and actions. Every shortcut can be changed.

Files with a long press

Put an article in Favorites or Read later, inside the sub-folders you create.

Summarises and translates, if you enable it

AI stays off until an administrator sets it up. A local model with Ollama or LM Studio works too.

And everything else

The four cards above show a few of them in detail.

Reading

  • Three columns, two columns or grid
  • Preview, standard or compact density
  • Full articles with Readability
  • YouTube videos on click
  • Random reading order

Organising

  • Favorites and read later
  • Nested colored tags
  • ⌘K command palette
  • Customisable keyboard shortcuts

Mobile and personalisation

  • Installable PWA, swipe navigation
  • 30 days of articles offline
  • Six themes, 38 colours, seven text sizes
  • Interface in ten languages
  • AI summaries and translation, 28 languages

Hosting

  • Several FreshRSS servers
  • Several accounts, OIDC sign-in
  • Built-in SQLite, optional Redis
The essential features

In your language, articles included

The interface comes in ten languages and follows your browser’s. With AI turned on, FriRSS also translates the whole article, title and body, into any of 28 languages: on demand, or as soon as it opens for the feeds you pick. The source text is one click away.

Article from a German feed

Works with your FreshRSS server

FreshRSS fetches and stores your feeds. FriRSS connects through its Google Reader API and takes care of reading, on every screen.

Installed in three steps

  1. Start the container with Docker, Compose or Unraid.
  2. Create your FriRSS account.
  3. Connect your FreshRSS server with its API password.
Follow the installation guide

FriRSS is an independent project with no official tie to FreshRSS. FreshRSS and its interface belong to their authors; it is reproduced here for comparison.

Common questions

Another question? Ask it in the GitHub discussions.

Join the community

Does FriRSS replace FreshRSS?

It replaces the reading interface, not the feed engine. FreshRSS continues to fetch and store your subscriptions and articles. FriRSS connects through its Google Reader API.

Do I need a FreshRSS instance?

Yes. You need a working FreshRSS instance with API access enabled and an API password set for your FreshRSS account.

Is FriRSS free?

FriRSS is free and open source under the MIT license. You provide the hosting. Optional AI providers may charge for their services.

Can I host it myself?

Yes. Official Docker images support amd64 and arm64. Docker Compose and Unraid Community Applications are available too.

Does it work on my phone?

Yes. The responsive interface works in a mobile browser, and its PWA can be installed on your home screen. Prepare articles while connected to read them offline. HTTPS is needed for PWA features outside localhost.

Do I have to use AI?

No. AI is optional and disabled until an administrator enables it. Reading, organizing and personalizing your feeds work without it.

Can I choose my AI provider?

Yes. FriRSS supports Anthropic and OpenAI-compatible providers, including OpenAI, OpenRouter, Ollama and LM Studio. Provider and model availability depends on your configuration.

Where can I get help?

Start with the official README. Use GitHub Discussions for questions and GitHub Issues for reproducible bugs or feature ideas. See the Resources page for direct links.

Your FriRSS, your rules.

Try the online demo, then install FriRSS at home. Free, open source, no subscription.

Like FriRSS?

A star on GitHub makes a difference.

Star FriRSS on GitHub