{"repo":"timkicker/github-notifications-rss","free":true,"listed":false,"github":"https://github.com/timkicker/github-notifications-rss","clone":"git clone https://github.com/timkicker/github-notifications-rss.git","description":"Turn your GitHub notifications into a customizable RSS feed","language":"Python","stars":50,"topics":["docker","github","notifications","rss","self-hosted"],"license":"MIT","category":"self-hosted-apps","readme_excerpt":"GitHub Notifications RSS This is a small service that turns your GitHub notifications into an RSS feed. You give it a GitHub personal access token. It calls the /notifications API, filters the data, and serves an RSS 2.0 feed that your reader can subscribe to. What it does - Fetches GitHub notifications using the official API - Can limit to threads where you are actually involved ( participating only ) - Can filter by reason (mention, assign, state change, ci activity, ...) - Can include or exclude specific repositories - Caches results for a short time so it does not hammer the GitHub API - Exposes two endpoints: - /feed for the RSS feed - /health for a simple JSON status Descriptions can be HTML or plain text, depending on config. Example feed item In a typical RSS reader a single item might look like this: Title [timkicker/podliner] Fix MPV logging path on Linux Body Quick start with Docker Clone the repo and copy the example env file: Edit .env and set at least: Then build and start: If your compose file maps port 8083:8000 , the feed is available at: - Feed: http://localhost:8083/feed - Health: http://localhost:8083/health Add http://localhost:8083/feed to your RSS reader and you are done. Token and scopes You need a GitHub Personal Access Token (classic). - Only public repositories: - public repo and read:user are usually enough - With private repositories: - include repo Basic configuration Most options are set through environment variables. There is a .env.example wit","default_branch":null,"files":null,"tree":[],"storefront":"/r/timkicker","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/timkicker/github-notifications-rss/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}