/instant-music

Instant Music is the fastest music player on Chrome

Primary LanguageCSSMIT LicenseMIT

Instant Music

What is Instant Music?

Instant Music is a chrome extension that lets you listen to mainstream music in your favorite genre without having to open another heavy music player. You don't even need to come up with your own playlist because Instant Music automatically pulls famous music charts from iTunes, BillBoard, and Melon, and plays songs using YouTube videos as source. If there is any song you wish to play, you can search for it by the song's title and the artist's name, and watch it appears in your playlist instantly. And yes, of course you can create your own playlists too.

Instant Music

Download: Chrome Webstore

Contributing

Contributing to Instant Music is extremely easy because of the nature of a chrome extension. The backend is already taken care of, and all there is to care about is the frontend. The bugs usually stem from silent patches from YouTube or slight link modifications of music charts and other API's. I built Instant Music when I knew nothing about Backbone.js.

Libraries/frameworks used

  • HTML, JavaScript, CSS
  • Backbone.js, require.js, underscore.js
  • Bootstrap, FlatUI
  • YouTube IFrame API
  • YouTube Data API (v3)
  • Melon Chart API

Setting up development environment

  1. Fork this repository.
  2. In your favorite directory, clone the forked repo
$ git clone https://github.com/[your_github_handle]/instant-music.git
  1. To load the extension locally, go to chrome://extensions and turn on the developer mode. Click "Load unpacked extension" and choose the directory you cloned the repo to.
  2. If you find a bug, post it as an issue. You can work on any of the existing issues too.
  3. Fix the bug. When you think you have fixed the bug, run manual tests until you are confident that your patch works. Then commit it and push it to your repo.
$ git add .
$ git commit -m 'fixed bug for the issue #32'
$ git push origin master
  1. Go to your forked repository and submit a pull request.
  2. The pull request goes under review and when everything seems suitable, it will be deployed.

Useful guides

Credits

  • Lab80: For everything
  • Sean Anderson: For insipiration
  • Hun Choi @ Microsoft: For providing BizSpark package to host Instant Music
  • Jun Hyun Park: For translating Instant Music into Japanese
  • Coding everybody group: Where Instant Music was first released to public

License

Instant Music is under MIT License.