{"id":16179775,"url":"https://github.com/bep/alfn","last_synced_at":"2025-07-23T16:34:05.383Z","repository":{"id":57553064,"uuid":"45481971","full_name":"bep/alfn","owner":"bep","description":"Aggregated Latest Filtered News","archived":false,"fork":false,"pushed_at":"2017-02-17T16:48:06.000Z","size":19,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-07T11:47:33.789Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bep.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}},"created_at":"2015-11-03T17:05:48.000Z","updated_at":"2025-02-23T15:59:45.000Z","dependencies_parsed_at":"2022-09-26T18:51:41.014Z","dependency_job_id":null,"html_url":"https://github.com/bep/alfn","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bep/alfn","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bep%2Falfn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bep%2Falfn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bep%2Falfn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bep%2Falfn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bep","download_url":"https://codeload.github.com/bep/alfn/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bep%2Falfn/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266714202,"owners_count":23973082,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-10-10T05:43:59.993Z","updated_at":"2025-07-23T16:34:05.300Z","avatar_url":"https://github.com/bep.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# alfn \n\n[![GoDoc](https://godoc.org/github.com/bep/alfn?status.svg)](https://godoc.org/github.com/bep/alfn)\n\n**alfn** (Aggregated Latest Filtered News) is a great little tool to create your own RSS feed about only the stuff you´re really interested in! Just configure it with the feeds to watch and what to watch for, and just sit back and wait for the updates. Oh, and it supports hotreloading configuration changes!\n\n[![Build Status](https://travis-ci.org/bep/alfn.svg)](https://travis-ci.org/bep/alfn)\n\n## Install\n\nThe easiest way to install the binary is via `go get`:\n\n``` bash\ngo get github.com/bep/alfn\n```\n\nThen run it with the `-h` flag to see the options available:\n\n```\nalfn -h\n```\n\n## Configure\n\n`alfn` looks, by default, for configuration named either `config.toml`,  `config.yaml` or  `config.json` in either `$HOME/.alfn` or `/etc/alfn/`. The config file to use can also be set in the `--config` flag.\n\nBelow is an imaginary `liverpool-feed.toml` -- a feed about the Premier League football club Liverpool:\n\n```\nfeeds = [\n \t\"http://www.telegraph.co.uk/sport/football/teams/liverpool/rss\",\n\t\"http://feeds.bbci.co.uk/sport/0/football/premier-league/rss.xml\",\n\t\"http://www.theguardian.com/football/premierleague/rss\"\n]\n\n\n[[matchers]]\n# If it doesn't contain any of these, stop looking.\n# Note: The search also includes the RSS URL\npattern=\"football|premier-?\\\\s?league\"\nmatchBreaker=true\n \n[[matchers]]\n# Beatles was from Liverpool, but have little to do with the football team, so skip those.\npattern=\"Beatles\"\nmatchBreaker=true\nnegate=true\n\n# The matcher(s) below decide what to include. Any article matching any of the \n# regular expressions will be added to the feed.\n# Add more matchers sections as needed.\n[[matchers]]\npattern=\"Liverpool|J(u|ü)rgen (Norbert)? Klopp\"\n\n[[matchers]]\npattern=\"Joe Gomez|Philippe Coutinho|Simon Mignolet\"\n\n[feed]\ntitle=\"My Feed About Liverpool FC\"\ndescription=\"An RSS feed about the great football team!\"\nlink=\"\" # Defaults to the http://\u003cserver\u003e:\u003cport\u003e\nlanguageCode=\"EN-us\"\ncopyright=\"2015 @ yourname\"\nmaxItems=20\n[feed.author]\nname=\"Your Name\"\nemail=\"yourname@yourname.com\"\n```\n\nThen start your server pointing to the config file above:\n\n```bash\nalfn --config=/path/to/config/liverpool-feed.toml\n\nUsing config file: /path/to/config/liverpool-feed.toml\n\nStarting server on http://127.0.0.1:1926 ...\n\n2 filtered item(s) in http://feeds.bbci.co.uk/sport/0/football/premier-league/rss.xml\n1 filtered item(s) in http://www.theguardian.com/football/premierleague/rss\n17 filtered item(s) in http://www.telegraph.co.uk/sport/football/teams/liverpool/rss\n\n```\n\n## Credits\n\nThe best open source projects lean lazily on the great work of others:\n\n* [go-pkg-rss](https://github.com/jteeuwen/go-pkg-rss)\n* [Graceful](https://github.com/tylerb/graceful)\n* [Cobra](https://github.com/spf13/cobra)\n* [Viper](https://github.com/spf13/viper)\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbep%2Falfn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbep%2Falfn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbep%2Falfn/lists"}