Peekify

Curiosity that connects

Have you ever wondered what the person next to you is listening to?

Our mission is to connect people through curiosity.

Features

• You can peek at the music people are playing.
• You can check your music history. That is a list of songs you have listened to.
• You can see other people's music history, too.
• You can send a brief message and "like" to the music other people are playing.
• You can follow your favorite users and find what they have been listening to.

Site

You can use the app here

Usage

Prerequisite: You need to have an account with Spotify.

1.　 Access the site above and register and log in.

Note: The email and name for Peekify do not need to match those for your Spotify account.

2.　 Login with Spotify

Press the green button that says "Login with Spotify."

When you use this app for the first time, you will be asked to log in with Spotify and also if you allow Peekify to receive your Spotify data (what you are listening currently). Press OKAY if you agree to continue.

For the second time onward, you don't need to press "Log in with Spotify" to see what other users are playing. To share your music with others, however, you need to log in with Spotify. (See section 3 below for more detail.)

3.　 Share what you are currently playing with other users

Peekify lets other users peek at what you are now playing but that is possible with the ones that you share.

To share the music/podcast, first, get the current by pressing "Current."

(You may have the current music/podcast already like in the picture above if you had been playing it on Spotify when you pressed "Log in with Spotify.")

And press "Share." You see "Successfully posted!" when you shared the music/podcast.

Your music/podcast does not appear on your page. It will appear on other users' screens only.

When you are listening to another music/podcast and want to update the current section, press "Current."

4. Comment and send like to other people

The lower half of the screen is the post section. This is where you see what other users are listening to. Here you can do following things.

You can send a comment and like to what other people are listening.

To write a comment, text in the light purple box and press "comment" to send it. You can also press the heart icon to send a "like".

You can also listen to the music/podcast other users are playing.

5. Peek other users' playing history and follow them

In the post section, click on the name of any user in to see the history of the music/podcast they shared.

Click on "Peek" above the user's history to follow the user. "Peek" will change to "Peeking" for users you follow. See also Peeking List".

6. Menu button

If you press the "menu" button at the left top of the screen, you will see four buttons.

(a) "Profile" -- Press "Profile" to go to your profile page, where you find the list of the music/podcast you shared along with comments and likes other users sent.

(b) "Refresh" -- Press "Refresh" to refresh data on the app. You can use this button when you have moved to another location. That will reorder other users in the post section according to their closeness to your current location.

(c) "Peeking list" -- Press "Peeking list" to see only the users you are peeking at (i.e. following) in the post section.

(d) "range" and "KM Radius" -- You can set the range in which the users who appear in the post section be. For example, entering 10 and pressing "range" would show the users within the radius of 10 kilometers around you.

Technolgy used

• Peekify is a progressive web application. The frontend is written in React and TypeScript, and is deployed on AWS Amplify.

• It uses geolocation API to collect the user's location and Spotify APIs to get the user's current playing data. These data are then sent to the backend.

• The backend is built using Node.js and Express. The database is mongoDB. Login and user verification is based on JWT. The backend is deployed on heroku.

• For real-time commenting, the app uses Websockets. The Websockets server is also deployed on heroku.

Future features

1. Ability to follow your favorite users see their history of the music/podcast they listen
2. Ability to block users
3. "Peekers peak" - a map showing where clusters of users are
4. Podcast listening party - to allow users to listen to the same podcast in sync and to chat about it in real-time

Project's repositories

• FrontEnd is here.

• Web server is here.

• Web socket server is here.

Authors

Francis @Franckgaud

Misho @miomaeshima

Nada @oneatatimet

Kaisei @Kaisei-Suzuki1990

Soshi @SoshiK

License

MIT