FreshRSS Cleaner

tool

Purpose

FreshRSS is an excellent self-hosted RSS aggregator, but over time, accumulated articles can slow down performance and consume storage. Manual cleanup is time-consuming and error-prone.

I built FreshRSS Cleaner to address these issues. It´s a CLI tool that allows to automatically archive articles based on user-defined rules.

Features

  • Rule-Based Cleanup: Define custom rules for article retention based on age, feed, or other criteria
  • Dry-Run Mode: Preview what will be deleted before making changes
  • Flexible Configuration: YAML-based configuration for easy customization

Use Cases

  • Automate article cleanup in scheduled cron jobs
  • Maintain optimal FreshRSS database size
  • Keep only relevant articles based on custom retention policies
  • Free up disk space on self-hosted instances

Technical Implementation

Built with Go for performance and cross-platform compatibility. Leverages the FreshRSS API for efficient data access and manipulation.

Technologies & Tools

Golang