docs: add README with build and runtime dependencies
This commit is contained in:
parent
85b05a14bc
commit
ed10ba1310
1 changed files with 70 additions and 0 deletions
70
README.md
Normal file
70
README.md
Normal file
|
|
@ -0,0 +1,70 @@
|
||||||
|
# FeedTheMonkey
|
||||||
|
|
||||||
|
FeedTheMonkey is a desktop client for [Tiny Tiny RSS](https://tt-rss.org). It doesn't
|
||||||
|
work as a standalone feed reader — it connects to a TT-RSS server via the Fever/Greader
|
||||||
|
API 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.
|
||||||
Loading…
Add table
Add a link
Reference in a new issue