{"id":23592607,"url":"https://github.com/filipnet/rspamd-learn-helper","last_synced_at":"2026-05-07T11:31:32.337Z","repository":{"id":206861438,"uuid":"717855888","full_name":"filipnet/rspamd-learn-helper","owner":"filipnet","description":"Utility script for rspamd spam and ham training.","archived":false,"fork":false,"pushed_at":"2025-07-14T21:01:37.000Z","size":1253,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-15T02:06:20.464Z","etag":null,"topics":["bash-script","bayes","email-filtering","email-filters","filtering","ham","helper","learn","learning","linux","mail-server","rspamd","shell-script","spam","spam-filtering","train","training"],"latest_commit_sha":null,"homepage":"https://www.filipnet.de/rspamd-learn-helper","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/filipnet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-11-12T20:05:38.000Z","updated_at":"2025-07-14T21:01:39.000Z","dependencies_parsed_at":"2023-11-12T21:25:44.220Z","dependency_job_id":"58578b59-5e50-4a7b-8ddf-4a3e1ef82f2d","html_url":"https://github.com/filipnet/rspamd-learn-helper","commit_stats":null,"previous_names":["filipnet/rspamd-learn-helper"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/filipnet/rspamd-learn-helper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filipnet%2Frspamd-learn-helper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filipnet%2Frspamd-learn-helper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filipnet%2Frspamd-learn-helper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filipnet%2Frspamd-learn-helper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/filipnet","download_url":"https://codeload.github.com/filipnet/rspamd-learn-helper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filipnet%2Frspamd-learn-helper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32735080,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-07T02:14:30.463Z","status":"ssl_error","status_checked_at":"2026-05-07T02:14:29.405Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash-script","bayes","email-filtering","email-filters","filtering","ham","helper","learn","learning","linux","mail-server","rspamd","shell-script","spam","spam-filtering","train","training"],"created_at":"2024-12-27T08:14:55.326Z","updated_at":"2026-05-07T11:31:32.331Z","avatar_url":"https://github.com/filipnet.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![BSD License](https://img.shields.io/badge/license-BSD-blue.svg)](LICENSE)\n[![email-filtering](https://img.shields.io/badge/topic-email--filtering-brightgreen)](https://github.com/topics/email-filtering)\n[![spam-detection](https://img.shields.io/badge/topic-spam--detection-blue)](https://github.com/topics/spam-detection)\n[![mail-server](https://img.shields.io/badge/topic-mail--server-lightgrey)](https://github.com/topics/mail-server)\n\n# rspamd-learn-helper\nUtility script for rspamd spam and ham training.\n\n## Description\n\u003cimg src=\"images/logo-rspamd-learn-helper.png\" alt=\"Logo)\" align=\"right\" width=\"300\" height=\"auto\"/\u003e\n\nThe `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.\n\n**How it Works:**\n- Users create specific folders such as \".TrainingSpam\" and \".TrainingHam\" in their mail directories.\n- The script searches for these user-defined training folders within specified directories.\n- Upon finding a training folder, the script executes the appropriate `rspamc learn` command, training rspamd for improved spam detection.\n\n**Key Features:**\n- **User Contribution:** Any mail user can contribute to the improvement of spam filtering by creating designated training folders.\n- **Automated Training:** The script automates the training process, reducing the manual effort required to enhance rspamd's filter accuracy.\n- **Flexible Configuration:** Easily configure and customize the script to fit your mail server's directory structure.\n\n## Installation\n### Prerequisites\nBefore using the script, ensure that the following prerequisites are met:\n- [rspamd](https://rspamd.com/) is installed on your system.\n- The `rspamc` command-line utility is available.\n\n### Steps\n1. Clone the repository to your local machine:\n    ```bash\n    git clone https://github.com/filipnet/rspamd-learn-helper.git\n    ```\n\n2. Change into the project directory:\n    ```bash\n    cd rspamd-learn-helper\n    ```\n\n3. Ensure the script has execute permissions:\n    ```bash\n    chmod +x rspamd-learn-helper.sh\n    ```\n\n## Usage\n1. Run the script with the following command:\n    ```bash\n    ./rspamd-learn-helper.sh\n    ```\n\n2. The script will check if rspamd and rspamc are installed. If not, it will display an error message and exit.\n\n3. If rspamd and rspamc are installed, the script will proceeding to search for training folders in user directories.\n\n4. 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.\n\n## Scheduled Task\nFor automated training, consider scheduling the script as a recurring task using tools like cron.\n\nExample of running the script every day at 3 AM:\n```bash\n0 3 * * * /path/to/rspamd-learn-helper/rspamd-learn-helper.sh \u003e/dev/null 2\u003e\u00261\n```\n\n## Contributions\nContributions to this project are welcome! Whether you want to add features, fix bugs, or improve documentation, feel free to submit a pull request.\n\n## License\nThis project is licensed under the BSD 3-Clause \"New\" or \"Revised\" License, take a look at LICENSE for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffilipnet%2Frspamd-learn-helper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffilipnet%2Frspamd-learn-helper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffilipnet%2Frspamd-learn-helper/lists"}