{"id":15359332,"url":"https://github.com/bmcfee/lsd_viz","last_synced_at":"2025-06-24T00:34:05.196Z","repository":{"id":21851008,"uuid":"25174270","full_name":"bmcfee/lsd_viz","owner":"bmcfee","description":"Laplacian structural decomposition music visualization","archived":false,"fork":false,"pushed_at":"2020-06-06T19:00:16.000Z","size":246,"stargazers_count":22,"open_issues_count":1,"forks_count":8,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-15T07:41:38.195Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bmcfee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-10-13T19:33:51.000Z","updated_at":"2025-03-16T15:02:17.000Z","dependencies_parsed_at":"2022-08-17T21:05:30.097Z","dependency_job_id":null,"html_url":"https://github.com/bmcfee/lsd_viz","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/bmcfee/lsd_viz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmcfee%2Flsd_viz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmcfee%2Flsd_viz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmcfee%2Flsd_viz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmcfee%2Flsd_viz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bmcfee","download_url":"https://codeload.github.com/bmcfee/lsd_viz/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmcfee%2Flsd_viz/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261583118,"owners_count":23180639,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-01T12:44:29.985Z","updated_at":"2025-06-24T00:34:05.169Z","avatar_url":"https://github.com/bmcfee.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"Laplacian structural decomposition music visualization\n======================================================\n[![DOI](https://zenodo.org/badge/25174270.svg)](https://zenodo.org/badge/latestdoi/25174270)\n\nLSD_VIZ is a web-based, multi-level music structure analysis visualizer.\nThe analysis is based on the spectral clustering algorithm of\n\n\u003e [McFee, Brian, and Dan Ellis. \"Analyzing Song Structure with Spectral Clustering.\" ISMIR. 2014.](https://bmcfee.github.io/papers/ismir2014_spectral.pdf)\n\nHere's how it looks on *The Beatles - Come Together*:\n\n![Structure visualization](https://raw.githubusercontent.com/bmcfee/lsd_viz/master/lsdviz.png)\n\nInstallation\n============\n1. Clone the repository: `git clone https://github.com/bmcfee/lsd_viz.git lsd_viz`\n2. Enter the directory: `cd lsd_viz`\n3. Install the requirements: `pip install -r requirements.txt`\n\n\nUsage\n=====\n\nTo analyze a song, run the following command:\n```\npython lsd_viz.py /path/to/your_song.mp3\n```\n\nBy default, this will launch a local web server on port 9999.  To view the analysis, point your web browser at (http://127.0.0.1:9999/).\n\nTo change the port and host configuration, see the command-line options by saying `python lsd_viz.py -h`.\n\nDescription\n===========\nThe visualization presents the song's structure as concentric rings, with time arranged clockwise from the top of the ring.\nAn audio playback widget is provided, and as the song plays, a red play-head will sweep over the visualization.\nA slider is provided to control the complexity of the display: the center ring is the simplest (fewest distinct component types), and outer rings illustrate more complex or precise structural elements.\nSimilar colors within a ring correspond loosely to repetitions of segments: you can click on any segment to jump directly to its beginning, and it will automatically highlight all other repetitions of that segment.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbmcfee%2Flsd_viz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbmcfee%2Flsd_viz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbmcfee%2Flsd_viz/lists"}