https://github.com/ticky/feedsweeper
🧹 Automatically tidy up your RSS feed backlog
https://github.com/ticky/feedsweeper
Last synced: about 1 year ago
JSON representation
🧹 Automatically tidy up your RSS feed backlog
- Host: GitHub
- URL: https://github.com/ticky/feedsweeper
- Owner: ticky
- License: apache-2.0
- Created: 2024-09-14T20:32:21.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-07T14:33:37.000Z (about 1 year ago)
- Last Synced: 2025-04-07T15:35:02.776Z (about 1 year ago)
- Language: Rust
- Size: 313 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE-APACHE.txt
Awesome Lists containing this project
README
# FeedSweeper
🧹 Automatically tidy up your RSS feed backlog.
## About
FeedSweeper is a tool for [Feedbin](https://feedbin.com) intended to help keep your unread list clean. In specific, I wanted a more social media-like vibe for some of the higher frequency news feeds I follow, giving them a timeout before they're marked as read automatically. This is my solution.
## Installation
### Easy mode (macOS or Linux)
```sh
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/ticky/feedsweeper/releases/latest/download/feedsweeper-installer.sh | sh
```
### With cargo
```sh
cargo install feedsweeper
```
### From source
Clone this repository and run `cargo install --path .` inside it.
## Usage
To run FeedSweeper, you should specify the `FEEDBIN_USERNAME` and `FEEDBIN_PASSWORD` environment variables. Feedbin sadly doesn't have a supported method to give applications API keys or individual passwords, so this is your real password.
### On Linux with a `systemd` timer
For example, if your system uses `systemd` you may wish to create a systemd unit file, such as at `~/.config/systemd/user/feedsweeper.service`:
```ini
[Unit]
Description=Tidy up your RSS feed backlog
[Service]
ExecStart=%h/.cargo/bin/feedsweeper --tagged "High Frequency" --max-age 1w
```
Where "High Frequency" is the name of a Feedbin tag you've prepared for feeds you wish for this to apply to.
And a matching timer file at `~/.config/systemd/user/feedsweeper.timer`:
```ini
[Unit]
Description=Automatically tidy up your RSS feed backlog
[Timer]
OnCalendar=hourly
Persistent=true
[Install]
WantedBy=timers.target
```
Then you can set the necessary environment variables by running `systemctl edit --user feedsweeper`, which will open an editor. You should enter the variables like this:
```ini
[Service]
Environment=FEEDBIN_USERNAME=""
Environment=FEEDBIN_PASSWORD=""
```
Finally, run `systemctl start --user feedsweeper.timer` to enable the timer.