jeena/FeedTheMonkey
1
0
Fork 1
Code Issues Pull requests Projects Packages Wiki Activity Actions
No description
183 commits 8 branches 13 tags 26 MiB
Find a file
Jeena b49cc69c49 api: auto-detect Greader API path for Miniflux and FreshRSS 
Miniflux serves the Greader API at the server root while FreshRSS uses
/api/greader.php. Instead of hardcoding the FreshRSS suffix, try the
URL as-is first (works for Miniflux) and fall back to appending
/api/greader.php (works for FreshRSS). The user just enters the server
URL without needing to know the API path.
2026-03-21 11:57:19 +00:00
data data: add app icon, desktop entry, and install script 2026-03-21 03:14:15 +00:00
html ui: overhaul sidebar, add content filters and state improvements 2026-03-21 01:13:01 +00:00
src api: auto-detect Greader API path for Miniflux and FreshRSS 2026-03-21 11:57:19 +00:00
.gitignore app: implement Epics 2–10 2026-03-20 11:57:06 +00:00
.travis.yml Add deploy step 2019-03-31 10:25:10 +02:00
BACKLOG.md scaffold: Epic 1 — project scaffold 2026-03-20 11:22:19 +00:00
build.rs ui: overhaul sidebar, add content filters and state improvements 2026-03-21 01:13:01 +00:00
Cargo.lock feature: cache article images for offline reading 2026-03-21 01:19:49 +00:00
Cargo.toml feature: cache article images for offline reading 2026-03-21 01:19:49 +00:00
COPYING scaffold: Epic 1 — project scaffold 2026-03-20 11:22:19 +00:00
install.sh data: add app icon, desktop entry, and install script 2026-03-21 03:14:15 +00:00
README.md api: auto-detect Greader API path for Miniflux and FreshRSS 2026-03-21 11:57:19 +00:00

README.md

FeedTheMonkey

FeedTheMonkey is a desktop client for any server that implements the Greader API, such as FreshRSS or Miniflux. Just enter your server URL — the app detects the API path automatically. It doesn't work as a standalone feed reader — it connects to a server to fetch articles and sync read state.

This is version 3, rewritten in Rust with GTK4 and libadwaita.

Dependencies

Runtime

  • GTK 4 (gtk4)
  • libadwaita (libadwaita)
  • WebKitGTK 6 (webkitgtk-6.0)
  • GLib / GIO (glib-2.0, gio-2.0)

On Arch Linux: sudo pacman -S gtk4 libadwaita webkitgtk-6.0

Build

  • Rust toolchain (rustup / cargo)
  • blueprint-compiler — compiles .blp UI files to .ui
  • glib-compile-schemas — compiles GSettings schemas (part of glib2)
  • glib-compile-resources — compiles GResource bundles (part of glib2)

On Arch Linux: sudo pacman -S blueprint-compiler glib2

Building

cargo build --release

The binary is at target/release/feedthemonkey.

Installing

sudo ./install.sh

This installs the binary, icon, desktop entry, and GSettings schema to /usr/local. Set PREFIX to install elsewhere:

sudo PREFIX=/usr ./install.sh

Keyboard shortcuts

Key Action
j or → Next article
k or ← Previous article
Return Open in browser
r Reload
F11 Toggle fullscreen
Ctrl+W Quit
Ctrl++ Zoom in
Ctrl+- Zoom out
Ctrl+0 Reset zoom

License

Copyright 2015–2026 Jeena

FeedTheMonkey is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.