Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/meloncholy/mixcloud-rss
MixCloud to RSS converter
https://github.com/meloncholy/mixcloud-rss
Last synced: 9 days ago
JSON representation
MixCloud to RSS converter
- Host: GitHub
- URL: https://github.com/meloncholy/mixcloud-rss
- Owner: meloncholy
- Created: 2012-07-03T22:14:56.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2013-09-14T17:44:20.000Z (about 11 years ago)
- Last Synced: 2024-08-02T14:05:45.490Z (3 months ago)
- Language: CSS
- Homepage: http://bits.meloncholy.com/mixcloud-rss
- Size: 159 KB
- Stars: 42
- Watchers: 4
- Forks: 9
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
MixCloud RSS Converter
======================
_[Use or try the MixCloud to RSS converter here](http://bits.meloncholy.com/mixcloud-rss) (and subscribe the feeds too if you want)._
While it [used to](http://feedback.mixcloud.com/forums/3043-general/suggestions/1922671-loss-of-user-mixes-rss), MixCloud unfortunately doesn't offer RSS feeds anymore. So I decided to add them back.
MixCloud has [an API](http://www.mixcloud.com/developers/documentation) that gives a stream of recent uploads, so I used this to get an embedded music player for each post via their oEmbed API.
You can see the [code in action here](http://bits.meloncholy.com/mixcloud-rss) (feel free to use the feeds too), and there's a [sample WordPress page here](http://www.breakzdjs.com/category/music/) that syndicates feeds from a number of MixCloud (and SoundCloud) accounts.
I really am standing on the shoulders of giants here as this required almost no code on my part (maybe 300 lines) thanks to the MixCloud API, the [node-oembed](https://github.com/astro/node-oembed) and [node-rss](https://github.com/dylang/node-rss) modules from Stephan Maka and Dylan Greene, and of course Express, Jade and Node.js.
If you want to read a more verbose version of this introduction (though I don't think there's much extra insight), you can do that [here](http://meloncholy.com/blog/mixcloud-rss-converter-in-node-js/).
Settings
--------
Please rename `/config/app-sample.json` to `app.json`.
- **mode** - _production_ loads minimized files and includes Analytics, while _development_ doesn't.
- **localPort** - The local port to use.
- **url** - Public URL for the site.
- **title** - Name of the site. Used in the browser title bar and elsewhere.
- **author** - Not really used, actually. Just appears in the meta header.
- **description** - Meta description content.
- **rssDescription** - Short description of the feed. _%user_ will be swapped for the current account's name.
- **cloudcastStreamUrl** - MixCloud API URL for getting profiles.
- **cloudCastOembedUrl** - MixCloud API URL for getting Cloudcasts.
- **jQueryCdnUrl** - Yup. Only used in _production_ mode.
- **gaAccount** - Your Google Analytics UA number.
- **gaDomain** - Your Analytics domain.
Example
```javascript
{
"mode": "development",
"localPort": 3000,
"url": "http://bits.meloncholy.com/mixcloud-rss/",
"title": "MixCloud to RSS converter",
"author": "Andrew Weeks",
"description": "Get an RSS feed for your (or anyone else's) Mixcloud mixes and podcasts.",
"rssDescription": "Visit %user's profile on MixCloud. Listen to their recent and most popular Cloudcasts. It's free and really easy to use. MixCloud to RSS thingy hacked together by Andrew Weeks. http://meloncholy.com",
"cloudcastStreamUrl": "http://api.mixcloud.com/%user/cloudcasts/",
"cloudcastOembedUrl": "http://www.mixcloud.com/oembed/?url=http%3A//www.mixcloud.com%cloudcast&format=json",
"jQueryCdnUrl": "https://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js",
"gaAccount": "UA-XXXXXXXX-X",
"gaDomain": "meloncholy.com"
}
```
Dependencies
------------
In case NPM doesn't help you out for some reason, you'll also need
- [Express](https://github.com/visionmedia/express)
- [Jade](https://github.com/visionmedia/jade)
- [Konphyg](https://github.com/pgte/konphyg)
- [node-oembed](https://github.com/astro/node-oembed/)
- [node-rss](https://github.com/dylang/node-rss)
Legal fun
---------
Copyright © 2012 Andrew Weeks http://meloncholy.com
MixCloud RSS Converter is licensed under the [MIT licence](http://meloncholy.com/licence/).
Me
--
I have a [website](http://meloncholy.com) and a [Twitter](https://twitter.com/meloncholy). Please come and say hi if you'd like or if something's not working; be lovely to hear from you.