README.md

rplayr

Source code for rplayr, a React app to parse and play media from subreddits and comment threads.

FAQ

What is this?

rplayr creates playlists from any Reddit comment thread, subreddit or multi-reddit. Just replace reddit.com in any Reddit URL to rplayr.com and you’re good.

How does it work?

The app is written using React. It fetches stuff from Reddit using fetch-reddit, then react-player plays any supported URLs. Playlists are curated by the mighty evilnight over at /r/listentothis.

What can it play?

rplayr currently supports YouTube, SoundCloud and Vimeo links.

What about radd.it, reddit.musicplayer.io, redditplaylister, etc?

Yes, there are other apps that do the job. I wanted to create something simple with a clean, minimal interface. Also, this app fixes issues that other apps still suffer from.

Development

See the app in action or run it locally yourself:

git clone https://github.com/CookPete/rplayr.git
cd rplayr
npm install
npm run fetch-playlists
npm start
open http://localhost:3000

Fetching playlists

The lists of playlists and subreddits on the front page is parsed from a set of multi-reddits curated by evilnight. This script fetches the data from the Reddit API, and writes only what the app needs to /data/playlists.json.

npm run fetch-playlists

Building

Running will compile all code into a single JS and CSS file inside dist. There is also a super-minimal html file to run the app.

npm run build

Linting

This project uses standard and scss-lint to prevent errors and keep code styles consistent.

npm run lint

Testing

This project uses mocha with chai assertions for unit testing.

npm run test

Thanks

• gaearon for his react-transform-boilerplate, which this repo is roughly based on.
• evilnight and the mods at /r/listentothis for the great library of multi-reddits to use as playlists.