🛑 Notice: This repository is no longer maintained; No further Issues or Pull Requests will be considered or approved.

Winds - A Beautiful Open Source RSS & Podcast App Powered by GetStream.io

Description

Winds is a beautiful open-source RSS and Podcast app created using React & Redux on the frontend and Express.js on the backend. Use the free hosted version or run it on your own server and customize it as you see fit. Contributions in form of pull requests are always appreciated. Activity Feeds & Discovery in Winds are powered by Stream, the app leverages Algolia for search, AWS for hosting, MongoDB Atlas for a hosted database (DBaaS), and SendGrid for email. All of these services have a free tier.

Getting Started

To get started with Winds, please download the latest release

Featured RSS & Podcasts

Have a popular RSS or Podcast and want to be featured? Reach out to winds@getstream.io. We reply to every message.

Features at a Glance

Winds is packed full of awesome features behind a beautiful user interface and user experience. Here's a quick look at what the project has to offer:

Beautiful UI

Winds UI

RSS & Podcast Recommendations

Winds RSS & Podcast Recommendations

Integrated Search

Winds Search

Podcast Player

Winds Podcast Player

RSS Reader

Winds RSS Reader

TOCd

Roadmap
Powered By
- Stream
- Algolia
- MongoDB
- SendGrid
- AWS
Tutorials
Download
Contributing to Winds
Support
Maintenance & Contributions

Roadmap

Help us improve Winds and/or vote on the Roadmap for 2.1

[ ] Search detail screen
[ ] Playlist support (partially implemented)
[ ] Team support (share an activity feed with colleagues or friends to discover and collaborate)
[ ] Mobile application powered by React Native

Powered By

The full stack can be found on StackShare.io.

Stream

Stream is an API for building activity feeds. For Winds the follow suggestions and the list of articles from the feeds you follow is powered by Stream. Stream accounts are free for up to 3 million feed updates and handle personalization (machine learning) for up to 100 users.

Algolia

Algolia is used for lightning fast and relevant search. We use their JavaScript search client to easily setup the Winds search implementation. Algolia, accounts are free up to 10k records and 100k operations.

MongoDB

MongoDB Atlas provides a Database as a Service, and serves as the backend datastore for Winds.

Tutorials & Blog Posts

The following tutorials will not only help you start contributing to Winds, but also provide inspiration for your next app.

Note: We're actively working on this portion of the README. To stay up to date with the latest information, please signup for the hosted version at https://getstream.io/winds.

Download

To download Winds, visit https://getstream.io/winds/.

Contributing to Winds

TL;DR

Commands:

brew install redis mongodb
brew services start mongodb
brew services start redis
cd Winds
cd api && yarn
cd ../app && yarn

Sign up for both Stream and Algolia, and create the following .env file in the app directory, replacing the keys where indicated:

DATABASE_URI=mongodb://localhost/WINDS_DEV
CACHE_URI=redis://localhost:6379
JWT_SECRET=YOUR_JWT_SECRET

API_PORT=8080
REACT_APP_API_ENDPOINT=http://localhost:8080
STREAM_API_BASE_URL=https://windspersonalization.getstream.io/personalization/v1.0

STREAM_APP_ID=YOUR_STREAM_APP_ID
REACT_APP_STREAM_APP_ID=YOUR_STREAM_APP_ID
REACT_APP_STREAM_API_KEY=YOUR_STREAM_API_KEY
REACT_APP_STREAM_ANALYTICS=YOUR_STREAM_ANALYTICS_TOKEN
STREAM_API_KEY=YOUR_STREAM_API_KEY
STREAM_API_SECRET=YOUR_STREAM_API_SECRET

REACT_APP_ALGOLIA_APP_ID=YOUR_ALGOLIA_APP_ID
REACT_APP_ALGOLIA_SEARCH_KEY=YOUR_ALGOLIA_SEARCH_ONLY_API_KEY
ALGOLIA_WRITE_KEY=YOUR_ALGOLIA_ADMIN_API_KEY

Note: If you are running the test suite, you will need to have a test version of the .env file inside of the api/test directory.

Then run:

pm2 start process_dev.json
cd app && yarn start

Clone the Repo

git clone git@github.com:GetStream/Winds.git

Install dependencies

The following instructions are geared towards Mac users who can use brew (Homebrew) to install most dependencies. Ubuntu users can use apt, and Windows users will have to install directly from the dependency's site. Non-debian-based Linux users will probably be able to figure it out on their own :)

cd Winds/app
yarn
cd ../api
yarn

Start MongoDB Locally

Winds uses MongoDB as the main datastore - it contains all users, rss feeds, podcasts, episodes, articles, and shares.

If you're on a Mac, you can install MongoDB through Homebrew by running:

brew install mongodb

(You can also install MongoDB from the official MongoDB site.)

You can also run MongoDB in the background by running:

brew services start mongodb

Start Redis Locally

At Stream, we use Redis as an in-memory storage for the Winds podcast processing and RSS processing workers. It contains a list of podcasts and RSS feeds, which the workers pick up and process using the bull messaging system.

If you're on a Mac, you can install Redis through Homebrew by running:

brew install redis

(You can also install Redis from the official Redis site.)

Then, start Redis by running:

redis-server

...which creates (by default) a dump.rdb file in your current directory and stores a cached version of the database in that location.

You can also run Redis in the background by running:

brew services start redis

Loading Test Data

For testing purposes, you will want to use the test data located here.

Use [mongoimport](https://docs.mongodb

Winds

Install / Use

README