# FeedTheMonkey

FeedTheMonkey is a desktop client for any server that implements the
[Greader API](https://github.com/theoldreader/api), such as
[FreshRSS](https://freshrss.org) or [Miniflux](https://miniflux.app).
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

```sh
cargo build --release
```

The binary is at `target/release/feedthemonkey`.

## Installing

```sh
sudo ./install.sh
```

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

```sh
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.