Skip to content

Latest commit

 

History

History
31 lines (26 loc) · 1.83 KB

README.md

File metadata and controls

31 lines (26 loc) · 1.83 KB
Raw

Inspiration

Many a times, our speakers have too low a volume for everyone to listen. Here is when Stroom will come in handy. No matter what device you have, as long as you have a browser and are connected to the internet, you have the speakers in your bags.

What it does

It creates virtual rooms and a single song playing in each room at an instant, streamed from soundcloud(PS: More streaming services support in TODO).

How it works

A server is created in Node.JS along with Express, ejs and socket.io. The server has a functionality to support many groups at one instant i.e. you can have, say Group A playing some Song X and Group B playing some Song Y. You can join any room and listen to the song playing or create a new room. Sync is maintained among all devices of the same group (room) by the server and also devices can manually sync via a button click.

How to use

  • Clone this repository and move to the root folder of the project.
  • Install Node.JS and NPM if not already installed.
  • Run npm install while in the root folder of the project.
  • Get the local IP of the host machine:
    • Run ifconfig on Linux / Mac OS X.
    • Run ipconfig on Microsoft Windows.
  • Set that local IP as the base_url in ./config/config.json.
  • Run npm start.
  • Open localhost:3000 on your machine and then Create a Room option and share the on-screen link.

TODO

  • Refactor the current code
  • Make links in join room clickable
  • Make an option for uploading songs by users and maintaining a song queue for a room
  • Make a Music Player like UI
  • Integrate the concept of room recommendations based on location

Contributors