https://github.com/filipnet/rspamd-learn-helper

Utility script for rspamd spam and ham training.
https://github.com/filipnet/rspamd-learn-helper

bash-script bayes email-filtering email-filters filtering ham helper learn learning linux mail-server rspamd shell-script spam spam-filtering train training

Last synced: 15 days ago
JSON representation

Utility script for rspamd spam and ham training.

• Host: GitHub
• URL: https://github.com/filipnet/rspamd-learn-helper
• Owner: filipnet
• License: bsd-3-clause
• Created: 2023-11-12T20:05:38.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2023-11-12T21:22:49.000Z (about 1 year ago)
• Last Synced: 2024-01-25T18:37:08.361Z (12 months ago)
• Topics: bash-script, bayes, email-filtering, email-filters, filtering, ham, helper, learn, learning, linux, mail-server, rspamd, shell-script, spam, spam-filtering, train, training
• Language: Shell
• Homepage:
• Size: 111 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![BSD License](https://img.shields.io/badge/license-BSD-blue.svg)](LICENSE)

[![email-filtering](https://img.shields.io/badge/topic-email--filtering-brightgreen)](https://github.com/topics/email-filtering)

[![spam-detection](https://img.shields.io/badge/topic-spam--detection-blue)](https://github.com/topics/spam-detection)

[![mail-server](https://img.shields.io/badge/topic-mail--server-lightgrey)](https://github.com/topics/mail-server)

# rspamd-learn-helper

Utility script for rspamd spam and ham training.

## Description



The `rspamd-learn-helper` is a utility script designed to streamline the training process for SPAM and HAM filters in the [rspamd](https://rspamd.com/) email filtering system. It provides an easy and automated way to enhance the effectiveness of rspamd's spam detection by allowing users to actively contribute to the training process.

**How it Works:**

- Users create specific folders such as ".TrainingSpam" and ".TrainingHam" in their mail directories.

- The script searches for these user-defined training folders within specified directories.

- Upon finding a training folder, the script executes the appropriate `rspamc learn` command, training rspamd for improved spam detection.

**Key Features:**

- **User Contribution:** Any mail user can contribute to the improvement of spam filtering by creating designated training folders.

- **Automated Training:** The script automates the training process, reducing the manual effort required to enhance rspamd's filter accuracy.

- **Flexible Configuration:** Easily configure and customize the script to fit your mail server's directory structure.

## Installation

### Prerequisites

Before using the script, ensure that the following prerequisites are met:

- [rspamd](https://rspamd.com/) is installed on your system.

- The `rspamc` command-line utility is available.

### Steps

1. Clone the repository to your local machine:

    ```bash

    git clone https://github.com/filipnet/rspamd-learn-helper.git

    ```

2. Change into the project directory:

    ```bash

    cd rspamd-learn-helper

    ```

3. Ensure the script has execute permissions:

    ```bash

    chmod +x rspamd-learn-helper.sh

    ```

## Usage

1. Run the script with the following command:

    ```bash

    ./rspamd-learn-helper.sh

    ```

2. The script will check if rspamd and rspamc are installed. If not, it will display an error message and exit.

3. If rspamd and rspamc are installed, the script will proceeding to search for training folders in user directories.

4. The script will then display information about any found training folders, outputting in yellow. It will also execute the appropriate `rspamc learn` command for each found folder.

## Scheduled Task

For automated training, consider scheduling the script as a recurring task using tools like cron.

Example of running the script every day at 3 AM:

```bash

0 3 * * * /path/to/rspamd-learn-helper/rspamd-learn-helper.sh >/dev/null 2>&1

```

## Contributions

Contributions to this project are welcome! Whether you want to add features, fix bugs, or improve documentation, feel free to submit a pull request.

## License

This project is licensed under the BSD 3-Clause "New" or "Revised" License, take a look at LICENSE for details.