Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/simeononsecurity/docker-rss-display-web

A docker container that publishes an rss feed to a generated webpage
https://github.com/simeononsecurity/docker-rss-display-web

docker docker-compose docker-container docker-image dockerfile flask python python-script python3 rss rss-aggregator rss-feed rss-generator rss-reader

Last synced: 4 days ago
JSON representation

A docker container that publishes an rss feed to a generated webpage

Awesome Lists containing this project

README

        

# RSS Feed Display Docker Container

This Docker container is designed to fetch and display the latest posts from a specified RSS feed using Python, Flask, and feedparser.

[![Sponsor](https://img.shields.io/badge/Sponsor-Click%20Here-ff69b4)](https://github.com/sponsors/simeononsecurity) [![Docker Image CI](https://github.com/simeononsecurity/docker-rss-display-web/actions/workflows/docker-image.yml/badge.svg)](https://github.com/simeononsecurity/docker-rss-display-web/actions/workflows/docker-image.yml)

## Usage

1. Clone this repository:

```bash
git clone https://github.com/simeononsecurity/docker-rss-display-web
```

2. Build the Docker image:

```bash
docker build -t rss-display .
```

or pull it from [dockerhub](https://hub.docker.com/r/simeononsecurity/rss-display-web)

```bash
docker pull simeononsecurity/rss-display-web
```

3. Run the Docker container:

```bash
docker run -p 8080:80 --name rss-container rss-display
```

4. Visit [http://localhost:8080](http://localhost:8080) in your web browser to view the latest posts from the specified RSS feed.

## Configuration

To change the RSS feed source, modify the `RSS_FEED_URL` environment variable in the Dockerfile:

```Dockerfile
ENV RSS_FEED_URL=https://simeononsecurity.com/index.xml
```
or

Pass it in at run time.

```bash
docker run -p 8080:80 --name rss-container -e RSS_FEED_URL=https://example.com/rss.xml rss-display
```
## Dependencies

- Flask
- Werkzeug
- feedparser

These dependencies are listed in the `requirements.txt` file.

## Customization

Feel free to customize the Flask application (`app.py`) and HTML template (`templates/index.html`) to suit your needs. You can modify the number of displayed posts, the appearance of the webpage, and more.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

- [simeononsecurity.com](https://simeononsecurity.com)
- [simeononsecurity-rss.onrender.com](https://simeononsecurity-rss.onrender.com/)