Skip to content

hkalbertkim/MapSound

Repository files navigation

MapSound.me

MapSound.me Logo

Visually Map Your Sound, Generate Your Tribute

MapSound.me is an open-source platform for music fans who want to do more than just listen. We believe music is about community, analysis, and creative expression. Our tool allows you to visually decompose your favorite tracks into intuitive 'Sonic Maps' and use AI to generate new, unique 'Tribute' audio based on your analysis.

Currently featured example analysis: "Last Train Home" by Pat Metheny Group.


🚀 The Vision

Our mission is to create a community-driven sonic map platform. Fans analyze the musical elements of songs they love, map them visually (from Rhythm and Melody to Atmosphere and Mood), and the MapSound engine generates new experimental music that captures the 'essence' of that sound without infringing on copyright. It's a tribute, generated by your analysis.

🛠️ Key Features

  • Interactive Sonic Map Canvas: Use our sleek drag-and-drop interface powered by @xyflow/react to visually arrange musical elements.
  • Multi-layered Decomposition: Map songs across critical dimensions: Rhythm, Low-End, Atmosphere, Melody, and Mood.
  • Edit & Connect Nodes: Build your own custom maps by adding, editing, and connecting sound nodes.
  • AI Tribute Generation (MVP): Use your visual analysis to generate unique audio. (Current state uses mock APIs, connecting to real audio generation engines is the next major step).
  • Open Source & Community Driven: Contribute to the platform, share maps, and collaborate on analyzing the sound of different artists.

💻 Technical Stack

🚧 Getting Started

We are in early, active beta! The easiest way to get started is to use the default "Last Train Home" analysis on our live app (link coming soon) or run it locally.

# Clone the repository
git clone https://github.com/hkalbertkim/MapSound.git

# Install dependencies
npm install

# Run the development server
npm run dev

Open http://localhost:3000 with your browser to see the interactive canvas and generate tributes.

🤝 Contribution Guide

MapSound is an open-source project, and we welcome contributions from developers, music analysts, and creative artists!

  • For Developers: We need help with feature development, UI/UX polish, and especially integrating real AI music generation APIs.
  • For Analysts: Map your favorite artist's sound and share your Sonic Maps as community examples!

Please check our ISSUES or DISCUSSIONS tabs to see where you can help.

License

MapSound is released under the Business Source License (BSL 1.1).

The source code is publicly visible and may be used for personal, educational, research, and non-commercial purposes.

Commercial use of the MapSound platform, including running it as a hosted service, requires a commercial license.

On 2029-01-01 the code will convert to GPL-3.0-or-later.

See COMMERCIAL.md for commercial licensing guidance.


Managed by: hkalbertkim (Albert Kim)

About

MapSound is an open platform that visually decomposes songs into Sonic Blueprints and generates AI-powered tribute music inspired by the songs fans love.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors