https://github.com/teddy-gustiaux/github-notifications-rss-feed
Application to generate an RSS feed from your GitHub notifications.
https://github.com/teddy-gustiaux/github-notifications-rss-feed
github python rss
Last synced: 10 months ago
JSON representation
Application to generate an RSS feed from your GitHub notifications.
- Host: GitHub
- URL: https://github.com/teddy-gustiaux/github-notifications-rss-feed
- Owner: teddy-gustiaux
- License: mit
- Created: 2020-02-07T01:12:07.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T03:41:05.000Z (about 3 years ago)
- Last Synced: 2025-04-11T02:09:08.627Z (10 months ago)
- Topics: github, python, rss
- Language: Python
- Homepage:
- Size: 26.4 KB
- Stars: 13
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# GitHub Notifications RSS Feed
## Warning note
This project is in an **alpha** release stage.
It is not recommended for production usage.
## What does it do?
This application generates an RSS feed from your GitHub notifications, that you can subscribe to in your favorite RSS reader application.
You no longer have to sort through all the notification emails GitHub is sending you- leverage the power of RSS!
## Prerequisites
Prerequisites:
- You will need to install Docker.
- You will need a [GitHub personal access token](https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line#creating-a-token) to be able to use their API.
The `notifications` scope is the only one required.
## Development
Steps:
- Clone this repository
- Setup your `.env` file (as per the `.env.template` file)
- You will have to build the Docker image for development once:
```
cd /path/to/github-notifications-rss-feed
make build_development
```
- Then you can edit the source code files.
Run the application with:
```
make run_development
```
## Self-hosting installation
In addition to the prerequisites of the previous, you will want to setup a cron job to run the application regularly.
For instance, setting up `crontab` to run it every 20 minutes:
```
*/20 * * * * /path/to/my/script.sh
```
For security reasons, use an user with minimum permissions.
It is recommended to set up the command in a separate shell script:
```
#!/bin/sh
docker run \
--rm \
--name ghnrf \
--env-file /path/to/.env \
--mount type=bind,source=/path/to/output,target=/app/output \
teddygustiaux/github-notifications-rss-feed:latest
```
You will want to serve your RSS file to the web (see below).
It is recommended to store your `.env` file in a different location with appropriate permissions as it contains personal credentials which should not be shared.
Finally, setup a custom sub-domain to access the generate RSS feed.
I recommend [Let's Encrypt](https://letsencrypt.org/) to get a free TLS certificate.
You may also likely want to protect your endpoint.
Basic authentication is a quick and basic (pun intended) way to do this.
The web has many resources explaining [how](https://httpd.apache.org/docs/2.4/programs/htpasswd.html) to do [this](https://docs.nginx.com/nginx/admin-guide/security-controls/configuring-http-basic-authentication/).
Your Nginx configuration could look like this:
```
server {
listen 80;
server_name ghnrf.example.com;
location / {
return 301 https://ghnrf.example.com$request_uri;
}
}
server {
listen 443 ssl;
server_name ghnrf.example.com;
server_tokens off;
access_log /var/log/nginx/access.log;
error_log /var/log/nginx/error.log;
auth_basic "Administrator's Area";
auth_basic_user_file /path/to/my.htpasswd;
ssl_certificate /etc/letsencrypt/live/ghnrf.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/ghnrf.example.com/privkey.pem;
root /path/to/output;
location = /feed.xml {
try_files /feed.xml =404;
}
location ^~ / {
return 404;
}
}
```
Your feed will be available at https://ghnrf.example.com/feed.xml once the application has run once.
## Notes for Docker Toolbox on Windows
If you are using Docker Toolbox on Windows, you may want to have your application files in a different directory than the default shared location.
In this case, once you have shared the appropriate folder in VirtualBox, the regular commands to run the application will fail.
The `Makefile` allows to pass up to 3 different parameters indicating where to find the files and folders the application needs to run.
All of them default to the current directory.
- `ENV_DIR` must point to the folder containing your `.env` file.
- `APP_DIR` must point to the folder that itself contains the application source file under a folder named `src`.
- `OUTPUT_DIR` must point to the folder that itself will have a folder named `output` containing the generated RSS file.
If all parameters are the same, which is very likely if you are in a development environment, then you can copy the value of the first parameter to the others!
```
make run_development ENV_DIR=/path/to/github-notifications-rss-feed APP_DIR=$(ENV_DIR) OUTPUT_DIR=$(ENV_DIR)
```