https://github.com/kudos/combine.fm

🔊 Make sharing from music services better.
https://github.com/kudos/combine.fm

music music-service nodejs

Last synced: about 2 months ago
JSON representation

🔊 Make sharing from music services better.

• Host: GitHub
• URL: https://github.com/kudos/combine.fm
• Owner: kudos
• Created: 2014-11-30T17:01:29.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2023-01-06T01:46:31.000Z (almost 2 years ago)
• Last Synced: 2024-04-08T09:03:06.947Z (9 months ago)
• Topics: music, music-service, nodejs
• Language: JavaScript
• Homepage: https://combine.fm
• Size: 3.8 MB
• Stars: 106
• Watchers: 8
• Forks: 8
• Open Issues: 42
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
#match.audio [![Circle CI](https://circleci.com/gh/kudos/match.audio.svg?style=svg)](https://circleci.com/gh/kudos/match.audio)

Make sharing from music services better. We match links from Rdio, Spotify, Deezer, Google Music and iTunes and give you back a link with all of them.

## Supported Services

* Spotify

* iTunes

* Deezer

* Google Play Music (requires `GOOGLE_EMAIL` and `GOOGLE_PASSWORD`)

* Youtube (requires `YOUTUBE_KEY`)

Google doesn't provide a public API for Play Music, hence this `GOOGLE_PASSWORD` awfulness. The account also needs to be a Google Play Music All Access subscriber and to have played at least one track on a mobile device. Yeah.

If you don't provide credentials, it will simply disable support for that service. Spotify, Deezer and iTunes don't need any auth. The test suite will fail if you don't provide credentials for all services, but individual tests will pass otherwise.

## Getting Started

Install `node` and `postgres` if you don't already have them. Then `npm install` and run the app with `npm start` or tests with `npm test`.

## Contributing

Bug reports and feature requests welcome. If you want to contribute code, that is awesome but please issue pull requests early for discussion.

So there's no surprises for contributors later, I plan on using referral tags wherever it makes sense. Right now that would apply to outgoing links for iTunes and Spotify. The referral tags themselves will not be baked into the code, just support for using them.

## Licence

The code is MIT licenced, the brand is not. This applies to the logo, name and magenta colour scheme. I'll probably pull the branding out of the app itself at some point to make that distinction more clear.