vjmedia - User contributions [en]

Music Discovery Application

2026-08-08T18:11:15Z

Vjmanzo:

[[Ongoing_Research_Projects | '''Go Back to Main Project Menu''']] 
[[File:MusicDiscoverySearch.jpeg|thumb|500px|right|]] 

[[Category:Interactive Systems]]
[[Category: Advisor:Manzo]]

=Overview=
Music Discovery is a full-stack music recommendation web application using Next.js, React, and TypeScript. The application allows users to search for a song, select it, and receive recommendations based on audio features such as energy, danceability, valence, BPM, key, mode, and genre. I implemented the search and recommendation functionality through API routes so that the large song dataset remains on the server rather than being loaded into the client. I also integrated the iTunes Search API to retrieve album artwork and audio preview clips for songs displayed in the application.

For the recommendation system, I created a similarity algorithm that compares the selected song against songs in the dataset and assigns each song a similarity score based on the differences between their audio features. Songs with the lowest scores are considered the most similar and are returned as recommendations. I also created a reusable Song TypeScript type to define the properties shared across the dataset and application.

=Current Status: E2 Term 2026=
<mediaplayer>File:MusicDiscovery.mp4</mediaplayer>

=Future Development=
The project uses a large Spotify song dataset that was converted from CSV to JSON and processed to remove duplicate songs. The primary resources for continuing development are the project GitHub repository, the dataset files in src/data, the recommendation logic in src/lib/recommend.ts, and the API routes in src/app/api. Future work should focus on improving the quality and diversity of the dataset, particularly reducing irrelevant/non-English songs and improving coverage of newer music and genres such as hip-hop and rap. Additionally, not all songs consistently return album artwork or audio previews from the iTunes API, so improving the reliability of these results or finding an alternative source for missing artwork and previews would be useful. Finally, it would be great if the application had some sort of explanation to the user as to why the results were recommended.

==Project Files & Resources==
===Git Repository===
All files for this project are stored on the secured repository below.
*https://github.com/nj-anderson/music-discovery

==WPI Student Contributors==
===E2 Term 2026===
Norah Anderson

How to Create Pages

2026-06-23T14:48:06Z

Vjmanzo: /* Creating Pages */

=How to Create Pages=
== ''' Take a deep breath and read this entire page...it will really only take you three minutes, and will save you time and headaches.''' ==
 
==Creating Pages==
Create pages by:
*Logging in with your WPI username
*Clicking the "Create page" link at the left menu
**Suggestion: copy the contents of [[Private:Experimental_Guitar_Top| this page]] as a template starting point for your page
***Step 1: Visit the page
***Step 2: Click the edit button on the page
***Step 3: Close the contents in the editable page window
***Step 4: Close the page
***Step 5: Paste the copied info into a new page you create
*Choose one or more categories (shown on the main page) that you feel your project falls into and create a category tags such as <nowiki>[[Category:Algorithmic Composition]] or [[Category:Interactive Systems]]</nowiki>. You can see all of the categories from the main page.
*Add a description and links to the content you're submitting by formatting them as <nowiki>[//www.mylink.com The Thing My Link Goes To]</nowiki>.
*See steps below for uploading and linking to content
*Once your page is complete, click save and review it. Go to the main page and ensure that your page shows up in the proper categories.

==Adding Category Tags==
'''Complete List of Categories'''

'''Projects & Systems'''

<nowiki>
[[Category:Interactive Systems]]
</nowiki>

<nowiki>
[[Category:Multimedia]]
</nowiki>

<nowiki>
[[Category:Gaming]]
</nowiki>

<nowiki>
[[Category:Pedagogy, Theory, and Research Resources]]</nowiki>

<nowiki>
[[Category:Development Toolkits]]
</nowiki>

'''Compositions & Works'''

<nowiki>
[[Category:Music (classical)]]
</nowiki>

<nowiki>
[[Category:Music (popular, contemporary, non-classical)]]
</nowiki>

<nowiki>
[[Category:Algorithmic, Interactive, & Electro-acoustic Compositions]]
</nowiki>

<nowiki>
[[Category:Sound Design]]
</nowiki>

<nowiki>
[[Category:Film, Video, and Related Scores]]
</nowiki>

<nowiki>
[[Category:Scores and Arrangements]]
</nowiki>

<nowiki>
[[Category:Multimedia]]
</nowiki>

<nowiki>
[[Category:Writings, Papers, Tutorials,and Documentation]]
</nowiki>

'''Course Projects'''

<nowiki>
[[Category:Electronic Music Composition (3620)]]
</nowiki>

<nowiki>
[[Category:Foundations of Music Technology (2300)]]
</nowiki>

'''Important''': include an ''Advisor'' category tag depending on who you worked on the project with. For classes with Dr. Manzo, include the tag <nowiki>[[Category: Advisor:Manzo]]</nowiki>. If you worked on the project Dr. Bianchi, <nowiki>[[Category: Advisor:Bianchi]]</nowiki>; Dr. Barton, <nowiki>[[Category: Advisor:Barton]]</nowiki> and so on.

=How to Upload & Embed to Video, Audio, and Pictures=
Upload content to the Wiki in two ways:

==Uploading Files Through the Wiki (for small files)==
'''Using "Upload file" feature (for files smaller than 24mb)'''

*Click the [[Special:Upload| Upload file]] link at the left and upload a file
*Link to the files within your page using the tag:

<nowiki>[[File:my_filename.jpg]]</nowiki>

==Uploading Files Through the Media Server (for large files)==
'''Using WPI Storage (for files larger than 24mb)'''
To upload large files, log in at the page below:

https://video.wpi.edu/app/SingleSignOn/default.aspx

====Video Encoding Requirements ====
Encode videos as MP4 files when possible. If you encounter issues with the video not displaying on the Wiki, you may need to change your video encoding settings. Click [[Encoding|here]] for more information.

==Uploading and Embedding a Document==
Upload a document through by clicking the [[Special:Upload|Upload file]] link at the leftside menu. 
When you upload a file, the filename will be shown as shown below: 
[[File:Determine_filename.png|400px]] 
The document can then be embedded in a page with that same filename using the following code: 
<nowiki>
[[File:FlyClone Fretboard to Neck Jig.pdf|Document]]
</nowiki>
 
 

==Embedding Video Uploaded Through the Media Server==
After adding media, grab the embed code, modify it, and add to your wiki page as described [[Embedding_Media| here]].
 
 

==Embedding Video and Audio Uploaded Through the Wiki==
*Upload the video or audio using the above steps
*Copy the link to your audio or video file
*Embed the video or audio in your page with the following code:

Code:
<nowiki><mediaplayer>http://media.wpi.edu/Academics/Depts/HUA/Manzo/My_Audio.mp4</mediaplayer></nowiki>

or

<nowiki><mp3player>http://media.wpi.edu/Academics/Depts/HUA/Manzo/My_Audio.mp3</mp3player></nowiki>

==Embedding Images Uploaded Through the Wiki==
*Uploading the image using the "Upload file" link at the left
*You may embed the image in your page with the following code:

Code:
<nowiki>[[File:image_name.png]]</nowiki>
 

=[[Help_Connecting_to_File_Repository |Help Connecting to Git Repository]]=
Click [[Help_Connecting_to_File_Repository |here]] for help connecting to the GIT Repositories for projects.
 

=[[Splashtop |Help Connecting to Alden B30 Remotely Through Splashtop]]=
Click [[Splashtop |here]] for help connecting to to Alden B30 Remotely Through Splashtop.
 

=Adding Your Name to the WPI Student Contributors section of Project pages=
For pages associated with [[Ongoing_Research_Projects|ongoing research projects]] (for HU3910 or other), click the edit button next to the top heading "WPI Student Contributors" and add a year and your name with the formatting and syntax shown here: 
[[File:Student_contributors.jpg|400px]]
 

=Uploading and Embedding Documents on Project pages=
* Upload the file using the information [[#Uploading_and_Embedding_a_Document|above]].
** Copy the filename as noted [[#Uploading_and_Embedding_a_Document|above]].
*For pages associated with [[Ongoing_Research_Projects|ongoing research projects]] (for HU3910 or other), click the edit button next to "Documentation" of the relevant "Project Files & Resources" instance(s) on that page.
 
Your document linked on the project page should ultimately look like this: 
[[File:Embedding_reports.png|400px]]
 

See an example [[Private:Fly_Clone#Documentation|'''here''']].
 
* Use this code on the project's Wiki page as an example:
 

<nowiki>
====Documentation====
</nowiki>
 
<nowiki>
*See [[:File:My_Report.pdf| this report]] from D 2020
</nowiki>

How to Create Pages

2026-06-23T14:44:17Z

Vjmanzo: /* Creating Pages */

=How to Create Pages=
== ''' Take a deep breath and read this entire page...it will really only take you three minutes, and will save you time and headaches.''' ==
 
==Creating Pages==
Create pages by:
*Logging in with your WPI username
*Clicking the "Create page" link at the left menu
*Suggestion: copy the contents of [[Private:Experimental_Guitar_Top| this page]] as a template starting point for your page
*Choose one or more categories (shown on the main page) that you feel your project falls into and create a category tags such as <nowiki>[[Category:Algorithmic Composition]] or [[Category:Interactive Systems]]</nowiki>. You can see all of the categories from the main page.
*Add a description and links to the content you're submitting by formatting them as <nowiki>[//www.mylink.com The Thing My Link Goes To]</nowiki>.
*See steps below for uploading and linking to content
*Once your page is complete, click save and review it. Go to the main page and ensure that your page shows up in the proper categories.

==Adding Category Tags==
'''Complete List of Categories'''

'''Projects & Systems'''

<nowiki>
[[Category:Interactive Systems]]
</nowiki>

<nowiki>
[[Category:Multimedia]]
</nowiki>

<nowiki>
[[Category:Gaming]]
</nowiki>

<nowiki>
[[Category:Pedagogy, Theory, and Research Resources]]</nowiki>

<nowiki>
[[Category:Development Toolkits]]
</nowiki>

'''Compositions & Works'''

<nowiki>
[[Category:Music (classical)]]
</nowiki>

<nowiki>
[[Category:Music (popular, contemporary, non-classical)]]
</nowiki>

<nowiki>
[[Category:Algorithmic, Interactive, & Electro-acoustic Compositions]]
</nowiki>

<nowiki>
[[Category:Sound Design]]
</nowiki>

<nowiki>
[[Category:Film, Video, and Related Scores]]
</nowiki>

<nowiki>
[[Category:Scores and Arrangements]]
</nowiki>

<nowiki>
[[Category:Multimedia]]
</nowiki>

<nowiki>
[[Category:Writings, Papers, Tutorials,and Documentation]]
</nowiki>

'''Course Projects'''

<nowiki>
[[Category:Electronic Music Composition (3620)]]
</nowiki>

<nowiki>
[[Category:Foundations of Music Technology (2300)]]
</nowiki>

'''Important''': include an ''Advisor'' category tag depending on who you worked on the project with. For classes with Dr. Manzo, include the tag <nowiki>[[Category: Advisor:Manzo]]</nowiki>. If you worked on the project Dr. Bianchi, <nowiki>[[Category: Advisor:Bianchi]]</nowiki>; Dr. Barton, <nowiki>[[Category: Advisor:Barton]]</nowiki> and so on.

=How to Upload & Embed to Video, Audio, and Pictures=
Upload content to the Wiki in two ways:

==Uploading Files Through the Wiki (for small files)==
'''Using "Upload file" feature (for files smaller than 24mb)'''

*Click the [[Special:Upload| Upload file]] link at the left and upload a file
*Link to the files within your page using the tag:

<nowiki>[[File:my_filename.jpg]]</nowiki>

==Uploading Files Through the Media Server (for large files)==
'''Using WPI Storage (for files larger than 24mb)'''
To upload large files, log in at the page below:

https://video.wpi.edu/app/SingleSignOn/default.aspx

====Video Encoding Requirements ====
Encode videos as MP4 files when possible. If you encounter issues with the video not displaying on the Wiki, you may need to change your video encoding settings. Click [[Encoding|here]] for more information.

==Uploading and Embedding a Document==
Upload a document through by clicking the [[Special:Upload|Upload file]] link at the leftside menu. 
When you upload a file, the filename will be shown as shown below: 
[[File:Determine_filename.png|400px]] 
The document can then be embedded in a page with that same filename using the following code: 
<nowiki>
[[File:FlyClone Fretboard to Neck Jig.pdf|Document]]
</nowiki>
 
 

==Embedding Video Uploaded Through the Media Server==
After adding media, grab the embed code, modify it, and add to your wiki page as described [[Embedding_Media| here]].
 
 

==Embedding Video and Audio Uploaded Through the Wiki==
*Upload the video or audio using the above steps
*Copy the link to your audio or video file
*Embed the video or audio in your page with the following code:

Code:
<nowiki><mediaplayer>http://media.wpi.edu/Academics/Depts/HUA/Manzo/My_Audio.mp4</mediaplayer></nowiki>

or

<nowiki><mp3player>http://media.wpi.edu/Academics/Depts/HUA/Manzo/My_Audio.mp3</mp3player></nowiki>

==Embedding Images Uploaded Through the Wiki==
*Uploading the image using the "Upload file" link at the left
*You may embed the image in your page with the following code:

Code:
<nowiki>[[File:image_name.png]]</nowiki>
 

=[[Help_Connecting_to_File_Repository |Help Connecting to Git Repository]]=
Click [[Help_Connecting_to_File_Repository |here]] for help connecting to the GIT Repositories for projects.
 

=[[Splashtop |Help Connecting to Alden B30 Remotely Through Splashtop]]=
Click [[Splashtop |here]] for help connecting to to Alden B30 Remotely Through Splashtop.
 

=Adding Your Name to the WPI Student Contributors section of Project pages=
For pages associated with [[Ongoing_Research_Projects|ongoing research projects]] (for HU3910 or other), click the edit button next to the top heading "WPI Student Contributors" and add a year and your name with the formatting and syntax shown here: 
[[File:Student_contributors.jpg|400px]]
 

=Uploading and Embedding Documents on Project pages=
* Upload the file using the information [[#Uploading_and_Embedding_a_Document|above]].
** Copy the filename as noted [[#Uploading_and_Embedding_a_Document|above]].
*For pages associated with [[Ongoing_Research_Projects|ongoing research projects]] (for HU3910 or other), click the edit button next to "Documentation" of the relevant "Project Files & Resources" instance(s) on that page.
 
Your document linked on the project page should ultimately look like this: 
[[File:Embedding_reports.png|400px]]
 

See an example [[Private:Fly_Clone#Documentation|'''here''']].
 
* Use this code on the project's Wiki page as an example:
 

<nowiki>
====Documentation====
</nowiki>
 
<nowiki>
*See [[:File:My_Report.pdf| this report]] from D 2020
</nowiki>

File:Squidbox Hardware Buttons Writeup.pdf

2026-06-03T22:34:20Z

Vjmanzo: File uploaded with MsUpload

File uploaded with MsUpload

File:AccessiblePedal.jpg

2026-04-13T23:25:53Z

Vjmanzo: Vjmanzo uploaded a new version of File:AccessiblePedal.jpg

Experimental Guitar Top

2026-03-17T04:56:17Z

Vjmanzo: Vjmanzo moved page Experimental Guitar Top to Private:Experimental Guitar Top

#REDIRECT [[Private:Experimental Guitar Top]]

File:MaryFord.png

2026-03-16T21:49:33Z

Vjmanzo: