https://github.com/albertocc/feed-box

:pushpin::newspaper: Update a pinned gist with an RSS/Atom feed
https://github.com/albertocc/feed-box

atom-feed feed gist hacktoberfest pinned-gist rss rss-feed

Last synced: 10 months ago
JSON representation

:pushpin::newspaper: Update a pinned gist with an RSS/Atom feed

• Host: GitHub
• URL: https://github.com/albertocc/feed-box
• Owner: albertocc
• License: mit
• Created: 2020-03-09T14:56:10.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2023-07-12T04:43:11.000Z (over 2 years ago)
• Last Synced: 2025-04-21T05:59:16.428Z (11 months ago)
• Topics: atom-feed, feed, gist, hacktoberfest, pinned-gist, rss, rss-feed
• Language: JavaScript
• Homepage:
• Size: 137 KB
• Stars: 9
• Watchers: 2
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-list - feed-box

README

          


:pushpin::newspaper: Feed-Box


Update a pinned gist with an RSS/Atom feed


---

[![license](https://img.shields.io/github/license/mashape/apistatus.svg)](https://github.com/albertocc/feed-box/blob/master/LICENSE)

![Feed-Box](https://github.com/albertocc/feed-box/workflows/Update%20a%20pinned%20gist%20with%20an%20RSS/Atom%20feed/badge.svg?branch=master)

**Feed-Box** is a simple **GitHub action** to update a public gist with the latest entries from any RSS/Atom feed

## Setup

### Prep work

1. Create a new public GitHub Gist (https://gist.github.com/)  

1. Create a token with the `gist` scope and copy it. (https://github.com/settings/tokens/new)  

### Project setup

1. Fork this repo  

1. Edit the [environment variables](https://github.com/albertocc/feed-box/blob/master/.github/workflows/main.yml#L13-L15) in `.github/workflows/main.yml`:

   - **GIST_ID:** The ID portion from your gist url:  

   `https://gist.github.com/username/`**`05c75f4491d78792c767ac8bc07d7e46`**  

   - **RSS_URL:** The URL of the RSS/Atom feed you want to use:  

   **`'https://en.wikinews.org/w/index.php?title=Special:NewsFeed&feed=atom'`**  

   - You can also set in this file how often you want to update the gist. By default it's updated once a day:  

   `cron:`**`"0 0 * * * *"`**

1. Go to the repo **Settings > Secrets**

1. Add the following environment variable:

   - **GH_TOKEN:** The GitHub token generated above.

## Credits

- [rss-parser](https://github.com/rbren/rss-parser)

- [gist-box](https://github.com/JasonEtco/gist-box)

- Inspired by the super [Awesome Pinned Gists](https://github.com/matchai/awesome-pinned-gists) projects

### License

[MIT License](https://github.com/albertocc/feed-box/blob/master/LICENSE) - Copyrights (c) 2020 - [Alberto Cabeza Cardiel](http://alberto.cc)