[{"data":1,"prerenderedAt":9224},["ShallowReactive",2],{"navigation":3,"/blog/music-data/why-we-decided-to-use-wavesurfer-post":734,"/blog/music-data/why-we-decided-to-use-wavesurfer-surround":936,"/blog/music-data/why-we-decided-to-use-wavesurfer-related":941},[4,70,207,312,721],{"title":5,"path":6,"stem":7,"children":8,"page":69},"Case Study","/blog/case-study","blog/case-study",[9,13,17,21,25,29,33,37,41,45,49,53,57,61,65],{"title":10,"path":11,"stem":12},"Ambistream – Multi-Layer Streaming Platform","/blog/case-study/ambistream-building-a-multi-layer-streaming-platform-from-a-spark-of-an-idea","blog/case-study/ambistream-building-a-multi-layer-streaming-platform-from-a-spark-of-an-idea",{"title":14,"path":15,"stem":16},"Custom Chromecast & AirPlay Casting App","/blog/case-study/chromecast-airplay-casting-app-case-study","blog/case-study/chromecast-airplay-casting-app-case-study",{"title":18,"path":19,"stem":20},"Direct Music Licensing Platform Case Study","/blog/case-study/dlm-music-catalog-case-study","blog/case-study/dlm-music-catalog-case-study",{"title":22,"path":23,"stem":24},"Assembly Instructions App - Galeco Mobile App","/blog/case-study/galeco-mobile-app-case-study","blog/case-study/galeco-mobile-app-case-study",{"title":26,"path":27,"stem":28},"MemoSonic: Building an Audio Memory Game","/blog/case-study/how-we-built-memosonic-accessible-audio-memory-game-flutter","blog/case-study/how-we-built-memosonic-accessible-audio-memory-game-flutter",{"title":30,"path":31,"stem":32},"Loyalty Program App for Shopping Mall","/blog/case-study/loyalty-program-application-case-study","blog/case-study/loyalty-program-application-case-study",{"title":34,"path":35,"stem":36},"Mobile Application for Music Catalogs","/blog/case-study/mobile-app-for-music-catalog","blog/case-study/mobile-app-for-music-catalog",{"title":38,"path":39,"stem":40},"Universal Music Data Parser for 20+ Platforms","/blog/case-study/musicdata-lab-universal-music-data-parser-case-study","blog/case-study/musicdata-lab-universal-music-data-parser-case-study",{"title":42,"path":43,"stem":44},"Panther ML/AI Pricing Recommendation Tool","/blog/case-study/panther-pricing-recommendation-tool-case-study","blog/case-study/panther-pricing-recommendation-tool-case-study",{"title":46,"path":47,"stem":48},"4D Grupa Roofing Wholesalers Platform","/blog/case-study/roofing-wholesalers-website-case-study","blog/case-study/roofing-wholesalers-website-case-study",{"title":50,"path":51,"stem":52},"Talent Alpha HR Frontend Platform","/blog/case-study/talent-alpha-hr-platform-case-study","blog/case-study/talent-alpha-hr-platform-case-study",{"title":54,"path":55,"stem":56},"Ticketing & Events Platform Development","/blog/case-study/ticketing-events-platform-case-study","blog/case-study/ticketing-events-platform-case-study",{"title":58,"path":59,"stem":60},"Turn Fans into Superfans — Roadie.co","/blog/case-study/turn-fans-into-superfans-roadie-co","blog/case-study/turn-fans-into-superfans-roadie-co",{"title":62,"path":63,"stem":64},"Walkative 2.0 Global Booking Engine","/blog/case-study/walkative-2-booking-platform-case-study","blog/case-study/walkative-2-booking-platform-case-study",{"title":66,"path":67,"stem":68},"Why Merch Is the New Royalty Check, and How Tech Is Closing the Gap","/blog/case-study/why-merch-is-the-new-royalty-check","blog/case-study/why-merch-is-the-new-royalty-check",false,{"title":71,"path":72,"stem":73,"children":74,"page":69},"Music Data","/blog/music-data","blog/music-data",[75,79,83,87,91,95,99,103,107,111,115,119,123,127,131,135,139,143,147,151,155,159,163,167,171,175,179,183,187,191,195,199,203],{"title":76,"path":77,"stem":78},"13 Distributors, 5 File Formats, Zero Standards -The Reality of Music Royalty Data","/blog/music-data/13-distributors-5-file-formats-zero-standards-the-reality-of-music-royalty-data","blog/music-data/13-distributors-5-file-formats-zero-standards-the-reality-of-music-royalty-data",{"title":80,"path":81,"stem":82},"830 Ways to Say Spotify - Normalizing Music Streaming Data","/blog/music-data/830-ways-to-say-spotify-normalizing-music-streaming-data","blog/music-data/830-ways-to-say-spotify-normalizing-music-streaming-data",{"title":84,"path":85,"stem":86},"Why Music Companies Need AI-Powered Analytics (And How We Built One)","/blog/music-data/ai-powered-analytics-dashboard-django-clickhouse-ollama","blog/music-data/ai-powered-analytics-dashboard-django-clickhouse-ollama",{"title":88,"path":89,"stem":90},"AI Rehearsal: Spaced Repetition for Your Musical Ideas","/blog/music-data/ai-rehearsal-spaced-repetition-for-musical-ideas","blog/music-data/ai-rehearsal-spaced-repetition-for-musical-ideas",{"title":92,"path":93,"stem":94},"Audio Project Organization Is a Mess — Here's Why","/blog/music-data/audio-project-organization-mess","blog/music-data/audio-project-organization-mess",{"title":96,"path":97,"stem":98},"Why Audio Search Is Still Broken and How to Fix It with Embeddings","/blog/music-data/audio-search-broken-fix-with-embeddings","blog/music-data/audio-search-broken-fix-with-embeddings",{"title":100,"path":101,"stem":102},"AI Song Structure Analysis: Intro, Verse, Chorus","/blog/music-data/automatic-song-structure-analysis-how-ai-detects-intro-verse-chorus","blog/music-data/automatic-song-structure-analysis-how-ai-detects-intro-verse-chorus",{"title":104,"path":105,"stem":106},"The Broken Feedback Loop in Music Collaboration","/blog/music-data/broken-feedback-loop-music-collaboration","blog/music-data/broken-feedback-loop-music-collaboration",{"title":108,"path":109,"stem":110},"Building a Claude Skill for DDEX Validation: Automate Music Metadata Checks with AI","/blog/music-data/building-a-claude-skill-for-ddex-validation-music-metadata","blog/music-data/building-a-claude-skill-for-ddex-validation-music-metadata",{"title":112,"path":113,"stem":114},"Building a Custom Music Delivery Platform on the Revelator API","/blog/music-data/building-a-custom-music-delivery-platform-on-the-revelator-api","blog/music-data/building-a-custom-music-delivery-platform-on-the-revelator-api",{"title":116,"path":117,"stem":118},"Building a Suno AI Remix App with Nuxt & Firebase","/blog/music-data/building-a-suno-remix-app-with-nuxt-and-firebase","blog/music-data/building-a-suno-remix-app-with-nuxt-and-firebase",{"title":120,"path":121,"stem":122},"C2PA & DDEX: Authenticity Meets Rights in the Age of AI Music","/blog/music-data/c2pa-and-ddex-authenticity-meets-rights-in-the-age-of-ai-music","blog/music-data/c2pa-and-ddex-authenticity-meets-rights-in-the-age-of-ai-music",{"title":124,"path":125,"stem":126},"C2PA in Music: A Claude MCP for Reading Content Provenance","/blog/music-data/c2pa-in-music-mcp","blog/music-data/c2pa-in-music-mcp",{"title":128,"path":129,"stem":130},"Data Modeling in MongoDB Using Design Patterns","/blog/music-data/data-modeling-in-mongodb-with-the-usage-of-design-patterns","blog/music-data/data-modeling-in-mongodb-with-the-usage-of-design-patterns",{"title":132,"path":133,"stem":134},"Office Hours with MusicTech Lab's DDEX Expert","/blog/music-data/ddex-office-hours-musictech","blog/music-data/ddex-office-hours-musictech",{"title":136,"path":137,"stem":138},"DDEX Open Source Projects Review","/blog/music-data/ddex-open-source-projects-review","blog/music-data/ddex-open-source-projects-review",{"title":140,"path":141,"stem":142},"Extracting Data from Ableton .als and .asd Files","/blog/music-data/extracting-data-from-ableton-als-asd-files","blog/music-data/extracting-data-from-ableton-als-asd-files",{"title":144,"path":145,"stem":146},"Maciej Dulski on Sound Connections Podcast","/blog/music-data/from-startups-to-musictech-maciej-dulski-on-sound-connections-podcast","blog/music-data/from-startups-to-musictech-maciej-dulski-on-sound-connections-podcast",{"title":148,"path":149,"stem":150},"How to Transcribe Video to Text Using OpenAI Whisper","/blog/music-data/how-to-transcribe-video-to-text-using-whisper","blog/music-data/how-to-transcribe-video-to-text-using-whisper",{"title":152,"path":153,"stem":154},"Epidemic Sound MCP with Claude for Devs","/blog/music-data/how-to-use-epidemic-sound-mcp-with-claude","blog/music-data/how-to-use-epidemic-sound-mcp-with-claude",{"title":156,"path":157,"stem":158},"Hybrid Database Model in Django for Speed","/blog/music-data/hybrid-database-model-in-django-as-a-performance-booster","blog/music-data/hybrid-database-model-in-django-as-a-performance-booster",{"title":160,"path":161,"stem":162},"Introduction to generating DDEX file using Python","/blog/music-data/introduction-to-generating-ddex-file-using-python","blog/music-data/introduction-to-generating-ddex-file-using-python",{"title":164,"path":165,"stem":166},"Maintaining Music Tech Tools: The SLA Dilemma for Small Teams","/blog/music-data/maintaining-music-tech-tools-the-sla-dilemma-for-small-teams","blog/music-data/maintaining-music-tech-tools-the-sla-dilemma-for-small-teams",{"title":168,"path":169,"stem":170},"Querying Bandcamp Revenue Reports with Natural Language — Meet mtl-bandcamp-mcp","/blog/music-data/mtl-bandcamp-mcp-open-source-revenue-dashboard","blog/music-data/mtl-bandcamp-mcp-open-source-revenue-dashboard",{"title":172,"path":173,"stem":174},"mtl-metadata-mcp: Open Source Audio Metadata Embedding for Claude Code","/blog/music-data/mtl-metadata-mcp-open-source-audio-metadata-embedding","blog/music-data/mtl-metadata-mcp-open-source-audio-metadata-embedding",{"title":176,"path":177,"stem":178},"MusicTech Resources for Builders","/blog/music-data/musictech-resources-curated-insights-for-the-musictech-builders","blog/music-data/musictech-resources-curated-insights-for-the-musictech-builders",{"title":180,"path":181,"stem":182},"Poland's Creative Tech and MusicTech Rise","/blog/music-data/polands-creative-tech-sector-is-on-the-rise-and-musictech-is-part-of-it","blog/music-data/polands-creative-tech-sector-is-on-the-rise-and-musictech-is-part-of-it",{"title":184,"path":185,"stem":186},"Batch ISRC Enrichment That Turns Messy Catalogs Into Clean Data","/blog/music-data/scout-isrc-metadata-enrichment-spotify-musicbrainz","blog/music-data/scout-isrc-metadata-enrichment-spotify-musicbrainz",{"title":188,"path":189,"stem":190},"Music Self-Publishing: The Emuze.me Story","/blog/music-data/self-publishing-in-the-music-industry-a-tale-of-emuze-me","blog/music-data/self-publishing-in-the-music-industry-a-tale-of-emuze-me",{"title":192,"path":193,"stem":194},"Understanding the API First Approach","/blog/music-data/understanding-the-api-first-approach","blog/music-data/understanding-the-api-first-approach",{"title":196,"path":197,"stem":198},"The Voice Memo Graveyard Problem","/blog/music-data/voice-memo-graveyard-problem","blog/music-data/voice-memo-graveyard-problem",{"title":200,"path":201,"stem":202},"Which Database for Music Data? Redshift vs BigQuery vs ClickHouse and When to Use Each","/blog/music-data/which-database-for-music-data-redshift-vs-bigquery-vs-clickhouse","blog/music-data/which-database-for-music-data-redshift-vs-bigquery-vs-clickhouse",{"title":204,"path":205,"stem":206},"Why we decided to use wavesurfer.js","/blog/music-data/why-we-decided-to-use-wavesurfer","blog/music-data/why-we-decided-to-use-wavesurfer",{"title":208,"path":209,"stem":210,"children":211,"page":69},"Newsletter","/blog/newsletter","blog/newsletter",[212,216,220,224,228,232,236,240,244,248,252,256,260,264,268,272,276,280,284,288,292,296,300,304,308],{"title":213,"path":214,"stem":215},"Music Industry Tech Openings (April 2024 Update)","/blog/newsletter/music-industry-tech-openings-april-2024-update","blog/newsletter/music-industry-tech-openings-april-2024-update",{"title":217,"path":218,"stem":219},"Music Industry Tech Openings (April 2025 Update)","/blog/newsletter/music-industry-tech-openings-april-2025-update","blog/newsletter/music-industry-tech-openings-april-2025-update",{"title":221,"path":222,"stem":223},"Music Industry Tech Openings (August 2024 Update)","/blog/newsletter/music-industry-tech-openings-august-2024-update","blog/newsletter/music-industry-tech-openings-august-2024-update",{"title":225,"path":226,"stem":227},"Music Industry Tech Openings (December 2024 Update)","/blog/newsletter/music-industry-tech-openings-december-2024-update","blog/newsletter/music-industry-tech-openings-december-2024-update",{"title":229,"path":230,"stem":231},"Music Industry Tech Openings (February 2025 Update)","/blog/newsletter/music-industry-tech-openings-february-2025-update","blog/newsletter/music-industry-tech-openings-february-2025-update",{"title":233,"path":234,"stem":235},"Music Industry Tech Openings (January 2025 Update)","/blog/newsletter/music-industry-tech-openings-january-2025-update","blog/newsletter/music-industry-tech-openings-january-2025-update",{"title":237,"path":238,"stem":239},"Music Industry Tech Openings (July 2024 Update)","/blog/newsletter/music-industry-tech-openings-july-2024-update","blog/newsletter/music-industry-tech-openings-july-2024-update",{"title":241,"path":242,"stem":243},"Music Industry Tech Openings (June 2024 Update)","/blog/newsletter/music-industry-tech-openings-june-2024-update","blog/newsletter/music-industry-tech-openings-june-2024-update",{"title":245,"path":246,"stem":247},"Music Industry Tech Openings (March 2025 Update)","/blog/newsletter/music-industry-tech-openings-march-2025-update","blog/newsletter/music-industry-tech-openings-march-2025-update",{"title":249,"path":250,"stem":251},"Music Industry Tech Openings (May 2024 Update)","/blog/newsletter/music-industry-tech-openings-may-2024-update","blog/newsletter/music-industry-tech-openings-may-2024-update",{"title":253,"path":254,"stem":255},"Music Industry Tech Openings (May 2025 Update)","/blog/newsletter/music-industry-tech-openings-may-2025","blog/newsletter/music-industry-tech-openings-may-2025",{"title":257,"path":258,"stem":259},"Music Industry Tech Openings (November 2024 Update)","/blog/newsletter/music-industry-tech-openings-november-2024-update","blog/newsletter/music-industry-tech-openings-november-2024-update",{"title":261,"path":262,"stem":263},"Music Industry Tech Openings (October 2024 Update)","/blog/newsletter/music-industry-tech-openings-october-2024-update","blog/newsletter/music-industry-tech-openings-october-2024-update",{"title":265,"path":266,"stem":267},"Music Industry Tech Openings (September 2024 Update)","/blog/newsletter/music-industry-tech-openings-september-2024-update","blog/newsletter/music-industry-tech-openings-september-2024-update",{"title":269,"path":270,"stem":271},"MusicTech Insights #1 by Maciej Dulski","/blog/newsletter/musictech-insights-1-curated-by-maciej-dulski","blog/newsletter/musictech-insights-1-curated-by-maciej-dulski",{"title":273,"path":274,"stem":275},"Provenance, Not Detection, Is the Durable Answer","/blog/newsletter/musictech-insights-10-curated-by-jim-anderson","blog/newsletter/musictech-insights-10-curated-by-jim-anderson",{"title":277,"path":278,"stem":279},"What CMOs can teach us about innovation in uncertain times","/blog/newsletter/musictech-insights-10-curated-by-joanna-kurkowska","blog/newsletter/musictech-insights-10-curated-by-joanna-kurkowska",{"title":281,"path":282,"stem":283},"Feeling the MusicTech Momentum","/blog/newsletter/musictech-insights-2-curated-by-maciej-dulski","blog/newsletter/musictech-insights-2-curated-by-maciej-dulski",{"title":285,"path":286,"stem":287},"AI in Music: Hype, Hope, and a Human Touch","/blog/newsletter/musictech-insights-3-curated-by-drew-thurlow","blog/newsletter/musictech-insights-3-curated-by-drew-thurlow",{"title":289,"path":290,"stem":291},"The Music Metadata Conundrum","/blog/newsletter/musictech-insights-4-curated-by-amanda-schupf","blog/newsletter/musictech-insights-4-curated-by-amanda-schupf",{"title":293,"path":294,"stem":295},"7 Rounds in the First 10 Days of November 2025","/blog/newsletter/musictech-insights-5-curated-by-maciej-dulski","blog/newsletter/musictech-insights-5-curated-by-maciej-dulski",{"title":297,"path":298,"stem":299},"The End of an Era: It's All About to Crash","/blog/newsletter/musictech-insights-6-curated-by-sigurdur-arnason","blog/newsletter/musictech-insights-6-curated-by-sigurdur-arnason",{"title":301,"path":302,"stem":303},"Low-Code Magic Won't Solve MusicTech Reality","/blog/newsletter/musictech-insights-7-curated-by-mariusz-smenzyk","blog/newsletter/musictech-insights-7-curated-by-mariusz-smenzyk",{"title":305,"path":306,"stem":307},"The New Economics of Game Music","/blog/newsletter/musictech-insights-8-curated-by-kenny-vaughan","blog/newsletter/musictech-insights-8-curated-by-kenny-vaughan",{"title":309,"path":310,"stem":311},"Music Business Meets Direct-to-Fan","/blog/newsletter/musictech-insights-9-curated-by-yaw-asamani","blog/newsletter/musictech-insights-9-curated-by-yaw-asamani",{"title":313,"path":314,"stem":315,"children":316,"page":69},"Software Development","/blog/software-development","blog/software-development",[317,321,325,329,333,337,341,345,349,353,357,361,365,369,373,377,381,385,389,393,397,401,405,409,413,417,421,425,429,433,437,441,445,449,453,457,461,465,469,473,477,481,485,489,493,497,501,505,509,513,517,521,525,529,533,537,541,545,549,553,557,561,565,569,573,577,581,585,589,593,597,601,605,609,613,617,621,625,629,633,637,641,645,649,653,657,661,665,669,673,677,681,685,689,693,697,701,705,709,713,717],{"title":318,"path":319,"stem":320},"Benefits of Outsourcing Software Development","/blog/software-development/10-benefits-of-outsourcing-software-development-services","blog/software-development/10-benefits-of-outsourcing-software-development-services",{"title":322,"path":323,"stem":324},"10 Steps to Find the Best MVP Developers","/blog/software-development/10-steps-to-find-the-best-mvp-developers-for-your-startup-idea","blog/software-development/10-steps-to-find-the-best-mvp-developers-for-your-startup-idea",{"title":326,"path":327,"stem":328},"1,200 Looms Later: How Async Video Became My Development Superpower","/blog/software-development/1200-looms-how-async-video-became-our-development-superpower","blog/software-development/1200-looms-how-async-video-became-our-development-superpower",{"title":330,"path":331,"stem":332},"Communication Strategy in Outsourcing Projects","/blog/software-development/5-steps-to-implement-an-effective-communication-strategy-in-outsourcing-software-development-project","blog/software-development/5-steps-to-implement-an-effective-communication-strategy-in-outsourcing-software-development-project",{"title":334,"path":335,"stem":336},"7 Best Practices for Outsourcing Software Development","/blog/software-development/7-best-practices-for-outsourcing-software-development","blog/software-development/7-best-practices-for-outsourcing-software-development",{"title":338,"path":339,"stem":340},"9 Reasons Why Saleor.io Is Best for eCommerce","/blog/software-development/9-reasons-why-the-saleor-io-platform-is-the-best-choice-for-your-ecommerce-website","blog/software-development/9-reasons-why-the-saleor-io-platform-is-the-best-choice-for-your-ecommerce-website",{"title":342,"path":343,"stem":344},"A Look at Bravelab.io’s Clutch 2021 Year In Review","/blog/software-development/a-look-at-bravelab-ios-clutch-2021-year-in-review","blog/software-development/a-look-at-bravelab-ios-clutch-2021-year-in-review",{"title":346,"path":347,"stem":348},"A quick introduction to profit sharing implementation","/blog/software-development/a-quick-introduction-to-profit-sharing-implementation","blog/software-development/a-quick-introduction-to-profit-sharing-implementation",{"title":350,"path":351,"stem":352},"AI Audio Similarity Search: The Future of Sound Library Discovery","/blog/software-development/ai-audio-similarity-search-for-sound-libraries","blog/software-development/ai-audio-similarity-search-for-sound-libraries",{"title":354,"path":355,"stem":356},"Automate Repetitive Tasks for Better Results","/blog/software-development/automate-repetitive-tasks-to-improve-your-business-performance","blog/software-development/automate-repetitive-tasks-to-improve-your-business-performance",{"title":358,"path":359,"stem":360},"Automating Success: The Art of Unified Documentation","/blog/software-development/automating-success-the-art-of-unified-documentation","blog/software-development/automating-success-the-art-of-unified-documentation",{"title":362,"path":363,"stem":364},"Brave 3.0 Website Redesign, Part 2: Solution","/blog/software-development/brave-3-0-how-we-conducted-website-redesign-part-2-solution","blog/software-development/brave-3-0-how-we-conducted-website-redesign-part-2-solution",{"title":366,"path":367,"stem":368},"Brave 3.0, Part 4: Tech Stack and Recap","/blog/software-development/brave-3-0-part-4-technologies-behind-and-final-series-recap","blog/software-development/brave-3-0-part-4-technologies-behind-and-final-series-recap",{"title":370,"path":371,"stem":372},"Brave 3.0 – redesign process part 1. The Challenge","/blog/software-development/brave-3-0-redesign-process-part-1-challenge","blog/software-development/brave-3-0-redesign-process-part-1-challenge",{"title":374,"path":375,"stem":376},"Brave 3.0 – redesign process, part 3. Lesson learned","/blog/software-development/brave-3-0-redesign-process-part-3-lesson-learned","blog/software-development/brave-3-0-redesign-process-part-3-lesson-learned",{"title":378,"path":379,"stem":380},"Bravelab.io: Top Software Developer by Clutch","/blog/software-development/bravelab-io-is-recognized-as-a-top-custom-software-developer-by-clutch","blog/software-development/bravelab-io-is-recognized-as-a-top-custom-software-developer-by-clutch",{"title":382,"path":383,"stem":384},"Bravelab.io: Top Developer in Poland by Clutch","/blog/software-development/bravelab-io-named-top-software-developer-in-poland-by-clutch","blog/software-development/bravelab-io-named-top-software-developer-in-poland-by-clutch",{"title":386,"path":387,"stem":388},"MusicTech Lab Partners with LALAL.AI","/blog/software-development/bravelab-partners-with-the-audio-lalal-ai","blog/software-development/bravelab-partners-with-the-audio-lalal-ai",{"title":390,"path":391,"stem":392},"MusicTech Lab Partners with The Audio Programmer","/blog/software-development/bravelab-partners-with-the-audio-programmer","blog/software-development/bravelab-partners-with-the-audio-programmer",{"title":394,"path":395,"stem":396},"Bravelab's team about productivity","/blog/software-development/bravelabs-team-about-productivity","blog/software-development/bravelabs-team-about-productivity",{"title":398,"path":399,"stem":400},"Braveloper","/blog/software-development/braveloper","blog/software-development/braveloper",{"title":402,"path":403,"stem":404},"Bravely App: Boost Productivity with Django","/blog/software-development/bravely-app-how-to-be-more-productive-with-django-quick","blog/software-development/bravely-app-how-to-be-more-productive-with-django-quick",{"title":406,"path":407,"stem":408},"DIY MIDI Controller for Ableton with Arduino","/blog/software-development/building-a-diy-midi-controller-for-ableton-live-with-arduino","blog/software-development/building-a-diy-midi-controller-for-ableton-live-with-arduino",{"title":410,"path":411,"stem":412},"C2PA in Ableton: Making AI Music Provenance Visible Inside Your DAW","/blog/software-development/c2pa-in-ableton-max-for-live","blog/software-development/c2pa-in-ableton-max-for-live",{"title":414,"path":415,"stem":416},"Change Detection mechanism in Angular","/blog/software-development/change-detection-mechanism-in-angular","blog/software-development/change-detection-mechanism-in-angular",{"title":418,"path":419,"stem":420},"Communication Channels in Remote Work","/blog/software-development/comparison-of-the-communication-channels-in-remote-work","blog/software-development/comparison-of-the-communication-channels-in-remote-work",{"title":422,"path":423,"stem":424},"Connecting Your Max for Live Device to a Cloud API","/blog/software-development/connecting-your-max-for-live-device-to-a-cloud-api","blog/software-development/connecting-your-max-for-live-device-to-a-cloud-api",{"title":426,"path":427,"stem":428},"From Voice Memo to Studio: The Cross-Platform Problem for Creators","/blog/software-development/cross-platform-problem-for-creators","blog/software-development/cross-platform-problem-for-creators",{"title":430,"path":431,"stem":432},"Cultural transformation through the pandemic era","/blog/software-development/cultural-transformation-through-the-pandemic-era","blog/software-development/cultural-transformation-through-the-pandemic-era",{"title":434,"path":435,"stem":436},"D-Commerce Decoded: Cutting Through the Hype","/blog/software-development/d-commerce-decoded-cutting-through-the-hype","blog/software-development/d-commerce-decoded-cutting-through-the-hype",{"title":438,"path":439,"stem":440},"Dev Meeting 002: Intro to DDD","/blog/software-development/dev-meeting-002-introduction-to-domain-driven-design-ddd","blog/software-development/dev-meeting-002-introduction-to-domain-driven-design-ddd",{"title":442,"path":443,"stem":444},"Dev Meeting 003: Web3 Primer","/blog/software-development/dev-meeting-003-web3-primer","blog/software-development/dev-meeting-003-web3-primer",{"title":446,"path":447,"stem":448},"Dev Meeting 004: Introduction to Event Storming","/blog/software-development/dev-meeting-004-introduction-to-event-storming","blog/software-development/dev-meeting-004-introduction-to-event-storming",{"title":450,"path":451,"stem":452},"Dev Meeting 001: Kubernetes is a Framework","/blog/software-development/dev-meeting-kubernetes-is-a-framework","blog/software-development/dev-meeting-kubernetes-is-a-framework",{"title":454,"path":455,"stem":456},"Did You Know? 10 Developer Tips from Real Codebases","/blog/software-development/did-you-know-dev-tips-part-1","blog/software-development/did-you-know-dev-tips-part-1",{"title":458,"path":459,"stem":460},"10 Surprising MusicTech Facts (Part 2)","/blog/software-development/did-you-know-musictech-facts-part-2","blog/software-development/did-you-know-musictech-facts-part-2",{"title":462,"path":463,"stem":464},"Django-cms and GraphQL","/blog/software-development/django-cms-and-graphql","blog/software-development/django-cms-and-graphql",{"title":466,"path":467,"stem":468},"Does Zappa make it super easy?","/blog/software-development/does-zappa-make-it-super-easy","blog/software-development/does-zappa-make-it-super-easy",{"title":470,"path":471,"stem":472},"Establishing cooperation between Netlify and Bravelab","/blog/software-development/establishing-cooperation-between-netlify-and-bravelab","blog/software-development/establishing-cooperation-between-netlify-and-bravelab",{"title":474,"path":475,"stem":476},"Export Ableton Locators to JSON via Max for Live","/blog/software-development/exporting-ableton-live-locators-to-json-with-max-for-live","blog/software-development/exporting-ableton-live-locators-to-json-with-max-for-live",{"title":478,"path":479,"stem":480},"IT Outsourcing: Success and Failure Factors","/blog/software-development/factors-that-contribute-to-the-success-or-failure-of-an-it-outsourcing-project","blog/software-development/factors-that-contribute-to-the-success-or-failure-of-an-it-outsourcing-project",{"title":482,"path":483,"stem":484},"Flutter 2022 Strategy: Analyzing the Roadmap","/blog/software-development/flutter-strategy-for-2022-analyzing-the-new-flutter-roadmap","blog/software-development/flutter-strategy-for-2022-analyzing-the-new-flutter-roadmap",{"title":486,"path":487,"stem":488},"Git Better #1 — Commit Message Convention","/blog/software-development/git-better-1-see-more-with-a-commit-message-convention","blog/software-development/git-better-1-see-more-with-a-commit-message-convention",{"title":490,"path":491,"stem":492},"Hasura in action. How to use it with Django","/blog/software-development/hasura-in-action","blog/software-development/hasura-in-action",{"title":494,"path":495,"stem":496},"Holacracy why and where we are","/blog/software-development/holacracy-why-and-where-we-are","blog/software-development/holacracy-why-and-where-we-are",{"title":498,"path":499,"stem":500},"How does JavaScript work","/blog/software-development/how-does-javascript-work","blog/software-development/how-does-javascript-work",{"title":502,"path":503,"stem":504},"How important is good UX/UI design?","/blog/software-development/how-important-is-good-ux-ui-design","blog/software-development/how-important-is-good-ux-ui-design",{"title":506,"path":507,"stem":508},"How repetitive tasks impact your business","/blog/software-development/how-repetitive-tasks-impact-your-business","blog/software-development/how-repetitive-tasks-impact-your-business",{"title":510,"path":511,"stem":512},"Becoming a Vue.js Dev: Do Paid Trials Work?","/blog/software-development/how-to-become-a-vue-js-developer-and-whether-paid-trials-in-it-work-out","blog/software-development/how-to-become-a-vue-js-developer-and-whether-paid-trials-in-it-work-out",{"title":514,"path":515,"stem":516},"How to Build an MVP in 6 Steps","/blog/software-development/how-to-build-a-minimum-viable-product-mvp-in-6-steps","blog/software-development/how-to-build-a-minimum-viable-product-mvp-in-6-steps",{"title":518,"path":519,"stem":520},"How to conduct workshops for creative industry?","/blog/software-development/how-to-conduct-workshops-for-creative-industry","blog/software-development/how-to-conduct-workshops-for-creative-industry",{"title":522,"path":523,"stem":524},"How to easily create form in Angular","/blog/software-development/how-to-easily-create-form-in-angular","blog/software-development/how-to-easily-create-form-in-angular",{"title":526,"path":527,"stem":528},"How to export orders in Saleor.io to XLSX file","/blog/software-development/how-to-export-orders-in-saleor-io-to-xlsx-file","blog/software-development/how-to-export-orders-in-saleor-io-to-xlsx-file",{"title":530,"path":531,"stem":532},"Handling High Loads on E-Commerce Platforms","/blog/software-development/how-to-handle-high-loads-on-e-commerce-platform-with-ease","blog/software-development/how-to-handle-high-loads-on-e-commerce-platform-with-ease",{"title":534,"path":535,"stem":536},"How to launch Saleor.io shop instance within 40h","/blog/software-development/how-to-launch-saleor-io-shop-instance-within-40h","blog/software-development/how-to-launch-saleor-io-shop-instance-within-40h",{"title":538,"path":539,"stem":540},"First Steps to Build a Business Relationship","/blog/software-development/how-to-make-the-first-step-to-establish-a-business-relationship","blog/software-development/how-to-make-the-first-step-to-establish-a-business-relationship",{"title":542,"path":543,"stem":544},"Multi-Tenant Apps with Django and Saleor.io","/blog/software-development/how-to-manage-tenants-in-the-multitenant-app-based-on-django-tenants-and-saleor-io-platform","blog/software-development/how-to-manage-tenants-in-the-multitenant-app-based-on-django-tenants-and-saleor-io-platform",{"title":546,"path":547,"stem":548},"Notion Backup Tool Built in 3 Days with Python","/blog/software-development/how-we-built-a-notion-backup-tool-in-3-days-with-pythonvue-and-why","blog/software-development/how-we-built-a-notion-backup-tool-in-3-days-with-pythonvue-and-why",{"title":550,"path":551,"stem":552},"Important new features in Python 3.8","/blog/software-development/important-new-features-in-python-3-8","blog/software-development/important-new-features-in-python-3-8",{"title":554,"path":555,"stem":556},"Installing Proxmox on dedicated server from OVH","/blog/software-development/installing-proxmox-on-dedicated-server-from-ovh","blog/software-development/installing-proxmox-on-dedicated-server-from-ovh",{"title":558,"path":559,"stem":560},"Integrating SignNow E-Signatures into Your Django Application","/blog/software-development/integrating-signnow-e-signatures-into-your-django-application","blog/software-development/integrating-signnow-e-signatures-into-your-django-application",{"title":562,"path":563,"stem":564},"Tempus Metronome and GetSongBPM API","/blog/software-development/integrating-tempus-metronome-with-the-getsongbpm-api-what-bpm-really-means-and-how-to-use-it","blog/software-development/integrating-tempus-metronome-with-the-getsongbpm-api-what-bpm-really-means-and-how-to-use-it",{"title":566,"path":567,"stem":568},"Introducing MusicTech Poland","/blog/software-development/introducing-musictech-poland","blog/software-development/introducing-musictech-poland",{"title":570,"path":571,"stem":572},"Vue.js as a Frontend for Saleor.io","/blog/software-development/is-it-possible-to-use-vue-js-as-a-frontend-for-saleor-io-platform","blog/software-development/is-it-possible-to-use-vue-js-as-a-frontend-for-saleor-io-platform",{"title":574,"path":575,"stem":576},"Is your business ready for the cashless era?","/blog/software-development/is-your-business-ready-for-the-cashless-era","blog/software-development/is-your-business-ready-for-the-cashless-era",{"title":578,"path":579,"stem":580},"Is your face ready to buy?","/blog/software-development/is-your-face-ready-to-buy","blog/software-development/is-your-face-ready-to-buy",{"title":582,"path":583,"stem":584},"JS Frameworks: Trends and Opportunities","/blog/software-development/javascript-trending-frameworks-and-market-opportunities","blog/software-development/javascript-trending-frameworks-and-market-opportunities",{"title":586,"path":587,"stem":588},"Kanban Board: Boost Your Team Productivity","/blog/software-development/kanban-board-methodology-hack-your-companys-productivity","blog/software-development/kanban-board-methodology-hack-your-companys-productivity",{"title":590,"path":591,"stem":592},"Verified Human Cert MCP Server: Prove Your Music Is Human-Made, Right from the Terminal","/blog/software-development/mcp-verified-human-cert-open-source","blog/software-development/mcp-verified-human-cert-open-source",{"title":594,"path":595,"stem":596},"Migrating from TravisCI to Github Actions","/blog/software-development/migrating-from-travisci-to-github-actions","blog/software-development/migrating-from-travisci-to-github-actions",{"title":598,"path":599,"stem":600},"MusicTech Lab: Top Software Developer by Clutch","/blog/software-development/musictechlab-is-recognized-as-a-top-custom-software-developer-by-clutch","blog/software-development/musictechlab-is-recognized-as-a-top-custom-software-developer-by-clutch",{"title":602,"path":603,"stem":604},"MusicTech Lab x Verified Human: Building a Trust Layer for Human-Made Music","/blog/software-development/musictechlab_blog_verified_human_partnership","blog/software-development/musictechlab_blog_verified_human_partnership",{"title":606,"path":607,"stem":608},"MusicXML: Standard for Music Notation","/blog/software-development/musicxml-standard-for-music-notation-and-education","blog/software-development/musicxml-standard-for-music-notation-and-education",{"title":610,"path":611,"stem":612},"Only a few books but dozens of ideas","/blog/software-development/only-a-few-books-but-dozens-of-ideas","blog/software-development/only-a-few-books-but-dozens-of-ideas",{"title":614,"path":615,"stem":616},"Overdue Invoices and Issue Tracker Integration","/blog/software-development/overdue-invoices-integration-with-the-issue-tracking-system","blog/software-development/overdue-invoices-integration-with-the-issue-tracking-system",{"title":618,"path":619,"stem":620},"Performing SAML SSO using JWT in Django","/blog/software-development/performing-saml-sso-using-jwt-in-django","blog/software-development/performing-saml-sso-using-jwt-in-django",{"title":622,"path":623,"stem":624},"Progressive Web Apps for Mobile Development","/blog/software-development/progressive-web-apps-a-new-way-of-creating-mobile-application","blog/software-development/progressive-web-apps-a-new-way-of-creating-mobile-application",{"title":626,"path":627,"stem":628},"Recruitment System: Gmail, Jira, and CRM","/blog/software-development/recruitment-system-integrating-gmail-bravely-jira-slack-and-copper-crm","blog/software-development/recruitment-system-integrating-gmail-bravely-jira-slack-and-copper-crm",{"title":630,"path":631,"stem":632},"Scratch Me: Chrome Extension for Leads","/blog/software-development/scratch-me-a-simple-chrome-extension-which-will-increase-your-productivity","blog/software-development/scratch-me-a-simple-chrome-extension-which-will-increase-your-productivity",{"title":634,"path":635,"stem":636},"Scratch Me – integration with the Copper CRM","/blog/software-development/scratch-me-integration-with-the-copper-crm","blog/software-development/scratch-me-integration-with-the-copper-crm",{"title":638,"path":639,"stem":640},"SignNow MCP Server: E-Signatures Straight from Claude Code","/blog/software-development/signnow-mcp-server-e-signatures-from-claude-code","blog/software-development/signnow-mcp-server-e-signatures-from-claude-code",{"title":642,"path":643,"stem":644},"Music Industry Tech Openings (March 2024 Update)","/blog/software-development/technical-job-opportunities-in-the-music-industry","blog/software-development/technical-job-opportunities-in-the-music-industry",{"title":646,"path":647,"stem":648},"Thanks app – a Management 3.0 solution","/blog/software-development/thanks-app-a-management-3-0-solution","blog/software-development/thanks-app-a-management-3-0-solution",{"title":650,"path":651,"stem":652},"Colonial Pipeline Case: 7 Security Reminders","/blog/software-development/the-case-of-colonial-pipeline-and-7-security-reminders","blog/software-development/the-case-of-colonial-pipeline-and-7-security-reminders",{"title":654,"path":655,"stem":656},"The Evolution and Future of E-commerce Platforms","/blog/software-development/the-evolution-and-future-of-e-commerce-platforms","blog/software-development/the-evolution-and-future-of-e-commerce-platforms",{"title":658,"path":659,"stem":660},"The Gender Gap in the Tech Industry","/blog/software-development/the-gender-gap-in-the-tech-industry","blog/software-development/the-gender-gap-in-the-tech-industry",{"title":662,"path":663,"stem":664},"First Attempt to Implement 4DX at Bravelab.io","/blog/software-development/the-very-first-attempt-to-implement-4dx-in-bravelab-io","blog/software-development/the-very-first-attempt-to-implement-4dx-in-bravelab-io",{"title":666,"path":667,"stem":668},"The WTF Scale: IT Project Complexity","/blog/software-development/the-wtf-programming-scale-measuring-it-project-complexity","blog/software-development/the-wtf-programming-scale-measuring-it-project-complexity",{"title":670,"path":671,"stem":672},"Top 10 articles through the eyes of our developers","/blog/software-development/top-10-articles-through-the-eyes-of-our-developers","blog/software-development/top-10-articles-through-the-eyes-of-our-developers",{"title":674,"path":675,"stem":676},"Top 6 apps made with Flutter","/blog/software-development/top-6-apps-made-with-flutter","blog/software-development/top-6-apps-made-with-flutter",{"title":678,"path":679,"stem":680},"Uber 101: How Uber Made It to the Top","/blog/software-development/uber-101-how-this-ride-sharing-behemoth-made-it-to-the-top","blog/software-development/uber-101-how-this-ride-sharing-behemoth-made-it-to-the-top",{"title":682,"path":683,"stem":684},"MusicTech Lab Partners with Music Glue","/blog/software-development/unifying-artists-and-audiences-exploring-music-glue","blog/software-development/unifying-artists-and-audiences-exploring-music-glue",{"title":686,"path":687,"stem":688},"Why AI Will Defeat Traditional HR","/blog/software-development/warning-why-artificial-intelligence-will-defeat-traditional-hr","blog/software-development/warning-why-artificial-intelligence-will-defeat-traditional-hr",{"title":690,"path":691,"stem":692},"What is a Discovery Document?","/blog/software-development/what-is-discovery-document","blog/software-development/what-is-discovery-document",{"title":694,"path":695,"stem":696},"What is Flutter, and Why is it Worth Considering?","/blog/software-development/what-is-flutter-and-why-is-it-worth-considering","blog/software-development/what-is-flutter-and-why-is-it-worth-considering",{"title":698,"path":699,"stem":700},"What is a Watermarked Song?","/blog/software-development/what-is-watermarked-song","blog/software-development/what-is-watermarked-song",{"title":702,"path":703,"stem":704},"Choosing a Frontend Framework for the Web","/blog/software-development/which-framework-should-you-choose-for-the-frontend-web-platform-development","blog/software-development/which-framework-should-you-choose-for-the-frontend-web-platform-development",{"title":706,"path":707,"stem":708},"Why DAWs Are the Wrong Tool for Starting a Song","/blog/software-development/why-daws-wrong-tool-for-starting-song","blog/software-development/why-daws-wrong-tool-for-starting-song",{"title":710,"path":711,"stem":712},"Why the Programming World Loves Python","/blog/software-development/why-the-programming-world-loves-python","blog/software-development/why-the-programming-world-loves-python",{"title":714,"path":715,"stem":716},"Why We Don't Build Chat From Scratch (And Neither Should You)","/blog/software-development/why-we-dont-build-chat-from-scratch","blog/software-development/why-we-dont-build-chat-from-scratch",{"title":718,"path":719,"stem":720},"Why we use Sanity.io","/blog/software-development/why-we-use-sanity-io","blog/software-development/why-we-use-sanity-io",{"title":722,"path":723,"stem":724,"children":725,"page":69},"Sportstech","/blog/sportstech","blog/sportstech",[726,730],{"title":727,"path":728,"stem":729},"BeatBuddy Replay: Video Analysis App Challenges","/blog/sportstech/beatbuddy-replay-video-analysis-app-for-swimmers-flutter","blog/sportstech/beatbuddy-replay-video-analysis-app-for-swimmers-flutter",{"title":731,"path":732,"stem":733},"How to Create a Watch Face App for Garmin Watch","/blog/sportstech/how-to-create-watch-face-app-for-garmin-watch","blog/sportstech/how-to-create-watch-face-app-for-garmin-watch",{"id":735,"title":204,"authors":736,"badge":741,"body":742,"category":911,"client":741,"date":912,"description":913,"extension":914,"faq":741,"featured":69,"featuredOrder":741,"hidden":69,"image":915,"keyTakeaways":917,"meta":929,"navigation":918,"path":205,"seo":930,"status":741,"stem":206,"tags":931,"teaser":741,"__hash__":935},"posts/blog/music-data/why-we-decided-to-use-wavesurfer.md",[737],{"name":738,"avatar":739},"Mateusz Bryzik",{"src":740},"/images/people/mateusz-bryzik.webp",null,{"type":743,"value":744,"toc":901},"minimark",[745,750,754,779,783,786,790,793,799,803,814,831,834,838,850,864,867,871,877,880],[746,747,749],"h2",{"id":748},"the-main-challenge","The main challenge",[751,752,753],"p",{},"In one of our projects, we faced the business requirement to create a custom audio player — nothing complex, with several controls: play, pause, previous and next track, and changing volume. The challenge was the player should also be responsible for drawing the audio spectrum.",[755,756,763,769,774],"div",{"className":757},[758,759,760,761,762],"grid","grid-cols-1","md:grid-cols-3","gap-4","my-8",[764,765],"spotlight-card",{"description":766,"icon":767,"title":768},"Play, pause, previous/next track, volume control.","i-lucide-play","Playback Controls",[764,770],{"description":771,"icon":772,"title":773},"Visual representation of the audio signal drawn in real time.","i-lucide-audio-waveform","Waveform Spectrum",[764,775],{"description":776,"icon":777,"title":778},"Must match our existing UI — no generic player widgets.","i-lucide-paintbrush","Custom Design",[746,780,782],{"id":781},"available-solutions","Available solutions",[751,784,785],{},"Building a basic audio player with the browser's Audio API is straightforward. Drawing a waveform spectrum is where it gets complex. There are algorithms available on the web, but adjusting them to specific designs and interactions is time-consuming. We decided to look for a ready-made library.",[746,787,789],{"id":788},"does-a-vuejs-audio-player-library-exist","Does a Vue.js Audio Player library exist?",[751,791,792],{},"At MusicTech Lab, our standard frontend stack is Vue.js. Our first idea was to find a Vue.js audio library. Unfortunately, none of the available options matched our needs — some could play tracks and draw a spectrum, but customising them to our designs was impossible. Time was running out, and we had only a few weeks to close this topic.",[794,795,796],"warning",{},[751,797,798],{},"We evaluated several Vue.js audio libraries, but none offered the combination of waveform rendering and design flexibility we needed. Most were either too opinionated in their UI or lacked spectrum visualisation entirely.",[746,800,802],{"id":801},"our-solution-wavesurferjs","Our solution: WaveSurfer.js",[751,804,805,806,813],{},"Finally, we found ",[807,808,812],"a",{"href":809,"rel":810},"https://wavesurfer-js.org/",[811],"nofollow","WaveSurfer.js"," — a customisable audio spectrum visualisation library based on the Audio API and HTML5 Canvas. With over ten years of development, it was a proven candidate.",[755,815,817,821,826],{"className":816},[758,759,760,761,762],[764,818],{"description":819,"icon":820,"title":768},"Play, pause, switch tracks, volume — all supported out of the box.","i-lucide-circle-play",[764,822],{"description":823,"icon":824,"title":825},"Fully customisable spectrum — colours, height, progress bar, container size.","i-lucide-palette","Waveform Rendering",[764,827],{"description":828,"icon":829,"title":830},"Extend functionality with plugins like Regions, Timeline, and Minimap.","i-lucide-puzzle","Plugin System",[751,832,833],{},"We quickly configured the waveform container — height, width, colours for the wave and progress — and it matched our designs. A few lines of configuration replaced hundreds of lines of custom code.",[746,835,837],{"id":836},"the-regions-plugin","The Regions Plugin",[751,839,840,841,845,846,849],{},"Our business requirement was to let users play ",[842,843,844],"strong",{},"hooks"," — specific parts of a track like a chorus or guitar riff, highlighted on the spectrum. The ",[842,847,848],{},"Regions"," plugin was exactly what we needed.",[755,851,854,859],{"className":852},[758,759,853,761,762],"md:grid-cols-2",[764,855],{"description":856,"icon":857,"title":858},"Creates highlighted regions on the waveform that can be resized, moved, and played in a loop.","i-lucide-scissors","Visual Markers",[764,860],{"description":861,"icon":862,"title":863},"Users select a hook — chorus, riff, intro — and the Regions plugin handles looped playback of that segment.","i-lucide-repeat","Loop Playback",[751,865,866],{},"The hook menu above the spectrum is a custom component, but the hook highlighting and playback is fully powered by the Regions plugin.",[746,868,870],{"id":869},"result","Result",[872,873,874],"tip",{},[751,875,876],{},"WaveSurfer.js saved us significant development time. The configuration is simple, the library is stable, and you can achieve what you need quickly. The only downside is the documentation — it could use more examples for advanced methods.",[751,878,879],{},"We recommend this library to anyone building a similar audio component.",[755,881,886,892,897],{"className":882},[883,884,885,762],"flex","flex-wrap","gap-3",[887,888],"u-button",{"color":889,"label":812,"target":890,"to":809,"variant":891},"primary","_blank","subtle",[887,893],{"color":894,"label":895,"target":890,"to":896,"variant":891},"neutral","Plugins","https://wavesurfer-js.org/plugins/",[887,898],{"color":894,"label":899,"target":890,"to":900,"variant":891},"GitHub","https://github.com/katspaugh/wavesurfer.js",{"title":902,"searchDepth":903,"depth":903,"links":904},"",2,[905,906,907,908,909,910],{"id":748,"depth":903,"text":749},{"id":781,"depth":903,"text":782},{"id":788,"depth":903,"text":789},{"id":801,"depth":903,"text":802},{"id":836,"depth":903,"text":837},{"id":869,"depth":903,"text":870},"music-data","2022-07-05T00:00:00.000Z","Creating a simple, custom audio player with main functionality is relatively easy. Are you sure? Let's see how we tackled this issue","md",{"src":916},"/images/blog/musictechlab_blog_why-we-decided-to-use-wavesurfer.webp",{"enabled":918,"items":919},true,[920,923,926],{"text":921,"icon":922},"WaveSurfer.js replaced hundreds of lines of custom waveform code with a few config lines.","i-lucide-code",{"text":924,"icon":925},"The Regions plugin handles hook highlighting and looped playback out of the box.","i-lucide-headphones",{"text":927,"icon":928},"No Vue.js audio library offered both waveform rendering and design flexibility.","i-lucide-search",{},{"title":204,"description":913},[932,933,934],"music-production","development","audio-analysis","X1tV_GLxKKa2kXdZt19ajJ2Me10bpOEFQWfvwqnY8j4",[937,939],{"title":200,"path":201,"stem":202,"description":938,"children":-1},"A practical comparison of BigQuery, Redshift, and ClickHouse for music industry workloads, from royalty reporting to real-time streaming analytics.",{"title":213,"path":214,"stem":215,"description":940,"children":-1},"Curated list of tech job openings in the music industry for April 2024. Explore roles at music startups, labels, streaming platforms, and more.",[942,2809,4738,7018],{"id":943,"title":140,"authors":944,"badge":950,"body":953,"category":911,"client":741,"date":2786,"description":2787,"extension":914,"faq":741,"featured":69,"featuredOrder":741,"hidden":69,"image":2788,"keyTakeaways":2790,"meta":2804,"navigation":918,"path":141,"seo":2805,"status":741,"stem":142,"tags":2806,"teaser":741,"__hash__":2808,"score":1304},"posts/blog/music-data/extracting-data-from-ableton-als-asd-files.md",[945],{"name":946,"to":947,"avatar":948},"Mariusz Smenżyk","https://www.linkedin.com/in/mariusz-smenzyk/",{"src":949},"/images/people/mariusz-smenzyk2.webp",{"label":951,"color":952},"Open Source","#7c3aed",{"type":743,"value":954,"toc":2760},[955,971,974,978,981,1037,1054,1058,1064,1069,1151,1155,1158,1174,1177,1181,1188,1420,1423,1435,1439,1445,1449,1515,1519,1525,1799,1821,1830,1834,1838,1841,1850,1853,1879,1883,1886,2308,2311,2323,2327,2337,2340,2360,2364,2367,2402,2406,2444,2466,2470,2502,2506,2534,2538,2640,2644,2647,2675,2679,2682,2709,2712,2716,2741,2743,2756],[751,956,957,958,961,962,966,967,970],{},"If you've ever wondered what data Ableton Live stores in its project files, you're not alone. As part of our work at MusicTech Lab, we needed to extract metadata from Ableton projects – tempo, time signature, track names, and song sections – to power our music analysis workflows. The result is ",[842,959,960],{},"MTL Ableton Analyser",", an open-source Python tool that parses both ",[963,964,965],"code",{},".als"," (Ableton Live Set) and ",[963,968,969],{},".asd"," (Ableton Sample Data) files.",[751,972,973],{},"In this article, we'll explore what's inside these files and how to extract useful data from them programmatically.",[746,975,977],{"id":976},"understanding-abletons-file-formats","Understanding Ableton's File Formats",[751,979,980],{},"Ableton Live uses two primary file formats for storing project and analysis data:",[982,983,984,1003],"table",{},[985,986,987],"thead",{},[988,989,990,994,997,1000],"tr",{},[991,992,993],"th",{},"Format",[991,995,996],{},"Full Name",[991,998,999],{},"Type",[991,1001,1002],{},"Purpose",[1004,1005,1006,1022],"tbody",{},[988,1007,1008,1013,1016,1019],{},[1009,1010,1011],"td",{},[963,1012,965],{},[1009,1014,1015],{},"Ableton Live Set",[1009,1017,1018],{},"Gzip-compressed XML",[1009,1020,1021],{},"Complete project data – tracks, clips, tempo, arrangement",[988,1023,1024,1028,1031,1034],{},[1009,1025,1026],{},[963,1027,969],{},[1009,1029,1030],{},"Ableton Sample Data",[1009,1032,1033],{},"Binary",[1009,1035,1036],{},"Analysis cache – detected BPM, warp markers, waveform peaks",[751,1038,1039,1040,1042,1043,1046,1047,1049,1050,1053],{},"The key insight is that ",[963,1041,965],{}," files are actually ",[842,1044,1045],{},"compressed XML",", making them relatively straightforward to parse. The ",[963,1048,969],{}," files, however, are ",[842,1051,1052],{},"proprietary binary"," and require reverse-engineering to extract data.",[746,1055,1057],{"id":1056},"data-extractable-from-als-files","Data Extractable from .als Files",[751,1059,1060,1061,1063],{},"When you decompress an ",[963,1062,965],{}," file, you get a well-structured XML document containing the entire project state. Here's what we can reliably extract:",[1065,1066,1068],"h3",{"id":1067},"project-metadata","Project Metadata",[982,1070,1071,1084],{},[985,1072,1073],{},[988,1074,1075,1078,1081],{},[991,1076,1077],{},"Data Point",[991,1079,1080],{},"Description",[991,1082,1083],{},"XML Path",[1004,1085,1086,1101,1116,1131],{},[988,1087,1088,1093,1096],{},[1009,1089,1090],{},[842,1091,1092],{},"Tempo (BPM)",[1009,1094,1095],{},"Project tempo",[1009,1097,1098],{},[963,1099,1100],{},".//Tempo/Manual",[988,1102,1103,1108,1111],{},[1009,1104,1105],{},[842,1106,1107],{},"Time Signature",[1009,1109,1110],{},"Numerator and denominator",[1009,1112,1113],{},[963,1114,1115],{},".//TimeSignature/*",[988,1117,1118,1123,1126],{},[1009,1119,1120],{},[842,1121,1122],{},"Track Count",[1009,1124,1125],{},"Number of tracks in project",[1009,1127,1128],{},[963,1129,1130],{},".//Tracks",[988,1132,1133,1138,1141],{},[1009,1134,1135],{},[842,1136,1137],{},"Track Names",[1009,1139,1140],{},"User-defined track names",[1009,1142,1143,1146,1147,1150],{},[963,1144,1145],{},"EffectiveName",", ",[963,1148,1149],{},"UserName"," attributes",[1065,1152,1154],{"id":1153},"warp-markers","Warp Markers",[751,1156,1157],{},"Warp markers define the relationship between audio time (seconds) and musical time (beats). Each marker contains:",[1159,1160,1161,1168],"ul",{},[1162,1163,1164,1167],"li",{},[842,1165,1166],{},"SecTime"," – Position in the audio file (seconds)",[1162,1169,1170,1173],{},[842,1171,1172],{},"BeatTime"," – Corresponding position in beats",[751,1175,1176],{},"This data is essential for beat-synced playback and tempo manipulation.",[1065,1178,1180],{"id":1179},"locators-section-markers","Locators (Section Markers)",[751,1182,1183,1184,1187],{},"Perhaps the most valuable data for music analysis – ",[842,1185,1186],{},"locators"," represent named positions in your arrangement:",[1189,1190,1194],"pre",{"className":1191,"code":1192,"language":1193,"meta":902,"style":902},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"sections\": [\n    { \"name\": \"INT1\", \"beat\": 0 },\n    { \"name\": \"VER1\", \"beat\": 32 },\n    { \"name\": \"CHO1\", \"beat\": 64 },\n    { \"name\": \"BRD1\", \"beat\": 96 },\n    { \"name\": \"OUT1\", \"beat\": 128 }\n  ]\n}\n","json",[963,1195,1196,1205,1223,1267,1302,1337,1372,1408,1414],{"__ignoreMap":902},[1197,1198,1201],"span",{"class":1199,"line":1200},"line",1,[1197,1202,1204],{"class":1203},"sMK4o","{\n",[1197,1206,1207,1210,1214,1217,1220],{"class":1199,"line":903},[1197,1208,1209],{"class":1203},"  \"",[1197,1211,1213],{"class":1212},"spNyl","sections",[1197,1215,1216],{"class":1203},"\"",[1197,1218,1219],{"class":1203},":",[1197,1221,1222],{"class":1203}," [\n",[1197,1224,1226,1229,1232,1236,1238,1240,1242,1246,1248,1251,1253,1256,1258,1260,1264],{"class":1199,"line":1225},3,[1197,1227,1228],{"class":1203},"    {",[1197,1230,1231],{"class":1203}," \"",[1197,1233,1235],{"class":1234},"sBMFI","name",[1197,1237,1216],{"class":1203},[1197,1239,1219],{"class":1203},[1197,1241,1231],{"class":1203},[1197,1243,1245],{"class":1244},"sfazB","INT1",[1197,1247,1216],{"class":1203},[1197,1249,1250],{"class":1203},",",[1197,1252,1231],{"class":1203},[1197,1254,1255],{"class":1234},"beat",[1197,1257,1216],{"class":1203},[1197,1259,1219],{"class":1203},[1197,1261,1263],{"class":1262},"sbssI"," 0",[1197,1265,1266],{"class":1203}," },\n",[1197,1268,1270,1272,1274,1276,1278,1280,1282,1285,1287,1289,1291,1293,1295,1297,1300],{"class":1199,"line":1269},4,[1197,1271,1228],{"class":1203},[1197,1273,1231],{"class":1203},[1197,1275,1235],{"class":1234},[1197,1277,1216],{"class":1203},[1197,1279,1219],{"class":1203},[1197,1281,1231],{"class":1203},[1197,1283,1284],{"class":1244},"VER1",[1197,1286,1216],{"class":1203},[1197,1288,1250],{"class":1203},[1197,1290,1231],{"class":1203},[1197,1292,1255],{"class":1234},[1197,1294,1216],{"class":1203},[1197,1296,1219],{"class":1203},[1197,1298,1299],{"class":1262}," 32",[1197,1301,1266],{"class":1203},[1197,1303,1305,1307,1309,1311,1313,1315,1317,1320,1322,1324,1326,1328,1330,1332,1335],{"class":1199,"line":1304},5,[1197,1306,1228],{"class":1203},[1197,1308,1231],{"class":1203},[1197,1310,1235],{"class":1234},[1197,1312,1216],{"class":1203},[1197,1314,1219],{"class":1203},[1197,1316,1231],{"class":1203},[1197,1318,1319],{"class":1244},"CHO1",[1197,1321,1216],{"class":1203},[1197,1323,1250],{"class":1203},[1197,1325,1231],{"class":1203},[1197,1327,1255],{"class":1234},[1197,1329,1216],{"class":1203},[1197,1331,1219],{"class":1203},[1197,1333,1334],{"class":1262}," 64",[1197,1336,1266],{"class":1203},[1197,1338,1340,1342,1344,1346,1348,1350,1352,1355,1357,1359,1361,1363,1365,1367,1370],{"class":1199,"line":1339},6,[1197,1341,1228],{"class":1203},[1197,1343,1231],{"class":1203},[1197,1345,1235],{"class":1234},[1197,1347,1216],{"class":1203},[1197,1349,1219],{"class":1203},[1197,1351,1231],{"class":1203},[1197,1353,1354],{"class":1244},"BRD1",[1197,1356,1216],{"class":1203},[1197,1358,1250],{"class":1203},[1197,1360,1231],{"class":1203},[1197,1362,1255],{"class":1234},[1197,1364,1216],{"class":1203},[1197,1366,1219],{"class":1203},[1197,1368,1369],{"class":1262}," 96",[1197,1371,1266],{"class":1203},[1197,1373,1375,1377,1379,1381,1383,1385,1387,1390,1392,1394,1396,1398,1400,1402,1405],{"class":1199,"line":1374},7,[1197,1376,1228],{"class":1203},[1197,1378,1231],{"class":1203},[1197,1380,1235],{"class":1234},[1197,1382,1216],{"class":1203},[1197,1384,1219],{"class":1203},[1197,1386,1231],{"class":1203},[1197,1388,1389],{"class":1244},"OUT1",[1197,1391,1216],{"class":1203},[1197,1393,1250],{"class":1203},[1197,1395,1231],{"class":1203},[1197,1397,1255],{"class":1234},[1197,1399,1216],{"class":1203},[1197,1401,1219],{"class":1203},[1197,1403,1404],{"class":1262}," 128",[1197,1406,1407],{"class":1203}," }\n",[1197,1409,1411],{"class":1199,"line":1410},8,[1197,1412,1413],{"class":1203},"  ]\n",[1197,1415,1417],{"class":1199,"line":1416},9,[1197,1418,1419],{"class":1203},"}\n",[751,1421,1422],{},"These locators, when combined with tempo data, give you a complete song structure map with precise timestamps.",[755,1424,1427],{"className":1425},[883,1426,762],"justify-center",[751,1428,1429],{},[1430,1431],"img",{"alt":1432,"src":1433,"width":1434},"ALS Analysis Output","/images/blog/musictechlab_blog_ableton_als_analysis.webp",600,[746,1436,1438],{"id":1437},"data-extractable-from-asd-files","Data Extractable from .asd Files",[751,1440,1441,1442,1444],{},"The ",[963,1443,969],{}," format is more challenging. Ableton creates these files automatically when you analyze audio, storing:",[1065,1446,1448],{"id":1447},"detected-metadata","Detected Metadata",[982,1450,1451,1463],{},[985,1452,1453],{},[988,1454,1455,1457,1460],{},[991,1456,1077],{},[991,1458,1459],{},"Detection Method",[991,1461,1462],{},"Notes",[1004,1464,1465,1478,1490,1502],{},[988,1466,1467,1472,1475],{},[1009,1468,1469],{},[842,1470,1471],{},"Format Version",[1009,1473,1474],{},"First byte",[1009,1476,1477],{},"Typically version 6",[988,1479,1480,1484,1487],{},[1009,1481,1482],{},[842,1483,1092],{},[1009,1485,1486],{},"Binary search at known offsets",[1009,1488,1489],{},"Ableton's auto-detected BPM",[988,1491,1492,1496,1499],{},[1009,1493,1494],{},[842,1495,1107],{},[1009,1497,1498],{},"Marker string search",[1009,1500,1501],{},"Numerator/Denominator extraction",[988,1503,1504,1509,1512],{},[1009,1505,1506],{},[842,1507,1508],{},"Waveform Data",[1009,1510,1511],{},"Presence check",[1009,1513,1514],{},"Boolean – are peaks pre-computed?",[1065,1516,1518],{"id":1517},"bpm-detection-strategy","BPM Detection Strategy",[751,1520,1521,1522,1524],{},"The BPM value in ",[963,1523,969],{}," files isn't at a fixed offset. Our parser searches multiple known locations:",[1189,1526,1530],{"className":1527,"code":1528,"language":1529,"meta":902,"style":902},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","KNOWN_BPM_OFFSETS = [7736, 8448, 8632, 7685, 7740, 8440]\n\ndef find_bpm(data: bytes) -> Optional[float]:\n    for offset in KNOWN_BPM_OFFSETS:\n        if offset + 4 \u003C= len(data):\n            value = struct.unpack('\u003Cf', data[offset:offset+4])[0]\n            if 60.0 \u003C= value \u003C= 200.0:\n                return round(value, 2)\n    # Fallback: scan byte range for valid BPM\n    return scan_for_bpm(data, range_start=6000, range_end=9500)\n","python",[963,1531,1532,1575,1580,1619,1637,1663,1716,1737,1758,1764],{"__ignoreMap":902},[1197,1533,1534,1538,1541,1544,1547,1549,1552,1554,1557,1559,1562,1564,1567,1569,1572],{"class":1199,"line":1200},[1197,1535,1537],{"class":1536},"sTEyZ","KNOWN_BPM_OFFSETS ",[1197,1539,1540],{"class":1203},"=",[1197,1542,1543],{"class":1203}," [",[1197,1545,1546],{"class":1262},"7736",[1197,1548,1250],{"class":1203},[1197,1550,1551],{"class":1262}," 8448",[1197,1553,1250],{"class":1203},[1197,1555,1556],{"class":1262}," 8632",[1197,1558,1250],{"class":1203},[1197,1560,1561],{"class":1262}," 7685",[1197,1563,1250],{"class":1203},[1197,1565,1566],{"class":1262}," 7740",[1197,1568,1250],{"class":1203},[1197,1570,1571],{"class":1262}," 8440",[1197,1573,1574],{"class":1203},"]\n",[1197,1576,1577],{"class":1199,"line":903},[1197,1578,1579],{"emptyLinePlaceholder":918},"\n",[1197,1581,1582,1585,1589,1592,1596,1598,1601,1604,1607,1610,1613,1616],{"class":1199,"line":1225},[1197,1583,1584],{"class":1212},"def",[1197,1586,1588],{"class":1587},"s2Zo4"," find_bpm",[1197,1590,1591],{"class":1203},"(",[1197,1593,1595],{"class":1594},"sHdIc","data",[1197,1597,1219],{"class":1203},[1197,1599,1600],{"class":1234}," bytes",[1197,1602,1603],{"class":1203},")",[1197,1605,1606],{"class":1203}," ->",[1197,1608,1609],{"class":1536}," Optional",[1197,1611,1612],{"class":1203},"[",[1197,1614,1615],{"class":1234},"float",[1197,1617,1618],{"class":1203},"]:\n",[1197,1620,1621,1625,1628,1631,1634],{"class":1199,"line":1269},[1197,1622,1624],{"class":1623},"s7zQu","    for",[1197,1626,1627],{"class":1536}," offset ",[1197,1629,1630],{"class":1623},"in",[1197,1632,1633],{"class":1536}," KNOWN_BPM_OFFSETS",[1197,1635,1636],{"class":1203},":\n",[1197,1638,1639,1642,1644,1647,1650,1653,1656,1658,1660],{"class":1199,"line":1304},[1197,1640,1641],{"class":1623},"        if",[1197,1643,1627],{"class":1536},[1197,1645,1646],{"class":1203},"+",[1197,1648,1649],{"class":1262}," 4",[1197,1651,1652],{"class":1203}," \u003C=",[1197,1654,1655],{"class":1587}," len",[1197,1657,1591],{"class":1203},[1197,1659,1595],{"class":1587},[1197,1661,1662],{"class":1203},"):\n",[1197,1664,1665,1668,1670,1673,1676,1679,1681,1684,1687,1689,1691,1694,1696,1699,1701,1703,1705,1708,1711,1714],{"class":1199,"line":1339},[1197,1666,1667],{"class":1536},"            value ",[1197,1669,1540],{"class":1203},[1197,1671,1672],{"class":1536}," struct",[1197,1674,1675],{"class":1203},".",[1197,1677,1678],{"class":1587},"unpack",[1197,1680,1591],{"class":1203},[1197,1682,1683],{"class":1203},"'",[1197,1685,1686],{"class":1244},"\u003Cf",[1197,1688,1683],{"class":1203},[1197,1690,1250],{"class":1203},[1197,1692,1693],{"class":1587}," data",[1197,1695,1612],{"class":1203},[1197,1697,1698],{"class":1587},"offset",[1197,1700,1219],{"class":1203},[1197,1702,1698],{"class":1587},[1197,1704,1646],{"class":1203},[1197,1706,1707],{"class":1262},"4",[1197,1709,1710],{"class":1203},"])[",[1197,1712,1713],{"class":1262},"0",[1197,1715,1574],{"class":1203},[1197,1717,1718,1721,1724,1726,1729,1732,1735],{"class":1199,"line":1374},[1197,1719,1720],{"class":1623},"            if",[1197,1722,1723],{"class":1262}," 60.0",[1197,1725,1652],{"class":1203},[1197,1727,1728],{"class":1536}," value ",[1197,1730,1731],{"class":1203},"\u003C=",[1197,1733,1734],{"class":1262}," 200.0",[1197,1736,1636],{"class":1203},[1197,1738,1739,1742,1745,1747,1750,1752,1755],{"class":1199,"line":1410},[1197,1740,1741],{"class":1623},"                return",[1197,1743,1744],{"class":1587}," round",[1197,1746,1591],{"class":1203},[1197,1748,1749],{"class":1587},"value",[1197,1751,1250],{"class":1203},[1197,1753,1754],{"class":1262}," 2",[1197,1756,1757],{"class":1203},")\n",[1197,1759,1760],{"class":1199,"line":1416},[1197,1761,1763],{"class":1762},"sHwdD","    # Fallback: scan byte range for valid BPM\n",[1197,1765,1767,1770,1773,1775,1777,1779,1782,1784,1787,1789,1792,1794,1797],{"class":1199,"line":1766},10,[1197,1768,1769],{"class":1623},"    return",[1197,1771,1772],{"class":1587}," scan_for_bpm",[1197,1774,1591],{"class":1203},[1197,1776,1595],{"class":1587},[1197,1778,1250],{"class":1203},[1197,1780,1781],{"class":1594}," range_start",[1197,1783,1540],{"class":1203},[1197,1785,1786],{"class":1262},"6000",[1197,1788,1250],{"class":1203},[1197,1790,1791],{"class":1594}," range_end",[1197,1793,1540],{"class":1203},[1197,1795,1796],{"class":1262},"9500",[1197,1798,1757],{"class":1203},[1800,1801,1802],"note",{},[751,1803,1804,1807,1808,1810,1811,1814,1815,1817,1818,1820],{},[842,1805,1806],{},"Important:"," The BPM in ",[963,1809,969],{}," files represents Ableton's ",[842,1812,1813],{},"auto-detection",", which may differ from the project tempo in the ",[963,1816,965],{}," file. The ",[963,1819,965],{}," tempo is always the authoritative value.",[755,1822,1824],{"className":1823},[883,1426,762],[751,1825,1826],{},[1430,1827],{"alt":1828,"src":1829,"width":1434},"ASD Analysis Output","/images/blog/musictechlab_blog_ableton_asd_analysis.webp",[746,1831,1833],{"id":1832},"practical-applications","Practical Applications",[1065,1835,1837],{"id":1836},"waveform-visualization-with-sections","Waveform Visualization with Sections",[751,1839,1840],{},"By combining data from both file types, we can generate rich visualizations:",[755,1842,1844],{"className":1843},[883,1426,762],[751,1845,1846],{},[1430,1847],{"alt":1837,"src":1848,"width":1849},"/images/blog/musictechlab_blog_ableton_asd_waveform.webp",800,[751,1851,1852],{},"The visualization includes:",[1159,1854,1855,1861,1867,1873],{},[1162,1856,1857,1860],{},[842,1858,1859],{},"Waveform amplitude"," – extracted from the audio file",[1162,1862,1863,1866],{},[842,1864,1865],{},"Beat grid"," – calculated from BPM and time signature",[1162,1868,1869,1872],{},[842,1870,1871],{},"Section overlays"," – color-coded backgrounds from locator data",[1162,1874,1875,1878],{},[842,1876,1877],{},"Downbeat markers"," – emphasized beats at bar boundaries",[1065,1880,1882],{"id":1881},"wavesurferjs-integration","WaveSurfer.js Integration",[751,1884,1885],{},"For web applications, we export a JSON format compatible with WaveSurfer.js:",[1189,1887,1889],{"className":1191,"code":1888,"language":1193,"meta":902,"style":902},"{\n  \"version\": \"1.0\",\n  \"filename\": \"track.mp3\",\n  \"duration\": 180.5,\n  \"sampleRate\": 44100,\n  \"bpm\": 128,\n  \"beatsPerBar\": 4,\n  \"totalBeats\": 385,\n  \"peaks\": [0.12, 0.45, 0.89, ...],\n  \"beats\": [\n    { \"time\": 0.0, \"beat\": 1, \"isDownbeat\": true },\n    { \"time\": 0.469, \"beat\": 2, \"isDownbeat\": false }\n  ],\n  \"sections\": [\n    { \"name\": \"INT1\", \"start\": 0.0, \"end\": 15.0, \"color\": \"#1E3A5F\" },\n    { \"name\": \"VER1\", \"start\": 15.0, \"end\": 30.0, \"color\": \"#3D1A5F\" }\n  ]\n}\n",[963,1890,1891,1895,1916,1936,1952,1968,1983,1998,2014,2048,2061,2107,2150,2156,2169,2235,2298,2303],{"__ignoreMap":902},[1197,1892,1893],{"class":1199,"line":1200},[1197,1894,1204],{"class":1203},[1197,1896,1897,1899,1902,1904,1906,1908,1911,1913],{"class":1199,"line":903},[1197,1898,1209],{"class":1203},[1197,1900,1901],{"class":1212},"version",[1197,1903,1216],{"class":1203},[1197,1905,1219],{"class":1203},[1197,1907,1231],{"class":1203},[1197,1909,1910],{"class":1244},"1.0",[1197,1912,1216],{"class":1203},[1197,1914,1915],{"class":1203},",\n",[1197,1917,1918,1920,1923,1925,1927,1929,1932,1934],{"class":1199,"line":1225},[1197,1919,1209],{"class":1203},[1197,1921,1922],{"class":1212},"filename",[1197,1924,1216],{"class":1203},[1197,1926,1219],{"class":1203},[1197,1928,1231],{"class":1203},[1197,1930,1931],{"class":1244},"track.mp3",[1197,1933,1216],{"class":1203},[1197,1935,1915],{"class":1203},[1197,1937,1938,1940,1943,1945,1947,1950],{"class":1199,"line":1269},[1197,1939,1209],{"class":1203},[1197,1941,1942],{"class":1212},"duration",[1197,1944,1216],{"class":1203},[1197,1946,1219],{"class":1203},[1197,1948,1949],{"class":1262}," 180.5",[1197,1951,1915],{"class":1203},[1197,1953,1954,1956,1959,1961,1963,1966],{"class":1199,"line":1304},[1197,1955,1209],{"class":1203},[1197,1957,1958],{"class":1212},"sampleRate",[1197,1960,1216],{"class":1203},[1197,1962,1219],{"class":1203},[1197,1964,1965],{"class":1262}," 44100",[1197,1967,1915],{"class":1203},[1197,1969,1970,1972,1975,1977,1979,1981],{"class":1199,"line":1339},[1197,1971,1209],{"class":1203},[1197,1973,1974],{"class":1212},"bpm",[1197,1976,1216],{"class":1203},[1197,1978,1219],{"class":1203},[1197,1980,1404],{"class":1262},[1197,1982,1915],{"class":1203},[1197,1984,1985,1987,1990,1992,1994,1996],{"class":1199,"line":1374},[1197,1986,1209],{"class":1203},[1197,1988,1989],{"class":1212},"beatsPerBar",[1197,1991,1216],{"class":1203},[1197,1993,1219],{"class":1203},[1197,1995,1649],{"class":1262},[1197,1997,1915],{"class":1203},[1197,1999,2000,2002,2005,2007,2009,2012],{"class":1199,"line":1410},[1197,2001,1209],{"class":1203},[1197,2003,2004],{"class":1212},"totalBeats",[1197,2006,1216],{"class":1203},[1197,2008,1219],{"class":1203},[1197,2010,2011],{"class":1262}," 385",[1197,2013,1915],{"class":1203},[1197,2015,2016,2018,2021,2023,2025,2027,2030,2032,2035,2037,2040,2042,2045],{"class":1199,"line":1416},[1197,2017,1209],{"class":1203},[1197,2019,2020],{"class":1212},"peaks",[1197,2022,1216],{"class":1203},[1197,2024,1219],{"class":1203},[1197,2026,1543],{"class":1203},[1197,2028,2029],{"class":1262},"0.12",[1197,2031,1250],{"class":1203},[1197,2033,2034],{"class":1262}," 0.45",[1197,2036,1250],{"class":1203},[1197,2038,2039],{"class":1262}," 0.89",[1197,2041,1250],{"class":1203},[1197,2043,2044],{"class":1536}," ...",[1197,2046,2047],{"class":1203},"],\n",[1197,2049,2050,2052,2055,2057,2059],{"class":1199,"line":1766},[1197,2051,1209],{"class":1203},[1197,2053,2054],{"class":1212},"beats",[1197,2056,1216],{"class":1203},[1197,2058,1219],{"class":1203},[1197,2060,1222],{"class":1203},[1197,2062,2064,2066,2068,2071,2073,2075,2078,2080,2082,2084,2086,2088,2091,2093,2095,2098,2100,2102,2105],{"class":1199,"line":2063},11,[1197,2065,1228],{"class":1203},[1197,2067,1231],{"class":1203},[1197,2069,2070],{"class":1234},"time",[1197,2072,1216],{"class":1203},[1197,2074,1219],{"class":1203},[1197,2076,2077],{"class":1262}," 0.0",[1197,2079,1250],{"class":1203},[1197,2081,1231],{"class":1203},[1197,2083,1255],{"class":1234},[1197,2085,1216],{"class":1203},[1197,2087,1219],{"class":1203},[1197,2089,2090],{"class":1262}," 1",[1197,2092,1250],{"class":1203},[1197,2094,1231],{"class":1203},[1197,2096,2097],{"class":1234},"isDownbeat",[1197,2099,1216],{"class":1203},[1197,2101,1219],{"class":1203},[1197,2103,2104],{"class":1203}," true",[1197,2106,1266],{"class":1203},[1197,2108,2110,2112,2114,2116,2118,2120,2123,2125,2127,2129,2131,2133,2135,2137,2139,2141,2143,2145,2148],{"class":1199,"line":2109},12,[1197,2111,1228],{"class":1203},[1197,2113,1231],{"class":1203},[1197,2115,2070],{"class":1234},[1197,2117,1216],{"class":1203},[1197,2119,1219],{"class":1203},[1197,2121,2122],{"class":1262}," 0.469",[1197,2124,1250],{"class":1203},[1197,2126,1231],{"class":1203},[1197,2128,1255],{"class":1234},[1197,2130,1216],{"class":1203},[1197,2132,1219],{"class":1203},[1197,2134,1754],{"class":1262},[1197,2136,1250],{"class":1203},[1197,2138,1231],{"class":1203},[1197,2140,2097],{"class":1234},[1197,2142,1216],{"class":1203},[1197,2144,1219],{"class":1203},[1197,2146,2147],{"class":1203}," false",[1197,2149,1407],{"class":1203},[1197,2151,2153],{"class":1199,"line":2152},13,[1197,2154,2155],{"class":1203},"  ],\n",[1197,2157,2159,2161,2163,2165,2167],{"class":1199,"line":2158},14,[1197,2160,1209],{"class":1203},[1197,2162,1213],{"class":1212},[1197,2164,1216],{"class":1203},[1197,2166,1219],{"class":1203},[1197,2168,1222],{"class":1203},[1197,2170,2172,2174,2176,2178,2180,2182,2184,2186,2188,2190,2192,2195,2197,2199,2201,2203,2205,2208,2210,2212,2215,2217,2219,2222,2224,2226,2228,2231,2233],{"class":1199,"line":2171},15,[1197,2173,1228],{"class":1203},[1197,2175,1231],{"class":1203},[1197,2177,1235],{"class":1234},[1197,2179,1216],{"class":1203},[1197,2181,1219],{"class":1203},[1197,2183,1231],{"class":1203},[1197,2185,1245],{"class":1244},[1197,2187,1216],{"class":1203},[1197,2189,1250],{"class":1203},[1197,2191,1231],{"class":1203},[1197,2193,2194],{"class":1234},"start",[1197,2196,1216],{"class":1203},[1197,2198,1219],{"class":1203},[1197,2200,2077],{"class":1262},[1197,2202,1250],{"class":1203},[1197,2204,1231],{"class":1203},[1197,2206,2207],{"class":1234},"end",[1197,2209,1216],{"class":1203},[1197,2211,1219],{"class":1203},[1197,2213,2214],{"class":1262}," 15.0",[1197,2216,1250],{"class":1203},[1197,2218,1231],{"class":1203},[1197,2220,2221],{"class":1234},"color",[1197,2223,1216],{"class":1203},[1197,2225,1219],{"class":1203},[1197,2227,1231],{"class":1203},[1197,2229,2230],{"class":1244},"#1E3A5F",[1197,2232,1216],{"class":1203},[1197,2234,1266],{"class":1203},[1197,2236,2238,2240,2242,2244,2246,2248,2250,2252,2254,2256,2258,2260,2262,2264,2266,2268,2270,2272,2274,2276,2279,2281,2283,2285,2287,2289,2291,2294,2296],{"class":1199,"line":2237},16,[1197,2239,1228],{"class":1203},[1197,2241,1231],{"class":1203},[1197,2243,1235],{"class":1234},[1197,2245,1216],{"class":1203},[1197,2247,1219],{"class":1203},[1197,2249,1231],{"class":1203},[1197,2251,1284],{"class":1244},[1197,2253,1216],{"class":1203},[1197,2255,1250],{"class":1203},[1197,2257,1231],{"class":1203},[1197,2259,2194],{"class":1234},[1197,2261,1216],{"class":1203},[1197,2263,1219],{"class":1203},[1197,2265,2214],{"class":1262},[1197,2267,1250],{"class":1203},[1197,2269,1231],{"class":1203},[1197,2271,2207],{"class":1234},[1197,2273,1216],{"class":1203},[1197,2275,1219],{"class":1203},[1197,2277,2278],{"class":1262}," 30.0",[1197,2280,1250],{"class":1203},[1197,2282,1231],{"class":1203},[1197,2284,2221],{"class":1234},[1197,2286,1216],{"class":1203},[1197,2288,1219],{"class":1203},[1197,2290,1231],{"class":1203},[1197,2292,2293],{"class":1244},"#3D1A5F",[1197,2295,1216],{"class":1203},[1197,2297,1407],{"class":1203},[1197,2299,2301],{"class":1199,"line":2300},17,[1197,2302,1413],{"class":1203},[1197,2304,2306],{"class":1199,"line":2305},18,[1197,2307,1419],{"class":1203},[751,2309,2310],{},"This powers interactive, beat-synced waveform players in the browser.",[755,2312,2314],{"className":2313},[883,1426,762],[2315,2316,2317,2318],"video",{"controls":918,"width":1849},"\n  ",[2319,2320],"source",{"src":2321,"type":2322},"/videos/blog/musictechlab_blog_ableton_analyser_wavesurfer.mp4","video/mp4",[1065,2324,2326],{"id":2325},"live-demo","Live Demo",[751,2328,2329,2332,2333],{},[842,2330,2331],{},"Try it yourself:"," ",[807,2334,2335],{"href":2335,"rel":2336},"https://mtl-ableton-analyser.web.app",[811],[751,2338,2339],{},"The web app lets you:",[1159,2341,2342,2345,2351,2354,2357],{},[1162,2343,2344],{},"Load audio files (MP3, WAV) directly in the browser",[1162,2346,2347,2348,2350],{},"Parse ",[963,2349,965],{}," files client-side – no backend required",[1162,2352,2353],{},"View waveform with beat grid and section overlays",[1162,2355,2356],{},"Toggle between bars and time-based timelines",[1162,2358,2359],{},"Navigate by clicking on sections or the waveform",[746,2361,2363],{"id":2362},"using-mtl-ableton-analyser","Using MTL Ableton Analyser",[751,2365,2366],{},"The tool is available as an open-source Python CLI:",[1189,2368,2373],{"className":2369,"code":2370,"filename":2371,"language":2372,"meta":902,"style":902},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","git clone https://github.com/musictechlab/mtl-ableton-analyser\ncd mtl-ableton-analyser\npoetry install\n","Installation","bash",[963,2374,2375,2386,2394],{"__ignoreMap":902},[1197,2376,2377,2380,2383],{"class":1199,"line":1200},[1197,2378,2379],{"class":1234},"git",[1197,2381,2382],{"class":1244}," clone",[1197,2384,2385],{"class":1244}," https://github.com/musictechlab/mtl-ableton-analyser\n",[1197,2387,2388,2391],{"class":1199,"line":903},[1197,2389,2390],{"class":1587},"cd",[1197,2392,2393],{"class":1244}," mtl-ableton-analyser\n",[1197,2395,2396,2399],{"class":1199,"line":1225},[1197,2397,2398],{"class":1234},"poetry",[1197,2400,2401],{"class":1244}," install\n",[1065,2403,2405],{"id":2404},"analyze-files","Analyze Files",[1189,2407,2410],{"className":2369,"code":2408,"filename":2409,"language":2372,"meta":902,"style":902},"poetry run mtl-ableton-analyser analyze /path/to/project.als --verbose\npoetry run mtl-ableton-analyser analyze /path/to/audio.mp3.asd\n","Single File Analysis",[963,2411,2412,2431],{"__ignoreMap":902},[1197,2413,2414,2416,2419,2422,2425,2428],{"class":1199,"line":1200},[1197,2415,2398],{"class":1234},[1197,2417,2418],{"class":1244}," run",[1197,2420,2421],{"class":1244}," mtl-ableton-analyser",[1197,2423,2424],{"class":1244}," analyze",[1197,2426,2427],{"class":1244}," /path/to/project.als",[1197,2429,2430],{"class":1244}," --verbose\n",[1197,2432,2433,2435,2437,2439,2441],{"class":1199,"line":903},[1197,2434,2398],{"class":1234},[1197,2436,2418],{"class":1244},[1197,2438,2421],{"class":1244},[1197,2440,2424],{"class":1244},[1197,2442,2443],{"class":1244}," /path/to/audio.mp3.asd\n",[1189,2445,2448],{"className":2369,"code":2446,"filename":2447,"language":2372,"meta":902,"style":902},"poetry run mtl-ableton-analyser analyze /path/to/projects --recursive\n","Directory Scanning",[963,2449,2450],{"__ignoreMap":902},[1197,2451,2452,2454,2456,2458,2460,2463],{"class":1199,"line":1200},[1197,2453,2398],{"class":1234},[1197,2455,2418],{"class":1244},[1197,2457,2421],{"class":1244},[1197,2459,2424],{"class":1244},[1197,2461,2462],{"class":1244}," /path/to/projects",[1197,2464,2465],{"class":1244}," --recursive\n",[1065,2467,2469],{"id":2468},"generate-visualizations","Generate Visualizations",[1189,2471,2474],{"className":2369,"code":2472,"filename":2473,"language":2372,"meta":902,"style":902},"poetry run mtl-ableton-analyser visualize audio.mp3 --als project.als -o waveform.png\n","Waveform with Sections",[963,2475,2476],{"__ignoreMap":902},[1197,2477,2478,2480,2482,2484,2487,2490,2493,2496,2499],{"class":1199,"line":1200},[1197,2479,2398],{"class":1234},[1197,2481,2418],{"class":1244},[1197,2483,2421],{"class":1244},[1197,2485,2486],{"class":1244}," visualize",[1197,2488,2489],{"class":1244}," audio.mp3",[1197,2491,2492],{"class":1244}," --als",[1197,2494,2495],{"class":1244}," project.als",[1197,2497,2498],{"class":1244}," -o",[1197,2500,2501],{"class":1244}," waveform.png\n",[1065,2503,2505],{"id":2504},"export-for-web","Export for Web",[1189,2507,2510],{"className":2369,"code":2508,"filename":2509,"language":2372,"meta":902,"style":902},"poetry run mtl-ableton-analyser export audio.mp3 --als project.als -o waveform.json\n","WaveSurfer JSON Export",[963,2511,2512],{"__ignoreMap":902},[1197,2513,2514,2516,2518,2520,2523,2525,2527,2529,2531],{"class":1199,"line":1200},[1197,2515,2398],{"class":1234},[1197,2517,2418],{"class":1244},[1197,2519,2421],{"class":1244},[1197,2521,2522],{"class":1244}," export",[1197,2524,2489],{"class":1244},[1197,2526,2492],{"class":1244},[1197,2528,2495],{"class":1244},[1197,2530,2498],{"class":1244},[1197,2532,2533],{"class":1244}," waveform.json\n",[746,2535,2537],{"id":2536},"capabilities-summary","Capabilities Summary",[982,2539,2540,2553],{},[985,2541,2542],{},[988,2543,2544,2547,2549,2551],{},[991,2545,2546],{},"Capability",[991,2548,965],{},[991,2550,969],{},[991,2552,1462],{},[1004,2554,2555,2569,2581,2593,2604,2616,2628],{},[988,2556,2557,2560,2563,2566],{},[1009,2558,2559],{},"Extract BPM",[1009,2561,2562],{},"✅ Exact",[1009,2564,2565],{},"✅ Detected",[1009,2567,2568],{},".als is authoritative",[988,2570,2571,2573,2576,2578],{},[1009,2572,1107],{},[1009,2574,2575],{},"✅",[1009,2577,2575],{},[1009,2579,2580],{},"Both reliable",[988,2582,2583,2585,2587,2590],{},[1009,2584,1137],{},[1009,2586,2575],{},[1009,2588,2589],{},"❌",[1009,2591,2592],{},"Only in project files",[988,2594,2595,2597,2599,2601],{},[1009,2596,1154],{},[1009,2598,2575],{},[1009,2600,2589],{},[1009,2602,2603],{},"Beat-to-time mapping",[988,2605,2606,2609,2611,2613],{},[1009,2607,2608],{},"Section Markers",[1009,2610,2575],{},[1009,2612,2589],{},[1009,2614,2615],{},"From locators",[988,2617,2618,2621,2623,2625],{},[1009,2619,2620],{},"Waveform Presence",[1009,2622,2589],{},[1009,2624,2575],{},[1009,2626,2627],{},"Cache indicator",[988,2629,2630,2633,2635,2637],{},[1009,2631,2632],{},"File Size",[1009,2634,2575],{},[1009,2636,2575],{},[1009,2638,2639],{},"Basic metadata",[746,2641,2643],{"id":2642},"limitations","Limitations",[751,2645,2646],{},"While we can extract a lot, some data remains inaccessible:",[1159,2648,2649,2655,2663,2669],{},[1162,2650,2651,2654],{},[842,2652,2653],{},"Detailed onset data"," – Ableton stores transient detection but in an undocumented format",[1162,2656,2657,2660,2661],{},[842,2658,2659],{},"Embedded waveform peaks"," – Detected but not directly extractable from ",[963,2662,969],{},[1162,2664,2665,2668],{},[842,2666,2667],{},"Plugin states"," – Complex binary data within the XML",[1162,2670,2671,2674],{},[842,2672,2673],{},"Write capability"," – This is a read-only tool",[746,2676,2678],{"id":2677},"whats-next","What's Next?",[751,2680,2681],{},"This tool is part of our broader work on music analysis at MusicTech Lab. Combined with our other Ableton integrations, you can build powerful workflows:",[2683,2684,2685,2691,2697,2703],"ol",{},[1162,2686,2687,2690],{},[842,2688,2689],{},"Create section markers in Ableton"," → Export with our Max for Live device",[1162,2692,2693,2696],{},[842,2694,2695],{},"Analyze files programmatically"," → Use MTL Ableton Analyser",[1162,2698,2699,2702],{},[842,2700,2701],{},"Visualize in web applications"," → WaveSurfer.js integration",[1162,2704,2705,2708],{},[842,2706,2707],{},"Enhance with AI"," → Feed structure data to ML models",[2710,2711],"hr",{},[746,2713,2715],{"id":2714},"related-articles","Related Articles",[1159,2717,2718,2724,2729,2735],{},[1162,2719,2720,2723],{},[807,2721,2722],{"href":475},"Exporting Ableton Live Locators to JSON with Max for Live"," – Create and export section markers directly from Ableton",[1162,2725,2726,2728],{},[807,2727,422],{"href":423}," – Send Ableton data to web services",[1162,2730,2731,2734],{},[807,2732,2733],{"href":101},"Automatic Song Structure Analysis – How AI Detects Intro, Verse, and Chorus"," – AI-powered section detection",[1162,2736,2737,2740],{},[807,2738,2739],{"href":407},"Building a DIY MIDI Controller for Ableton Live with Arduino"," – Hardware integration with Ableton",[2710,2742],{},[872,2744,2745],{},[751,2746,2747,2750,2751,2755],{},[842,2748,2749],{},"Open Source:"," MTL Ableton Analyser is available on ",[807,2752,899],{"href":2753,"rel":2754},"https://github.com/musictechlab/mtl-ableton-analyser",[811],". Contributions welcome!",[2757,2758,2759],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}",{"title":902,"searchDepth":903,"depth":903,"links":2761},[2762,2763,2768,2772,2777,2782,2783,2784,2785],{"id":976,"depth":903,"text":977},{"id":1056,"depth":903,"text":1057,"children":2764},[2765,2766,2767],{"id":1067,"depth":1225,"text":1068},{"id":1153,"depth":1225,"text":1154},{"id":1179,"depth":1225,"text":1180},{"id":1437,"depth":903,"text":1438,"children":2769},[2770,2771],{"id":1447,"depth":1225,"text":1448},{"id":1517,"depth":1225,"text":1518},{"id":1832,"depth":903,"text":1833,"children":2773},[2774,2775,2776],{"id":1836,"depth":1225,"text":1837},{"id":1881,"depth":1225,"text":1882},{"id":2325,"depth":1225,"text":2326},{"id":2362,"depth":903,"text":2363,"children":2778},[2779,2780,2781],{"id":2404,"depth":1225,"text":2405},{"id":2468,"depth":1225,"text":2469},{"id":2504,"depth":1225,"text":2505},{"id":2536,"depth":903,"text":2537},{"id":2642,"depth":903,"text":2643},{"id":2677,"depth":903,"text":2678},{"id":2714,"depth":903,"text":2715},"2026-01-31T00:00:00.000Z","A deep dive into parsing Ableton Live project files. Learn what metadata hides inside .als and .asd files and how to extract it with Python.",{"src":2789},"/images/blog/musictechlab_blog_ableton_als_asd_extraction.webp",{"enabled":918,"items":2791},[2792,2795,2798,2801],{"text":2793,"icon":2794},"Ableton .als files are gzip-compressed XML, making them straightforward to parse with Python.","i-lucide-file-code",{"text":2796,"icon":2797},"Locators from .als files provide a complete song structure map with precise beat positions.","i-lucide-music",{"text":2799,"icon":2800},"BPM in .asd files is auto-detected and may differ from the authoritative .als project tempo.","i-lucide-timer",{"text":2802,"icon":2803},"Output exports to JSON compatible with WaveSurfer.js for interactive web-based visualization.","i-lucide-bar-chart-3",{},{"title":140,"description":2787},[932,933,2807,934],"daw","sP2M7DpVovlE_0fKXV3tAiegedrHDDXqdc2vqO4Pqh8",{"id":2810,"title":116,"authors":2811,"badge":2814,"body":2816,"category":911,"client":741,"date":4716,"description":4717,"extension":914,"faq":741,"featured":69,"featuredOrder":741,"hidden":69,"image":4718,"keyTakeaways":4720,"meta":4733,"navigation":918,"path":117,"seo":4734,"status":741,"stem":118,"tags":4735,"teaser":741,"__hash__":4737,"score":1269},"posts/blog/music-data/building-a-suno-remix-app-with-nuxt-and-firebase.md",[2812],{"name":946,"to":947,"avatar":2813},{"src":949},{"label":2815,"color":952},"AI Audio",{"type":743,"value":2817,"toc":4696},[2818,2831,2838,2840,2844,2852,2863,2882,2887,2889,2893,2900,2907,2945,2950,3002,3004,3008,3092,3094,3098,3101,3105,3112,3584,3590,3594,3597,3938,3958,3962,3965,4114,4121,4123,4127,4130,4156,4159,4165,4172,4178,4181,4187,4189,4196,4243,4246,4248,4252,4255,4414,4417,4425,4428,4449,4451,4455,4458,4530,4532,4536,4543,4549,4556,4565,4568,4570,4574,4606,4608,4612,4615,4647,4649,4653,4666,4673,4675,4677,4693],[751,2819,2820,2821,1146,2824,2827,2828,1675],{},"Imagine uploading a raw audio recording and getting back a fully remixed version in a completely different genre - Pop to Jazz, Rock to Lo-fi - all powered by AI. That's exactly what we built as a proof of concept using ",[842,2822,2823],{},"Suno's AI",[842,2825,2826],{},"Nuxt 4",", and ",[842,2829,2830],{},"Firebase",[751,2832,2833,2834,2837],{},"In this article, we'll walk you through the architecture, key technical decisions, and code behind our ",[842,2835,2836],{},"Suno Remix PoC",". Whether you're a music tech enthusiast or a developer exploring AI-powered audio tools, this guide will help you build something similar.",[2710,2839],{},[746,2841,2843],{"id":2842},"what-is-suno","What is Suno?",[751,2845,2846,2851],{},[807,2847,2850],{"href":2848,"rel":2849},"https://suno.com",[811],"Suno"," is one of the most impressive AI music generation platforms available today. It can generate full songs from text prompts, create covers in different styles, extend existing tracks, and even separate stems (vocals vs. instruments).",[751,2853,2854,2855,2858,2859,2862],{},"The catch? ",[842,2856,2857],{},"Suno doesn't have an official public API."," There's no ",[963,2860,2861],{},"suno.com/developers"," portal or API key system. Instead, a growing ecosystem of third-party services wraps Suno's capabilities behind a REST API (Application Programming Interface).",[751,2864,2865,2866,2873,2874,2877,2878,2881],{},"For this PoC, we chose ",[807,2867,2870],{"href":2868,"rel":2869},"https://sunoapi.org",[811],[842,2871,2872],{},"sunoapi.org"," - the most documented third-party provider with support for the ",[963,2875,2876],{},"upload-cover"," endpoint, which is what enables the \"remix\" functionality. It costs approximately ",[842,2879,2880],{},"$0.005 per credit",", which is very affordable for experimentation.",[1800,2883,2884],{},[751,2885,2886],{},"All available Suno API options are unofficial. For a proof of concept this is perfectly fine, but keep an eye on Suno's official announcements if you plan to take this to production.",[2710,2888],{},[746,2890,2892],{"id":2891},"the-architecture","The Architecture",[751,2894,2895,2896,2899],{},"Here's the core challenge: Suno's API doesn't accept file uploads directly. Instead, it requires a ",[842,2897,2898],{},"public URL"," pointing to the audio file. This means we need an intermediary storage layer.",[751,2901,2902,2903,2906],{},"Our solution uses ",[842,2904,2905],{},"Firebase Storage"," as the bridge:",[2683,2908,2909,2915,2921,2930,2939],{},[1162,2910,2911,2914],{},[842,2912,2913],{},"User uploads a WAV/MP3 file"," → stored in Firebase Storage (client-side SDK)",[1162,2916,2917,2920],{},[842,2918,2919],{},"Firebase returns a public download URL"," → this is the key piece Suno needs",[1162,2922,2923,2929],{},[842,2924,2925,2926],{},"Browser calls ",[963,2927,2928],{},"POST /api/remix"," → our Nitro server route forwards the request to sunoapi.org with the API key",[1162,2931,2932,2938],{},[842,2933,2934,2935],{},"Browser polls ",[963,2936,2937],{},"GET /api/remix/:taskId"," → our server route checks sunoapi.org for the remix status every 30 seconds",[1162,2940,2941,2944],{},[842,2942,2943],{},"Remix is ready"," → the browser plays both original and remixed audio side-by-side using WaveSurfer.js",[751,2946,2947],{},[842,2948,2949],{},"Why this architecture?",[982,2951,2952,2962],{},[985,2953,2954],{},[988,2955,2956,2959],{},[991,2957,2958],{},"Decision",[991,2960,2961],{},"Reason",[1004,2963,2964,2973,2983,2993],{},[988,2965,2966,2970],{},[1009,2967,2968],{},[842,2969,2905],{},[1009,2971,2972],{},"Gives us a publicly accessible URL for the uploaded WAV file",[988,2974,2975,2980],{},[1009,2976,2977],{},[842,2978,2979],{},"Nitro server routes",[1009,2981,2982],{},"Keeps the Suno API key on the server - never exposed to the browser",[988,2984,2985,2990],{},[1009,2986,2987],{},[842,2988,2989],{},"Polling",[1009,2991,2992],{},"Suno processes remixes asynchronously (1-3 min); we poll every 30 seconds",[988,2994,2995,2999],{},[1009,2996,2997],{},[842,2998,812],{},[1009,3000,3001],{},"Industry-standard waveform visualization for comparing original vs. remixed audio",[2710,3003],{},[746,3005,3007],{"id":3006},"tech-stack","Tech Stack",[982,3009,3010,3020],{},[985,3011,3012],{},[988,3013,3014,3017],{},[991,3015,3016],{},"Layer",[991,3018,3019],{},"Technology",[1004,3021,3022,3032,3042,3052,3063,3072,3082],{},[988,3023,3024,3027],{},[1009,3025,3026],{},"Frontend",[1009,3028,3029,3031],{},[842,3030,2826],{}," + Vue 3 + Nuxt UI",[988,3033,3034,3037],{},[1009,3035,3036],{},"Styling",[1009,3038,3039],{},[842,3040,3041],{},"Tailwind CSS 4",[988,3043,3044,3047],{},[1009,3045,3046],{},"Audio Visualization",[1009,3048,3049],{},[842,3050,3051],{},"WaveSurfer.js 7",[988,3053,3054,3057],{},[1009,3055,3056],{},"Server",[1009,3058,3059,3062],{},[842,3060,3061],{},"Nitro"," (built into Nuxt)",[988,3064,3065,3068],{},[1009,3066,3067],{},"Storage",[1009,3069,3070],{},[842,3071,2905],{},[988,3073,3074,3077],{},[1009,3075,3076],{},"Hosting",[1009,3078,3079],{},[842,3080,3081],{},"Firebase Hosting",[988,3083,3084,3087],{},[1009,3085,3086],{},"API",[1009,3088,3089,3091],{},[842,3090,2872],{}," (third-party Suno proxy)",[2710,3093],{},[746,3095,3097],{"id":3096},"the-key-technical-challenge-upload-flow","The Key Technical Challenge: Upload Flow",[751,3099,3100],{},"The most interesting part of this project is how we bridge the gap between a user's local WAV file and Suno's requirement for a public URL.",[1065,3102,3104],{"id":3103},"step-1-upload-to-firebase-storage","Step 1: Upload to Firebase Storage",[751,3106,3107,3108,3111],{},"We created a ",[963,3109,3110],{},"useFirebaseStorage"," composable that handles the upload with progress tracking:",[1189,3113,3118],{"className":3114,"code":3115,"filename":3116,"language":3117,"meta":902,"style":902},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { getStorage, ref as storageRef, uploadBytesResumable, getDownloadURL } from 'firebase/storage'\n\nasync function uploadWavFile(file: File): Promise\u003Cstring> {\n  const storage = getStorage(app)\n  const fileName = `${crypto.randomUUID()}.wav`\n  const fileRef = storageRef(storage, `uploads/${fileName}`)\n\n  const uploadTask = uploadBytesResumable(fileRef, file, {\n    contentType: 'audio/wav',\n  })\n\n  return new Promise((resolve, reject) => {\n    uploadTask.on('state_changed',\n      (snapshot) => {\n        // Track progress (0-100%)\n        uploadProgress.value = Math.round(\n          (snapshot.bytesTransferred / snapshot.totalBytes) * 100\n        )\n      },\n      reject,\n      async () => {\n        // Get the public download URL\n        const downloadUrl = await getDownloadURL(uploadTask.snapshot.ref)\n        resolve(downloadUrl)\n      }\n    )\n  })\n}\n","useFirebaseStorage.ts","typescript",[963,3119,3120,3167,3171,3210,3231,3263,3298,3302,3327,3343,3350,3354,3383,3404,3418,3423,3445,3477,3482,3488,3496,3509,3515,3547,3560,3566,3572,3579],{"__ignoreMap":902},[1197,3121,3122,3125,3128,3131,3133,3136,3139,3142,3144,3147,3149,3152,3155,3158,3161,3164],{"class":1199,"line":1200},[1197,3123,3124],{"class":1623},"import",[1197,3126,3127],{"class":1203}," {",[1197,3129,3130],{"class":1536}," getStorage",[1197,3132,1250],{"class":1203},[1197,3134,3135],{"class":1536}," ref",[1197,3137,3138],{"class":1623}," as",[1197,3140,3141],{"class":1536}," storageRef",[1197,3143,1250],{"class":1203},[1197,3145,3146],{"class":1536}," uploadBytesResumable",[1197,3148,1250],{"class":1203},[1197,3150,3151],{"class":1536}," getDownloadURL",[1197,3153,3154],{"class":1203}," }",[1197,3156,3157],{"class":1623}," from",[1197,3159,3160],{"class":1203}," '",[1197,3162,3163],{"class":1244},"firebase/storage",[1197,3165,3166],{"class":1203},"'\n",[1197,3168,3169],{"class":1199,"line":903},[1197,3170,1579],{"emptyLinePlaceholder":918},[1197,3172,3173,3176,3179,3182,3184,3187,3189,3192,3195,3198,3201,3204,3207],{"class":1199,"line":1225},[1197,3174,3175],{"class":1212},"async",[1197,3177,3178],{"class":1212}," function",[1197,3180,3181],{"class":1587}," uploadWavFile",[1197,3183,1591],{"class":1203},[1197,3185,3186],{"class":1594},"file",[1197,3188,1219],{"class":1203},[1197,3190,3191],{"class":1234}," File",[1197,3193,3194],{"class":1203},"):",[1197,3196,3197],{"class":1234}," Promise",[1197,3199,3200],{"class":1203},"\u003C",[1197,3202,3203],{"class":1234},"string",[1197,3205,3206],{"class":1203},">",[1197,3208,3209],{"class":1203}," {\n",[1197,3211,3212,3215,3218,3221,3223,3226,3229],{"class":1199,"line":1269},[1197,3213,3214],{"class":1212},"  const",[1197,3216,3217],{"class":1536}," storage",[1197,3219,3220],{"class":1203}," =",[1197,3222,3130],{"class":1587},[1197,3224,1591],{"class":3225},"swJcz",[1197,3227,3228],{"class":1536},"app",[1197,3230,1757],{"class":3225},[1197,3232,3233,3235,3238,3240,3243,3246,3248,3251,3254,3257,3260],{"class":1199,"line":1304},[1197,3234,3214],{"class":1212},[1197,3236,3237],{"class":1536}," fileName",[1197,3239,3220],{"class":1203},[1197,3241,3242],{"class":1203}," `${",[1197,3244,3245],{"class":1536},"crypto",[1197,3247,1675],{"class":1203},[1197,3249,3250],{"class":1587},"randomUUID",[1197,3252,3253],{"class":1536},"()",[1197,3255,3256],{"class":1203},"}",[1197,3258,3259],{"class":1244},".wav",[1197,3261,3262],{"class":1203},"`\n",[1197,3264,3265,3267,3270,3272,3274,3276,3279,3281,3284,3287,3290,3293,3296],{"class":1199,"line":1339},[1197,3266,3214],{"class":1212},[1197,3268,3269],{"class":1536}," fileRef",[1197,3271,3220],{"class":1203},[1197,3273,3141],{"class":1587},[1197,3275,1591],{"class":3225},[1197,3277,3278],{"class":1536},"storage",[1197,3280,1250],{"class":1203},[1197,3282,3283],{"class":1203}," `",[1197,3285,3286],{"class":1244},"uploads/",[1197,3288,3289],{"class":1203},"${",[1197,3291,3292],{"class":1536},"fileName",[1197,3294,3295],{"class":1203},"}`",[1197,3297,1757],{"class":3225},[1197,3299,3300],{"class":1199,"line":1374},[1197,3301,1579],{"emptyLinePlaceholder":918},[1197,3303,3304,3306,3309,3311,3313,3315,3318,3320,3323,3325],{"class":1199,"line":1410},[1197,3305,3214],{"class":1212},[1197,3307,3308],{"class":1536}," uploadTask",[1197,3310,3220],{"class":1203},[1197,3312,3146],{"class":1587},[1197,3314,1591],{"class":3225},[1197,3316,3317],{"class":1536},"fileRef",[1197,3319,1250],{"class":1203},[1197,3321,3322],{"class":1536}," file",[1197,3324,1250],{"class":1203},[1197,3326,3209],{"class":1203},[1197,3328,3329,3332,3334,3336,3339,3341],{"class":1199,"line":1416},[1197,3330,3331],{"class":3225},"    contentType",[1197,3333,1219],{"class":1203},[1197,3335,3160],{"class":1203},[1197,3337,3338],{"class":1244},"audio/wav",[1197,3340,1683],{"class":1203},[1197,3342,1915],{"class":1203},[1197,3344,3345,3348],{"class":1199,"line":1766},[1197,3346,3347],{"class":1203},"  }",[1197,3349,1757],{"class":3225},[1197,3351,3352],{"class":1199,"line":2063},[1197,3353,1579],{"emptyLinePlaceholder":918},[1197,3355,3356,3359,3362,3364,3366,3368,3371,3373,3376,3378,3381],{"class":1199,"line":2109},[1197,3357,3358],{"class":1623},"  return",[1197,3360,3361],{"class":1203}," new",[1197,3363,3197],{"class":1234},[1197,3365,1591],{"class":3225},[1197,3367,1591],{"class":1203},[1197,3369,3370],{"class":1594},"resolve",[1197,3372,1250],{"class":1203},[1197,3374,3375],{"class":1594}," reject",[1197,3377,1603],{"class":1203},[1197,3379,3380],{"class":1212}," =>",[1197,3382,3209],{"class":1203},[1197,3384,3385,3388,3390,3393,3395,3397,3400,3402],{"class":1199,"line":2152},[1197,3386,3387],{"class":1536},"    uploadTask",[1197,3389,1675],{"class":1203},[1197,3391,3392],{"class":1587},"on",[1197,3394,1591],{"class":3225},[1197,3396,1683],{"class":1203},[1197,3398,3399],{"class":1244},"state_changed",[1197,3401,1683],{"class":1203},[1197,3403,1915],{"class":1203},[1197,3405,3406,3409,3412,3414,3416],{"class":1199,"line":2158},[1197,3407,3408],{"class":1203},"      (",[1197,3410,3411],{"class":1594},"snapshot",[1197,3413,1603],{"class":1203},[1197,3415,3380],{"class":1212},[1197,3417,3209],{"class":1203},[1197,3419,3420],{"class":1199,"line":2171},[1197,3421,3422],{"class":1762},"        // Track progress (0-100%)\n",[1197,3424,3425,3428,3430,3432,3434,3437,3439,3442],{"class":1199,"line":2237},[1197,3426,3427],{"class":1536},"        uploadProgress",[1197,3429,1675],{"class":1203},[1197,3431,1749],{"class":1536},[1197,3433,3220],{"class":1203},[1197,3435,3436],{"class":1536}," Math",[1197,3438,1675],{"class":1203},[1197,3440,3441],{"class":1587},"round",[1197,3443,3444],{"class":3225},"(\n",[1197,3446,3447,3450,3452,3454,3457,3460,3463,3465,3468,3471,3474],{"class":1199,"line":2300},[1197,3448,3449],{"class":3225},"          (",[1197,3451,3411],{"class":1536},[1197,3453,1675],{"class":1203},[1197,3455,3456],{"class":1536},"bytesTransferred",[1197,3458,3459],{"class":1203}," /",[1197,3461,3462],{"class":1536}," snapshot",[1197,3464,1675],{"class":1203},[1197,3466,3467],{"class":1536},"totalBytes",[1197,3469,3470],{"class":3225},") ",[1197,3472,3473],{"class":1203},"*",[1197,3475,3476],{"class":1262}," 100\n",[1197,3478,3479],{"class":1199,"line":2305},[1197,3480,3481],{"class":3225},"        )\n",[1197,3483,3485],{"class":1199,"line":3484},19,[1197,3486,3487],{"class":1203},"      },\n",[1197,3489,3491,3494],{"class":1199,"line":3490},20,[1197,3492,3493],{"class":1536},"      reject",[1197,3495,1915],{"class":1203},[1197,3497,3499,3502,3505,3507],{"class":1199,"line":3498},21,[1197,3500,3501],{"class":1212},"      async",[1197,3503,3504],{"class":1203}," ()",[1197,3506,3380],{"class":1212},[1197,3508,3209],{"class":1203},[1197,3510,3512],{"class":1199,"line":3511},22,[1197,3513,3514],{"class":1762},"        // Get the public download URL\n",[1197,3516,3518,3521,3524,3526,3529,3531,3533,3536,3538,3540,3542,3545],{"class":1199,"line":3517},23,[1197,3519,3520],{"class":1212},"        const",[1197,3522,3523],{"class":1536}," downloadUrl",[1197,3525,3220],{"class":1203},[1197,3527,3528],{"class":1623}," await",[1197,3530,3151],{"class":1587},[1197,3532,1591],{"class":3225},[1197,3534,3535],{"class":1536},"uploadTask",[1197,3537,1675],{"class":1203},[1197,3539,3411],{"class":1536},[1197,3541,1675],{"class":1203},[1197,3543,3544],{"class":1536},"ref",[1197,3546,1757],{"class":3225},[1197,3548,3550,3553,3555,3558],{"class":1199,"line":3549},24,[1197,3551,3552],{"class":1587},"        resolve",[1197,3554,1591],{"class":3225},[1197,3556,3557],{"class":1536},"downloadUrl",[1197,3559,1757],{"class":3225},[1197,3561,3563],{"class":1199,"line":3562},25,[1197,3564,3565],{"class":1203},"      }\n",[1197,3567,3569],{"class":1199,"line":3568},26,[1197,3570,3571],{"class":3225},"    )\n",[1197,3573,3575,3577],{"class":1199,"line":3574},27,[1197,3576,3347],{"class":1203},[1197,3578,1757],{"class":3225},[1197,3580,3582],{"class":1199,"line":3581},28,[1197,3583,1419],{"class":1203},[751,3585,1441,3586,3589],{},[963,3587,3588],{},"getDownloadURL()"," call returns a publicly accessible Firebase Storage URL - exactly what Suno needs.",[1065,3591,3593],{"id":3592},"step-2-call-the-suno-api-via-server-proxy","Step 2: Call the Suno API (via server proxy)",[751,3595,3596],{},"We never call Suno directly from the browser. Instead, we use a Nitro server route that reads the API key from server-only runtime configuration:",[1189,3598,3601],{"className":3114,"code":3599,"filename":3600,"language":3117,"meta":902,"style":902},"export default defineEventHandler(async (event) => {\n  const body = await readBody(event)\n  const config = useRuntimeConfig()\n\n  const result = await fetch('https://api.sunoapi.org/api/v1/generate/upload-cover', {\n    method: 'POST',\n    headers: {\n      'Authorization': `Bearer ${config.sunoApiKey}`,\n      'Content-Type': 'application/json',\n    },\n    body: JSON.stringify({\n      uploadUrl: body.uploadUrl,\n      customMode: true,\n      style: body.style,\n      title: body.title,\n      model: 'V4_5',\n    }),\n  })\n\n  const data = await result.json()\n  return { taskId: data.data.taskId }\n})\n","server/api/remix.post.ts",[963,3602,3603,3630,3650,3665,3669,3696,3712,3721,3752,3772,3777,3796,3812,3824,3839,3855,3871,3880,3886,3890,3908,3932],{"__ignoreMap":902},[1197,3604,3605,3608,3611,3614,3616,3618,3621,3624,3626,3628],{"class":1199,"line":1200},[1197,3606,3607],{"class":1623},"export",[1197,3609,3610],{"class":1623}," default",[1197,3612,3613],{"class":1587}," defineEventHandler",[1197,3615,1591],{"class":1536},[1197,3617,3175],{"class":1212},[1197,3619,3620],{"class":1203}," (",[1197,3622,3623],{"class":1594},"event",[1197,3625,1603],{"class":1203},[1197,3627,3380],{"class":1212},[1197,3629,3209],{"class":1203},[1197,3631,3632,3634,3637,3639,3641,3644,3646,3648],{"class":1199,"line":903},[1197,3633,3214],{"class":1212},[1197,3635,3636],{"class":1536}," body",[1197,3638,3220],{"class":1203},[1197,3640,3528],{"class":1623},[1197,3642,3643],{"class":1587}," readBody",[1197,3645,1591],{"class":3225},[1197,3647,3623],{"class":1536},[1197,3649,1757],{"class":3225},[1197,3651,3652,3654,3657,3659,3662],{"class":1199,"line":1225},[1197,3653,3214],{"class":1212},[1197,3655,3656],{"class":1536}," config",[1197,3658,3220],{"class":1203},[1197,3660,3661],{"class":1587}," useRuntimeConfig",[1197,3663,3664],{"class":3225},"()\n",[1197,3666,3667],{"class":1199,"line":1269},[1197,3668,1579],{"emptyLinePlaceholder":918},[1197,3670,3671,3673,3676,3678,3680,3683,3685,3687,3690,3692,3694],{"class":1199,"line":1304},[1197,3672,3214],{"class":1212},[1197,3674,3675],{"class":1536}," result",[1197,3677,3220],{"class":1203},[1197,3679,3528],{"class":1623},[1197,3681,3682],{"class":1587}," fetch",[1197,3684,1591],{"class":3225},[1197,3686,1683],{"class":1203},[1197,3688,3689],{"class":1244},"https://api.sunoapi.org/api/v1/generate/upload-cover",[1197,3691,1683],{"class":1203},[1197,3693,1250],{"class":1203},[1197,3695,3209],{"class":1203},[1197,3697,3698,3701,3703,3705,3708,3710],{"class":1199,"line":1339},[1197,3699,3700],{"class":3225},"    method",[1197,3702,1219],{"class":1203},[1197,3704,3160],{"class":1203},[1197,3706,3707],{"class":1244},"POST",[1197,3709,1683],{"class":1203},[1197,3711,1915],{"class":1203},[1197,3713,3714,3717,3719],{"class":1199,"line":1374},[1197,3715,3716],{"class":3225},"    headers",[1197,3718,1219],{"class":1203},[1197,3720,3209],{"class":1203},[1197,3722,3723,3726,3729,3731,3733,3735,3738,3740,3743,3745,3748,3750],{"class":1199,"line":1410},[1197,3724,3725],{"class":1203},"      '",[1197,3727,3728],{"class":3225},"Authorization",[1197,3730,1683],{"class":1203},[1197,3732,1219],{"class":1203},[1197,3734,3283],{"class":1203},[1197,3736,3737],{"class":1244},"Bearer ",[1197,3739,3289],{"class":1203},[1197,3741,3742],{"class":1536},"config",[1197,3744,1675],{"class":1203},[1197,3746,3747],{"class":1536},"sunoApiKey",[1197,3749,3295],{"class":1203},[1197,3751,1915],{"class":1203},[1197,3753,3754,3756,3759,3761,3763,3765,3768,3770],{"class":1199,"line":1416},[1197,3755,3725],{"class":1203},[1197,3757,3758],{"class":3225},"Content-Type",[1197,3760,1683],{"class":1203},[1197,3762,1219],{"class":1203},[1197,3764,3160],{"class":1203},[1197,3766,3767],{"class":1244},"application/json",[1197,3769,1683],{"class":1203},[1197,3771,1915],{"class":1203},[1197,3773,3774],{"class":1199,"line":1766},[1197,3775,3776],{"class":1203},"    },\n",[1197,3778,3779,3782,3784,3787,3789,3792,3794],{"class":1199,"line":2063},[1197,3780,3781],{"class":3225},"    body",[1197,3783,1219],{"class":1203},[1197,3785,3786],{"class":1536}," JSON",[1197,3788,1675],{"class":1203},[1197,3790,3791],{"class":1587},"stringify",[1197,3793,1591],{"class":3225},[1197,3795,1204],{"class":1203},[1197,3797,3798,3801,3803,3805,3807,3810],{"class":1199,"line":2109},[1197,3799,3800],{"class":3225},"      uploadUrl",[1197,3802,1219],{"class":1203},[1197,3804,3636],{"class":1536},[1197,3806,1675],{"class":1203},[1197,3808,3809],{"class":1536},"uploadUrl",[1197,3811,1915],{"class":1203},[1197,3813,3814,3817,3819,3822],{"class":1199,"line":2152},[1197,3815,3816],{"class":3225},"      customMode",[1197,3818,1219],{"class":1203},[1197,3820,2104],{"class":3821},"sfNiH",[1197,3823,1915],{"class":1203},[1197,3825,3826,3829,3831,3833,3835,3837],{"class":1199,"line":2158},[1197,3827,3828],{"class":3225},"      style",[1197,3830,1219],{"class":1203},[1197,3832,3636],{"class":1536},[1197,3834,1675],{"class":1203},[1197,3836,2757],{"class":1536},[1197,3838,1915],{"class":1203},[1197,3840,3841,3844,3846,3848,3850,3853],{"class":1199,"line":2171},[1197,3842,3843],{"class":3225},"      title",[1197,3845,1219],{"class":1203},[1197,3847,3636],{"class":1536},[1197,3849,1675],{"class":1203},[1197,3851,3852],{"class":1536},"title",[1197,3854,1915],{"class":1203},[1197,3856,3857,3860,3862,3864,3867,3869],{"class":1199,"line":2237},[1197,3858,3859],{"class":3225},"      model",[1197,3861,1219],{"class":1203},[1197,3863,3160],{"class":1203},[1197,3865,3866],{"class":1244},"V4_5",[1197,3868,1683],{"class":1203},[1197,3870,1915],{"class":1203},[1197,3872,3873,3876,3878],{"class":1199,"line":2300},[1197,3874,3875],{"class":1203},"    }",[1197,3877,1603],{"class":3225},[1197,3879,1915],{"class":1203},[1197,3881,3882,3884],{"class":1199,"line":2305},[1197,3883,3347],{"class":1203},[1197,3885,1757],{"class":3225},[1197,3887,3888],{"class":1199,"line":3484},[1197,3889,1579],{"emptyLinePlaceholder":918},[1197,3891,3892,3894,3896,3898,3900,3902,3904,3906],{"class":1199,"line":3490},[1197,3893,3214],{"class":1212},[1197,3895,1693],{"class":1536},[1197,3897,3220],{"class":1203},[1197,3899,3528],{"class":1623},[1197,3901,3675],{"class":1536},[1197,3903,1675],{"class":1203},[1197,3905,1193],{"class":1587},[1197,3907,3664],{"class":3225},[1197,3909,3910,3912,3914,3917,3919,3921,3923,3925,3927,3930],{"class":1199,"line":3498},[1197,3911,3358],{"class":1623},[1197,3913,3127],{"class":1203},[1197,3915,3916],{"class":3225}," taskId",[1197,3918,1219],{"class":1203},[1197,3920,1693],{"class":1536},[1197,3922,1675],{"class":1203},[1197,3924,1595],{"class":1536},[1197,3926,1675],{"class":1203},[1197,3928,3929],{"class":1536},"taskId",[1197,3931,1407],{"class":1203},[1197,3933,3934,3936],{"class":1199,"line":3511},[1197,3935,3256],{"class":1203},[1197,3937,1757],{"class":1536},[872,3939,3940],{},[751,3941,1441,3942,3945,3946,3949,3950,3953,3954,3957],{},[963,3943,3944],{},"NUXT_SUNO_API_KEY"," environment variable is mapped to ",[963,3947,3948],{},"runtimeConfig.sunoApiKey"," (without ",[963,3951,3952],{},"public","), which means Nuxt ",[842,3955,3956],{},"never bundles it into client-side JavaScript",". This is the correct way to handle API secrets in Nuxt.",[1065,3959,3961],{"id":3960},"step-3-poll-for-results","Step 3: Poll for Results",[751,3963,3964],{},"Suno processes remixes asynchronously. We poll every 30 seconds:",[1189,3966,3969],{"className":3114,"code":3967,"filename":3968,"language":3117,"meta":902,"style":902},"pollInterval = setInterval(async () => {\n  const result = await $fetch(`/api/remix/${taskId.value}`)\n\n  if (result.status === 'SUCCESS') {\n    tracks.value = result.tracks\n    status.value = 'completed'\n    stopPolling()\n  }\n}, 30000)\n","useSunoRemix.ts",[963,3970,3971,3991,4024,4028,4056,4074,4092,4099,4104],{"__ignoreMap":902},[1197,3972,3973,3976,3978,3981,3983,3985,3987,3989],{"class":1199,"line":1200},[1197,3974,3975],{"class":1536},"pollInterval ",[1197,3977,1540],{"class":1203},[1197,3979,3980],{"class":1587}," setInterval",[1197,3982,1591],{"class":1536},[1197,3984,3175],{"class":1212},[1197,3986,3504],{"class":1203},[1197,3988,3380],{"class":1212},[1197,3990,3209],{"class":1203},[1197,3992,3993,3995,3997,3999,4001,4004,4006,4009,4012,4014,4016,4018,4020,4022],{"class":1199,"line":903},[1197,3994,3214],{"class":1212},[1197,3996,3675],{"class":1536},[1197,3998,3220],{"class":1203},[1197,4000,3528],{"class":1623},[1197,4002,4003],{"class":1587}," $fetch",[1197,4005,1591],{"class":3225},[1197,4007,4008],{"class":1203},"`",[1197,4010,4011],{"class":1244},"/api/remix/",[1197,4013,3289],{"class":1203},[1197,4015,3929],{"class":1536},[1197,4017,1675],{"class":1203},[1197,4019,1749],{"class":1536},[1197,4021,3295],{"class":1203},[1197,4023,1757],{"class":3225},[1197,4025,4026],{"class":1199,"line":1225},[1197,4027,1579],{"emptyLinePlaceholder":918},[1197,4029,4030,4033,4035,4037,4039,4042,4045,4047,4050,4052,4054],{"class":1199,"line":1269},[1197,4031,4032],{"class":1623},"  if",[1197,4034,3620],{"class":3225},[1197,4036,869],{"class":1536},[1197,4038,1675],{"class":1203},[1197,4040,4041],{"class":1536},"status",[1197,4043,4044],{"class":1203}," ===",[1197,4046,3160],{"class":1203},[1197,4048,4049],{"class":1244},"SUCCESS",[1197,4051,1683],{"class":1203},[1197,4053,3470],{"class":3225},[1197,4055,1204],{"class":1203},[1197,4057,4058,4061,4063,4065,4067,4069,4071],{"class":1199,"line":1304},[1197,4059,4060],{"class":1536},"    tracks",[1197,4062,1675],{"class":1203},[1197,4064,1749],{"class":1536},[1197,4066,3220],{"class":1203},[1197,4068,3675],{"class":1536},[1197,4070,1675],{"class":1203},[1197,4072,4073],{"class":1536},"tracks\n",[1197,4075,4076,4079,4081,4083,4085,4087,4090],{"class":1199,"line":1339},[1197,4077,4078],{"class":1536},"    status",[1197,4080,1675],{"class":1203},[1197,4082,1749],{"class":1536},[1197,4084,3220],{"class":1203},[1197,4086,3160],{"class":1203},[1197,4088,4089],{"class":1244},"completed",[1197,4091,3166],{"class":1203},[1197,4093,4094,4097],{"class":1199,"line":1374},[1197,4095,4096],{"class":1587},"    stopPolling",[1197,4098,3664],{"class":3225},[1197,4100,4101],{"class":1199,"line":1410},[1197,4102,4103],{"class":1203},"  }\n",[1197,4105,4106,4109,4112],{"class":1199,"line":1416},[1197,4107,4108],{"class":1203},"},",[1197,4110,4111],{"class":1262}," 30000",[1197,4113,1757],{"class":1536},[751,4115,4116,4117,4120],{},"When the remix is ready, the response includes an ",[963,4118,4119],{},"audio_url"," pointing to the generated track on Suno's CDN (Content Delivery Network).",[2710,4122],{},[746,4124,4126],{"id":4125},"building-the-frontend","Building the Frontend",[751,4128,4129],{},"The UI is intentionally simple - this is a PoC, after all. The entire flow happens on a single page:",[2683,4131,4132,4138,4144,4150],{},[1162,4133,4134,4137],{},[842,4135,4136],{},"UploadZone"," - Drag-and-drop or file picker with WAV/MP3 validation (max 50 MB)",[1162,4139,4140,4143],{},[842,4141,4142],{},"StyleSelector"," - Genre dropdown (16 genres), title input, and instrumental toggle",[1162,4145,4146,4149],{},[842,4147,4148],{},"ProgressIndicator"," - 3-step progress bar with upload percentage",[1162,4151,4152,4155],{},[842,4153,4154],{},"AudioComparison"," - Side-by-side WaveSurfer.js players for original and remixed audio",[751,4157,4158],{},"Here's what the upload screen looks like:",[751,4160,4161],{},[1430,4162],{"alt":4163,"src":4164},"Upload & Configure - drag-drop zone with genre selector and Remix button","/images/blog/suno-remix-poc-upload.webp",[751,4166,4167,4168,4171],{},"Once you hit ",[842,4169,4170],{},"Remix",", the app uploads the file to Firebase Storage and kicks off the AI processing. The 3-step progress indicator keeps you informed:",[751,4173,4174],{},[1430,4175],{"alt":4176,"src":4177},"Progress indicator - Upload to Cloud → AI Remix → Done","/images/blog/suno-remix-poc-progress.webp",[751,4179,4180],{},"When the remix is complete, you get a side-by-side comparison with waveform visualization - the original on the left, and the AI-generated remix(es) alongside it:",[751,4182,4183],{},[1430,4184],{"alt":4185,"src":4186},"Results - original and remixed audio with WaveSurfer.js waveforms","/images/blog/suno-remix-poc-results.webp",[1065,4188,1882],{"id":1881},[751,4190,4191,4192,4195],{},"We wrapped WaveSurfer.js in a Vue component with ",[963,4193,4194],{},"\u003CClientOnly>"," to avoid SSR (Server-Side Rendering) issues:",[1189,4197,4202],{"className":4198,"code":4199,"filename":4200,"language":4201,"meta":902,"style":902},"language-vue shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u003CClientOnly>\n  \u003CWaveformPlayer\n    :audio-url=\"track.audioUrl\"\n    label=\"Remix - Jazz\"\n  />\n\u003C/ClientOnly>\n","WaveformPlayer.vue","vue",[963,4203,4204,4214,4219,4224,4229,4234],{"__ignoreMap":902},[1197,4205,4206,4208,4211],{"class":1199,"line":1200},[1197,4207,3200],{"class":1203},[1197,4209,4210],{"class":3225},"ClientOnly",[1197,4212,4213],{"class":1203},">\n",[1197,4215,4216],{"class":1199,"line":903},[1197,4217,4218],{"class":1536},"  \u003CWaveformPlayer\n",[1197,4220,4221],{"class":1199,"line":1225},[1197,4222,4223],{"class":1536},"    :audio-url=\"track.audioUrl\"\n",[1197,4225,4226],{"class":1199,"line":1269},[1197,4227,4228],{"class":1536},"    label=\"Remix - Jazz\"\n",[1197,4230,4231],{"class":1199,"line":1304},[1197,4232,4233],{"class":1536},"  />\n",[1197,4235,4236,4239,4241],{"class":1199,"line":1339},[1197,4237,4238],{"class":1203},"\u003C/",[1197,4240,4210],{"class":3225},[1197,4242,4213],{"class":1203},[751,4244,4245],{},"The player provides play/pause controls, a progress bar, and time display - all styled to match the dark theme.",[2710,4247],{},[746,4249,4251],{"id":4250},"deployment-to-firebase","Deployment to Firebase",[751,4253,4254],{},"Firebase Hosting serves the Nuxt static output. The setup is straightforward:",[1189,4256,4259],{"className":1191,"code":4257,"filename":4258,"language":1193,"meta":902,"style":902},"{\n  \"hosting\": {\n    \"public\": \".output/public\",\n    \"cleanUrls\": true,\n    \"rewrites\": [\n      { \"source\": \"**\", \"destination\": \"/index.html\" }\n    ]\n  },\n  \"storage\": {\n    \"rules\": \"firebase-storage.rules\"\n  }\n}\n","firebase.json",[963,4260,4261,4265,4278,4298,4312,4325,4365,4370,4375,4387,4406,4410],{"__ignoreMap":902},[1197,4262,4263],{"class":1199,"line":1200},[1197,4264,1204],{"class":1203},[1197,4266,4267,4269,4272,4274,4276],{"class":1199,"line":903},[1197,4268,1209],{"class":1203},[1197,4270,4271],{"class":1212},"hosting",[1197,4273,1216],{"class":1203},[1197,4275,1219],{"class":1203},[1197,4277,3209],{"class":1203},[1197,4279,4280,4283,4285,4287,4289,4291,4294,4296],{"class":1199,"line":1225},[1197,4281,4282],{"class":1203},"    \"",[1197,4284,3952],{"class":1234},[1197,4286,1216],{"class":1203},[1197,4288,1219],{"class":1203},[1197,4290,1231],{"class":1203},[1197,4292,4293],{"class":1244},".output/public",[1197,4295,1216],{"class":1203},[1197,4297,1915],{"class":1203},[1197,4299,4300,4302,4305,4307,4309],{"class":1199,"line":1269},[1197,4301,4282],{"class":1203},[1197,4303,4304],{"class":1234},"cleanUrls",[1197,4306,1216],{"class":1203},[1197,4308,1219],{"class":1203},[1197,4310,4311],{"class":1203}," true,\n",[1197,4313,4314,4316,4319,4321,4323],{"class":1199,"line":1304},[1197,4315,4282],{"class":1203},[1197,4317,4318],{"class":1234},"rewrites",[1197,4320,1216],{"class":1203},[1197,4322,1219],{"class":1203},[1197,4324,1222],{"class":1203},[1197,4326,4327,4330,4332,4334,4336,4338,4340,4343,4345,4347,4349,4352,4354,4356,4358,4361,4363],{"class":1199,"line":1339},[1197,4328,4329],{"class":1203},"      {",[1197,4331,1231],{"class":1203},[1197,4333,2319],{"class":1262},[1197,4335,1216],{"class":1203},[1197,4337,1219],{"class":1203},[1197,4339,1231],{"class":1203},[1197,4341,4342],{"class":1244},"**",[1197,4344,1216],{"class":1203},[1197,4346,1250],{"class":1203},[1197,4348,1231],{"class":1203},[1197,4350,4351],{"class":1262},"destination",[1197,4353,1216],{"class":1203},[1197,4355,1219],{"class":1203},[1197,4357,1231],{"class":1203},[1197,4359,4360],{"class":1244},"/index.html",[1197,4362,1216],{"class":1203},[1197,4364,1407],{"class":1203},[1197,4366,4367],{"class":1199,"line":1374},[1197,4368,4369],{"class":1203},"    ]\n",[1197,4371,4372],{"class":1199,"line":1410},[1197,4373,4374],{"class":1203},"  },\n",[1197,4376,4377,4379,4381,4383,4385],{"class":1199,"line":1416},[1197,4378,1209],{"class":1203},[1197,4380,3278],{"class":1212},[1197,4382,1216],{"class":1203},[1197,4384,1219],{"class":1203},[1197,4386,3209],{"class":1203},[1197,4388,4389,4391,4394,4396,4398,4400,4403],{"class":1199,"line":1766},[1197,4390,4282],{"class":1203},[1197,4392,4393],{"class":1234},"rules",[1197,4395,1216],{"class":1203},[1197,4397,1219],{"class":1203},[1197,4399,1231],{"class":1203},[1197,4401,4402],{"class":1244},"firebase-storage.rules",[1197,4404,4405],{"class":1203},"\"\n",[1197,4407,4408],{"class":1199,"line":2063},[1197,4409,4103],{"class":1203},[1197,4411,4412],{"class":1199,"line":2109},[1197,4413,1419],{"class":1203},[751,4415,4416],{},"Firebase Storage rules restrict uploads to WAV and MP3 files under 50 MB:",[1189,4418,4423],{"className":4419,"code":4421,"language":4422},[4420],"language-text","match /uploads/{fileName} {\n  allow write: if request.resource.size \u003C 50 * 1024 * 1024\n               && (request.resource.contentType == 'audio/wav'\n                   || request.resource.contentType == 'audio/mpeg');\n  allow read: if true;\n}\n","text",[963,4424,4421],{"__ignoreMap":902},[751,4426,4427],{},"Deploy with:",[1189,4429,4431],{"className":2369,"code":4430,"language":2372,"meta":902,"style":902},"pnpm build\nfirebase deploy\n",[963,4432,4433,4441],{"__ignoreMap":902},[1197,4434,4435,4438],{"class":1199,"line":1200},[1197,4436,4437],{"class":1234},"pnpm",[1197,4439,4440],{"class":1244}," build\n",[1197,4442,4443,4446],{"class":1199,"line":903},[1197,4444,4445],{"class":1234},"firebase",[1197,4447,4448],{"class":1244}," deploy\n",[2710,4450],{},[746,4452,4454],{"id":4453},"security-considerations","Security Considerations",[751,4456,4457],{},"Even for a PoC, security matters:",[982,4459,4460,4470],{},[985,4461,4462],{},[988,4463,4464,4467],{},[991,4465,4466],{},"Concern",[991,4468,4469],{},"Solution",[1004,4471,4472,4489,4499,4509],{},[988,4473,4474,4479],{},[1009,4475,4476],{},[842,4477,4478],{},"API key exposure",[1009,4480,4481,4482,4485,4486],{},"Stored in ",[963,4483,4484],{},"runtimeConfig"," (server-only), never in ",[963,4487,4488],{},"runtimeConfig.public",[988,4490,4491,4496],{},[1009,4492,4493],{},[842,4494,4495],{},"File abuse",[1009,4497,4498],{},"Firebase Storage rules: WAV/MP3 only, 50 MB max",[988,4500,4501,4506],{},[1009,4502,4503],{},[842,4504,4505],{},"Input validation",[1009,4507,4508],{},"Server routes validate URL format, string lengths",[988,4510,4511,4516],{},[1009,4512,4513],{},[842,4514,4515],{},"Secrets in git",[1009,4517,4518,4521,4522,4525,4526,4529],{},[963,4519,4520],{},".env"," in ",[963,4523,4524],{},".gitignore","; only ",[963,4527,4528],{},".env.example"," committed",[2710,4531],{},[746,4533,4535],{"id":4534},"watch-out-copyright-detection","Watch Out: Copyright Detection",[751,4537,4538,4539,4542],{},"One thing that caught us off guard during testing - Suno has ",[842,4540,4541],{},"built-in copyright detection",". When we tried remixing a well-known track (AC/DC's \"Back in Black\"), the API returned an error:",[1189,4544,4547],{"className":4545,"code":4546,"language":4422},[4420],"Error code: 413\nError message: Uploaded audio matches existing work of art.\n",[963,4548,4546],{"__ignoreMap":902},[751,4550,4551,4552,4555],{},"Suno's system fingerprints uploaded audio and compares it against known copyrighted works. If it detects a match, the remix is rejected with a ",[963,4553,4554],{},"GENERATE_AUDIO_FAILED"," status.",[794,4557,4558],{},[751,4559,4560,4561,4564],{},"Only upload ",[842,4562,4563],{},"original recordings"," or content you have rights to. Suno will reject copyrighted material, and repeated violations may affect your API account.",[751,4566,4567],{},"This is actually a responsible feature - it prevents the platform from being used to create unauthorized covers or derivatives of copyrighted music. For our PoC, we switched to an original recording and everything worked perfectly.",[2710,4569],{},[746,4571,4573],{"id":4572},"what-we-learned","What We Learned",[2683,4575,4576,4582,4588,4594,4600],{},[1162,4577,4578,4581],{},[842,4579,4580],{},"Suno's \"upload-cover\" endpoint is powerful"," - It takes an audio file and re-imagines it in a completely different style while retaining the core melody. The results can be surprisingly good.",[1162,4583,4584,4587],{},[842,4585,4586],{},"Copyright detection is real"," - Don't assume you can remix any audio. Suno actively fingerprints uploads and blocks copyrighted material with error code 413.",[1162,4589,4590,4593],{},[842,4591,4592],{},"The public URL requirement adds complexity"," - Having to upload to Firebase Storage first adds a step, but it's a clean pattern that keeps the architecture simple.",[1162,4595,4596,4599],{},[842,4597,4598],{},"Polling is fine for a PoC"," - While webhooks would be more efficient, the 30-second polling interval works well for a demo. The typical remix takes 1-3 minutes.",[1162,4601,4602,4605],{},[842,4603,4604],{},"Nuxt 4 + Nitro is a great combo"," - Server routes give you a built-in API proxy without needing a separate backend service. Perfect for PoCs and small apps.",[2710,4607],{},[746,4609,4611],{"id":4610},"next-steps","Next Steps",[751,4613,4614],{},"This PoC demonstrates the core flow, but there are plenty of ways to extend it:",[1159,4616,4617,4623,4629,4635,4641],{},[1162,4618,4619,4622],{},[842,4620,4621],{},"Multiple styles per remix"," - Let users generate several style variations at once",[1162,4624,4625,4628],{},[842,4626,4627],{},"Audio trimming"," - Add a waveform-based trimmer before sending to Suno",[1162,4630,4631,4634],{},[842,4632,4633],{},"User accounts"," - Save remix history with Firebase Auth",[1162,4636,4637,4640],{},[842,4638,4639],{},"Batch processing"," - Upload multiple files and queue remixes",[1162,4642,4643,4646],{},[842,4644,4645],{},"Stem separation"," - Use Suno's stems endpoint to separate vocals and instruments",[2710,4648],{},[746,4650,4652],{"id":4651},"try-it-yourself","Try It Yourself",[1159,4654,4655],{},[1162,4656,4657,4660,4661],{},[842,4658,4659],{},"Live demo",": ",[807,4662,4665],{"href":4663,"rel":4664},"https://mtl-suno-poc.web.app",[811],"mtl-suno-poc.web.app",[751,4667,4668,4669,4672],{},"You'll need your own Suno API key from ",[807,4670,2872],{"href":2868,"rel":4671},[811]," and a Firebase project if you want to build something similar.",[2710,4674],{},[746,4676,2715],{"id":2714},[1159,4678,4679,4684,4689],{},[1162,4680,4681],{},[807,4682,4683],{"href":153},"How to Use Epidemic Sound MCP with Claude",[1162,4685,4686],{},[807,4687,4688],{"href":101},"Automatic Song Structure Analysis: How AI Detects Intro, Verse, Chorus",[1162,4690,4691],{},[807,4692,2722],{"href":475},[2757,4694,4695],{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}",{"title":902,"searchDepth":903,"depth":903,"links":4697},[4698,4699,4700,4701,4706,4709,4710,4711,4712,4713,4714,4715],{"id":2842,"depth":903,"text":2843},{"id":2891,"depth":903,"text":2892},{"id":3006,"depth":903,"text":3007},{"id":3096,"depth":903,"text":3097,"children":4702},[4703,4704,4705],{"id":3103,"depth":1225,"text":3104},{"id":3592,"depth":1225,"text":3593},{"id":3960,"depth":1225,"text":3961},{"id":4125,"depth":903,"text":4126,"children":4707},[4708],{"id":1881,"depth":1225,"text":1882},{"id":4250,"depth":903,"text":4251},{"id":4453,"depth":903,"text":4454},{"id":4534,"depth":903,"text":4535},{"id":4572,"depth":903,"text":4573},{"id":4610,"depth":903,"text":4611},{"id":4651,"depth":903,"text":4652},{"id":2714,"depth":903,"text":2715},"2026-02-06T00:00:00.000Z","A step-by-step guide to building a web app that remixes audio using Suno's AI, Nuxt 4, and Firebase Storage.",{"src":4719},"/images/blog/musictechlab_blog_suno-remix-poc.webp",{"enabled":918,"items":4721},[4722,4724,4727,4730],{"text":4723,"icon":922},"Suno has no official public API; third-party wrappers like sunoapi.org cost about $0.005 per credit.",{"text":4725,"icon":4726},"Firebase Storage bridges the gap between local file uploads and Suno's public URL requirement.","i-lucide-cloud",{"text":4728,"icon":4729},"Suno's built-in copyright detection rejects known copyrighted material with error code 413.","i-lucide-shield",{"text":4731,"icon":4732},"Nitro server routes keep the API key server-side so it never reaches the browser.","i-lucide-lock",{},{"title":116,"description":4717},[4736,933,934],"AI","vdlUk3pZwxfUadk0bx3d02X4tJOxLv2oe4g_c_OXEQE",{"id":4739,"title":112,"authors":4740,"badge":4743,"body":4746,"category":911,"client":741,"date":6996,"description":6997,"extension":914,"faq":741,"featured":69,"featuredOrder":741,"hidden":69,"image":6998,"keyTakeaways":7000,"meta":7013,"navigation":918,"path":113,"seo":7014,"status":741,"stem":114,"tags":7015,"teaser":741,"__hash__":7017,"score":1225},"posts/blog/music-data/building-a-custom-music-delivery-platform-on-the-revelator-api.md",[4741],{"name":946,"to":947,"avatar":4742},{"src":949},{"label":4744,"color":4745},"Distribution","#0ea5e9",{"type":743,"value":4747,"toc":6964},[4748,4755,4757,4761,4764,4818,4821,4823,4827,4830,4838,4846,4853,4855,4859,4862,4865,4869,4886,4889,4918,4922,4933,4937,4948,4952,4963,4972,4974,4978,4981,5101,5105,5168,5172,5224,5228,5231,5958,5971,5973,5977,5980,5983,5987,5990,6215,6219,6222,6400,6404,6410,6606,6629,6633,6639,6656,6663,6665,6669,6672,6680,6684,6687,6691,6694,6749,6752,6756,6759,6763,6766,6768,6772,6775,6795,6798,6852,6861,6863,6867,6870,6896,6905,6907,6911,6914,6917,6919,6923,6961],[751,4749,4750,4751,4754],{},"Music distribution has never been more accessible. Platforms like DistroKid, TuneCore, and CD Baby democratized access to DSPs (Digital Service Providers) for independent artists. But for companies operating as distributors - managing ",[807,4752,4753],{"href":77},"multiple labels, complex territory restrictions",", and custom royalty splits - the generic UI and rigid workflows of consumer-facing tools quickly become a bottleneck.",[2710,4756],{},[746,4758,4760],{"id":4759},"why-distributors-outgrow-off-the-shelf-platforms","Why Distributors Outgrow Off-the-Shelf Platforms",[751,4762,4763],{},"The friction points are predictable:",[982,4765,4766,4776],{},[985,4767,4768],{},[988,4769,4770,4773],{},[991,4771,4772],{},"Pain Point",[991,4774,4775],{},"What Happens",[1004,4777,4778,4788,4798,4808],{},[988,4779,4780,4785],{},[1009,4781,4782],{},[842,4783,4784],{},"Territory restrictions",[1009,4786,4787],{},"Many platforms only support album-level territory settings, forcing workarounds when individual tracks have different rights across markets",[988,4789,4790,4795],{},[1009,4791,4792],{},[842,4793,4794],{},"Metadata flexibility",[1009,4796,4797],{},"Contributor roles, localized titles, and DSP-specific artist IDs often require manual overrides the UI doesn't expose",[988,4799,4800,4805],{},[1009,4801,4802],{},[842,4803,4804],{},"Reporting",[1009,4806,4807],{},"Off-the-shelf dashboards rarely match the operational needs of a multi-label distributor",[988,4809,4810,4815],{},[1009,4811,4812],{},[842,4813,4814],{},"Delivery control",[1009,4816,4817],{},"When a platform handles delivery as a black box, debugging ingestion failures becomes a support ticket game",[751,4819,4820],{},"This is where the build-vs-buy decision becomes real.",[2710,4822],{},[746,4824,4826],{"id":4825},"the-two-paths-frontend-only-vs-full-stack","The Two Paths: Frontend-Only vs. Full Stack",[751,4828,4829],{},"Distributors who've outgrown their current setup face a fundamental architectural choice:",[1800,4831,4832],{},[751,4833,4834,4837],{},[842,4835,4836],{},"Option A: Custom Frontend + Revelator API as Backend","\nBuild your own user-facing layer - UX, workflows, internal tools, reporting - and use Revelator's API purely for catalog management, delivery to DSPs, and royalty ingestion.",[794,4839,4840],{},[751,4841,4842,4845],{},[842,4843,4844],{},"Option B: Full-Stack Distribution Platform","\nReplace the platform entirely. Build metadata management, DDEX (Digital Data Exchange) generation, delivery pipelines, DSP integrations, royalty ingestion, reporting, and payouts from scratch.",[751,4847,4848,4849,4852],{},"This article focuses on ",[842,4850,4851],{},"Option A",": what it looks like in practice, where it excels, and where it hits structural limits.",[2710,4854],{},[746,4856,4858],{"id":4857},"what-the-revelator-api-actually-offers","What the Revelator API Actually Offers",[751,4860,4861],{},"Revelator positions itself as an \"end-to-end operating system\" for independent music businesses. Unlike consumer-facing distributors, it's B2B infrastructure - designed for labels, aggregators, and distributors who want to run their own branded operation.",[751,4863,4864],{},"The API is RESTful, JSON-based, and covers five core modules:",[1065,4866,4868],{"id":4867},"catalog-management","Catalog Management",[1159,4870,4871,4877,4880,4883],{},[1162,4872,4873,4874],{},"Create and edit releases via ",[963,4875,4876],{},"POST /content/release/save",[1162,4878,4879],{},"Upload audio (WAV/FLAC, minimum 16-bit, 44.1 kHz stereo) and cover art (minimum 1400x1400px JPG/RGB)",[1162,4881,4882],{},"Manage ISRCs (International Standard Recording Codes), UPCs (Universal Product Codes), and external DSP artist IDs",[1162,4884,4885],{},"Support for multi-disc releases and localized metadata",[1065,4887,4744],{"id":4888},"distribution",[1159,4890,4891,4897,4900,4906,4909,4915],{},[1162,4892,4893,4894],{},"Pre-delivery validation: ",[963,4895,4896],{},"POST /distribution/release/{releaseId}/validate",[1162,4898,4899],{},"Set DSP targets, release dates, and territories per release",[1162,4901,4902,4903],{},"Queue releases for delivery: ",[963,4904,4905],{},"POST /distribution/release/addtoqueue",[1162,4907,4908],{},"Track delivery status (statuses range from -20 to 100; 50+ means delivered)",[1162,4910,4911,4912],{},"Takedown support: ",[963,4913,4914],{},"POST /distribution/release/takedown",[1162,4916,4917],{},"Webhook callbacks for delivery status updates",[1065,4919,4921],{"id":4920},"rights-and-royalties","Rights and Royalties",[1159,4923,4924,4927,4930],{},[1162,4925,4926],{},"Contract definition with configurable splits and recoupables",[1162,4928,4929],{},"DSP statement import and reconciliation",[1162,4931,4932],{},"Multi-currency payout automation via Tipalti and PayPal",[1065,4934,4936],{"id":4935},"analytics","Analytics",[1159,4938,4939,4942,4945],{},[1162,4940,4941],{},"Streaming and revenue data queryable by track, release, region, or DSP",[1162,4943,4944],{},"Playlist performance tracking",[1162,4946,4947],{},"CSV export and raw data sync",[1065,4949,4951],{"id":4950},"account-management","Account Management",[1159,4953,4954,4957,4960],{},[1162,4955,4956],{},"Parent-child account hierarchy (your enterprise is the parent; each label or artist is a child)",[1162,4958,4959],{},"Full visibility into child account assets",[1162,4961,4962],{},"Mandatory approval step before content reaches DSPs",[872,4964,4965],{},[751,4966,4967,4968,4971],{},"Revelator claims ",[842,4969,4970],{},"100+ DSP integrations",", including Spotify, Apple Music, Amazon, YouTube Music, YouTube Content ID, TikTok, and Deezer. DSP access is configurable per child account.",[2710,4973],{},[746,4975,4977],{"id":4976},"architecture-of-the-hybrid-solution","Architecture of the Hybrid Solution",[751,4979,4980],{},"The hybrid approach layers your custom platform on top of Revelator's delivery infrastructure:",[1189,4982,4986],{"className":4983,"code":4984,"language":4985,"meta":902,"style":902},"language-mermaid shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","graph TD\n    subgraph Frontend[Your Custom Frontend]\n        AP[Artist Portal]\n        LD[Label Dashboard]\n        AT[Admin Tools]\n        AP & LD & AT --> BE[Your API / Backend]\n    end\n    subgraph Revelator[Revelator API Layer]\n        CAT[Catalog Mgmt API]\n        DEL[Delivery API]\n        ROY[Royalty Ingestion]\n    end\n    BE --> CAT & DEL & ROY\n    subgraph DSPs[Digital Service Providers]\n        SP[Spotify]\n        AM[Apple Music]\n        YT[YouTube]\n        MORE[100+ more]\n    end\n    DEL --> SP & AM & YT & MORE\n    style Frontend fill:#0f172a,stroke:#38bdf8,color:#f8fafc\n    style Revelator fill:#1e293b,stroke:#0ea5e9,color:#f8fafc\n    style DSPs fill:#0f172a,stroke:#334155,color:#f8fafc\n","mermaid",[963,4987,4988,4993,4998,5003,5008,5013,5018,5023,5028,5033,5038,5043,5047,5052,5057,5062,5067,5072,5077,5081,5086,5091,5096],{"__ignoreMap":902},[1197,4989,4990],{"class":1199,"line":1200},[1197,4991,4992],{"class":1536},"graph TD\n",[1197,4994,4995],{"class":1199,"line":903},[1197,4996,4997],{"class":1536},"    subgraph Frontend[Your Custom Frontend]\n",[1197,4999,5000],{"class":1199,"line":1225},[1197,5001,5002],{"class":1536},"        AP[Artist Portal]\n",[1197,5004,5005],{"class":1199,"line":1269},[1197,5006,5007],{"class":1536},"        LD[Label Dashboard]\n",[1197,5009,5010],{"class":1199,"line":1304},[1197,5011,5012],{"class":1536},"        AT[Admin Tools]\n",[1197,5014,5015],{"class":1199,"line":1339},[1197,5016,5017],{"class":1536},"        AP & LD & AT --> BE[Your API / Backend]\n",[1197,5019,5020],{"class":1199,"line":1374},[1197,5021,5022],{"class":1536},"    end\n",[1197,5024,5025],{"class":1199,"line":1410},[1197,5026,5027],{"class":1536},"    subgraph Revelator[Revelator API Layer]\n",[1197,5029,5030],{"class":1199,"line":1416},[1197,5031,5032],{"class":1536},"        CAT[Catalog Mgmt API]\n",[1197,5034,5035],{"class":1199,"line":1766},[1197,5036,5037],{"class":1536},"        DEL[Delivery API]\n",[1197,5039,5040],{"class":1199,"line":2063},[1197,5041,5042],{"class":1536},"        ROY[Royalty Ingestion]\n",[1197,5044,5045],{"class":1199,"line":2109},[1197,5046,5022],{"class":1536},[1197,5048,5049],{"class":1199,"line":2152},[1197,5050,5051],{"class":1536},"    BE --> CAT & DEL & ROY\n",[1197,5053,5054],{"class":1199,"line":2158},[1197,5055,5056],{"class":1536},"    subgraph DSPs[Digital Service Providers]\n",[1197,5058,5059],{"class":1199,"line":2171},[1197,5060,5061],{"class":1536},"        SP[Spotify]\n",[1197,5063,5064],{"class":1199,"line":2237},[1197,5065,5066],{"class":1536},"        AM[Apple Music]\n",[1197,5068,5069],{"class":1199,"line":2300},[1197,5070,5071],{"class":1536},"        YT[YouTube]\n",[1197,5073,5074],{"class":1199,"line":2305},[1197,5075,5076],{"class":1536},"        MORE[100+ more]\n",[1197,5078,5079],{"class":1199,"line":3484},[1197,5080,5022],{"class":1536},[1197,5082,5083],{"class":1199,"line":3490},[1197,5084,5085],{"class":1536},"    DEL --> SP & AM & YT & MORE\n",[1197,5087,5088],{"class":1199,"line":3498},[1197,5089,5090],{"class":1536},"    style Frontend fill:#0f172a,stroke:#38bdf8,color:#f8fafc\n",[1197,5092,5093],{"class":1199,"line":3511},[1197,5094,5095],{"class":1536},"    style Revelator fill:#1e293b,stroke:#0ea5e9,color:#f8fafc\n",[1197,5097,5098],{"class":1199,"line":3517},[1197,5099,5100],{"class":1536},"    style DSPs fill:#0f172a,stroke:#334155,color:#f8fafc\n",[1065,5102,5104],{"id":5103},"what-you-build","What You Build",[982,5106,5107,5116],{},[985,5108,5109],{},[988,5110,5111,5113],{},[991,5112,3016],{},[991,5114,5115],{},"Responsibility",[1004,5117,5118,5128,5138,5148,5158],{},[988,5119,5120,5125],{},[1009,5121,5122],{},[842,5123,5124],{},"Artist & label portals",[1009,5126,5127],{},"Branded onboarding, release submission, approval workflows",[988,5129,5130,5135],{},[1009,5131,5132],{},[842,5133,5134],{},"Metadata layer",[1009,5136,5137],{},"Your own database of releases, tracks, contributors, and rights - synced to Revelator via API",[988,5139,5140,5145],{},[1009,5141,5142],{},[842,5143,5144],{},"Territory & rights engine",[1009,5146,5147],{},"Business logic for track-level territory restrictions, split sheets, and embargo rules",[988,5149,5150,5155],{},[1009,5151,5152],{},[842,5153,5154],{},"Reporting dashboards",[1009,5156,5157],{},"Custom views pulling from Revelator's analytics API plus your own data",[988,5159,5160,5165],{},[1009,5161,5162],{},[842,5163,5164],{},"Internal tools",[1009,5166,5167],{},"Approval queues, QC checklists, bulk operations, CRM integration",[1065,5169,5171],{"id":5170},"what-revelator-handles","What Revelator Handles",[982,5173,5174,5182],{},[985,5175,5176],{},[988,5177,5178,5180],{},[991,5179,3016],{},[991,5181,5115],{},[1004,5183,5184,5194,5204,5214],{},[988,5185,5186,5191],{},[1009,5187,5188],{},[842,5189,5190],{},"DDEX generation",[1009,5192,5193],{},"Generates ERN (Electronic Release Notification) XML packages from catalog data you push via API",[988,5195,5196,5201],{},[1009,5197,5198],{},[842,5199,5200],{},"DSP delivery",[1009,5202,5203],{},"SFTP/API delivery to all connected DSPs, including retry logic and status tracking",[988,5205,5206,5211],{},[1009,5207,5208],{},[842,5209,5210],{},"Royalty ingestion",[1009,5212,5213],{},"Parsing DSP statements and normalizing revenue data",[988,5215,5216,5221],{},[1009,5217,5218],{},[842,5219,5220],{},"Payout infrastructure",[1009,5222,5223],{},"Payment rail integrations for artist payouts",[1065,5225,5227],{"id":5226},"quick-example-creating-a-release-via-revelator-api","Quick Example: Creating a Release via Revelator API",[751,5229,5230],{},"Here's a minimal example of how your backend would create and distribute a release through Revelator's API:",[1189,5232,5234],{"className":1527,"code":5233,"language":1529,"meta":902,"style":902},"import httpx\n\nREVELATOR_API = \"https://api.revelator.com\"\n\n# 1. Authenticate\nauth = httpx.post(f\"{REVELATOR_API}/partner/account/login\", json={\n    \"email\": \"your@email.com\",\n    \"password\": \"your-password\"\n})\ntoken = auth.json()[\"token\"]\nheaders = {\"Authorization\": f\"Bearer {token}\"}\n\n# 2. Create a release\nrelease = httpx.post(f\"{REVELATOR_API}/content/release/save\", headers=headers, json={\n    \"title\": \"Delilah - Summer Version\",\n    \"releaseType\": \"Single\",\n    \"artists\": [\n        {\"name\": \"MIKOLAS\", \"role\": \"MainArtist\"},\n        {\"name\": \"Mark Neve\", \"role\": \"MainArtist\"}\n    ],\n    \"genre\": \"Pop\",\n    \"releaseDate\": \"2026-04-01\",\n    \"territories\": {\n        \"include\": \"Worldwide\",\n        \"exclude\": [\"JP\", \"DE\", \"AT\", \"CH\", \"NL\", \"AU\", \"NZ\"]\n    }\n})\nrelease_id = release.json()[\"id\"]\n\n# 3. Validate before delivery\nvalidation = httpx.post(\n    f\"{REVELATOR_API}/distribution/release/{release_id}/validate\",\n    headers=headers\n)\n\n# 4. Queue for delivery to DSPs\nif validation.json()[\"valid\"]:\n    httpx.post(f\"{REVELATOR_API}/distribution/release/addtoqueue\",\n        headers=headers,\n        json={\"releaseId\": release_id}\n    )\n",[963,5235,5236,5243,5247,5261,5265,5270,5311,5331,5349,5354,5380,5413,5417,5422,5466,5485,5505,5518,5559,5596,5601,5621,5641,5654,5675,5751,5756,5760,5785,5790,5796,5812,5841,5851,5856,5861,5867,5891,5918,5930,5953],{"__ignoreMap":902},[1197,5237,5238,5240],{"class":1199,"line":1200},[1197,5239,3124],{"class":1623},[1197,5241,5242],{"class":1536}," httpx\n",[1197,5244,5245],{"class":1199,"line":903},[1197,5246,1579],{"emptyLinePlaceholder":918},[1197,5248,5249,5252,5254,5256,5259],{"class":1199,"line":1225},[1197,5250,5251],{"class":1536},"REVELATOR_API ",[1197,5253,1540],{"class":1203},[1197,5255,1231],{"class":1203},[1197,5257,5258],{"class":1244},"https://api.revelator.com",[1197,5260,4405],{"class":1203},[1197,5262,5263],{"class":1199,"line":1269},[1197,5264,1579],{"emptyLinePlaceholder":918},[1197,5266,5267],{"class":1199,"line":1304},[1197,5268,5269],{"class":1762},"# 1. Authenticate\n",[1197,5271,5272,5275,5277,5280,5282,5285,5287,5290,5292,5295,5298,5300,5303,5305,5308],{"class":1199,"line":1339},[1197,5273,5274],{"class":1536},"auth ",[1197,5276,1540],{"class":1203},[1197,5278,5279],{"class":1536}," httpx",[1197,5281,1675],{"class":1203},[1197,5283,5284],{"class":1587},"post",[1197,5286,1591],{"class":1203},[1197,5288,5289],{"class":1212},"f",[1197,5291,1216],{"class":1244},[1197,5293,5294],{"class":1262},"{",[1197,5296,5297],{"class":1587},"REVELATOR_API",[1197,5299,3256],{"class":1262},[1197,5301,5302],{"class":1244},"/partner/account/login\"",[1197,5304,1250],{"class":1203},[1197,5306,5307],{"class":1594}," json",[1197,5309,5310],{"class":1203},"={\n",[1197,5312,5313,5315,5318,5320,5322,5324,5327,5329],{"class":1199,"line":1374},[1197,5314,4282],{"class":1203},[1197,5316,5317],{"class":1244},"email",[1197,5319,1216],{"class":1203},[1197,5321,1219],{"class":1203},[1197,5323,1231],{"class":1203},[1197,5325,5326],{"class":1244},"your@email.com",[1197,5328,1216],{"class":1203},[1197,5330,1915],{"class":1203},[1197,5332,5333,5335,5338,5340,5342,5344,5347],{"class":1199,"line":1410},[1197,5334,4282],{"class":1203},[1197,5336,5337],{"class":1244},"password",[1197,5339,1216],{"class":1203},[1197,5341,1219],{"class":1203},[1197,5343,1231],{"class":1203},[1197,5345,5346],{"class":1244},"your-password",[1197,5348,4405],{"class":1203},[1197,5350,5351],{"class":1199,"line":1416},[1197,5352,5353],{"class":1203},"})\n",[1197,5355,5356,5359,5361,5364,5366,5368,5371,5373,5376,5378],{"class":1199,"line":1766},[1197,5357,5358],{"class":1536},"token ",[1197,5360,1540],{"class":1203},[1197,5362,5363],{"class":1536}," auth",[1197,5365,1675],{"class":1203},[1197,5367,1193],{"class":1587},[1197,5369,5370],{"class":1203},"()[",[1197,5372,1216],{"class":1203},[1197,5374,5375],{"class":1244},"token",[1197,5377,1216],{"class":1203},[1197,5379,1574],{"class":1203},[1197,5381,5382,5385,5387,5389,5391,5393,5395,5397,5400,5403,5405,5407,5409,5411],{"class":1199,"line":2063},[1197,5383,5384],{"class":1536},"headers ",[1197,5386,1540],{"class":1203},[1197,5388,3127],{"class":1203},[1197,5390,1216],{"class":1203},[1197,5392,3728],{"class":1244},[1197,5394,1216],{"class":1203},[1197,5396,1219],{"class":1203},[1197,5398,5399],{"class":1212}," f",[1197,5401,5402],{"class":1244},"\"Bearer ",[1197,5404,5294],{"class":1262},[1197,5406,5375],{"class":1536},[1197,5408,3256],{"class":1262},[1197,5410,1216],{"class":1244},[1197,5412,1419],{"class":1203},[1197,5414,5415],{"class":1199,"line":2109},[1197,5416,1579],{"emptyLinePlaceholder":918},[1197,5418,5419],{"class":1199,"line":2152},[1197,5420,5421],{"class":1762},"# 2. Create a release\n",[1197,5423,5424,5427,5429,5431,5433,5435,5437,5439,5441,5443,5445,5447,5450,5452,5455,5457,5460,5462,5464],{"class":1199,"line":2158},[1197,5425,5426],{"class":1536},"release ",[1197,5428,1540],{"class":1203},[1197,5430,5279],{"class":1536},[1197,5432,1675],{"class":1203},[1197,5434,5284],{"class":1587},[1197,5436,1591],{"class":1203},[1197,5438,5289],{"class":1212},[1197,5440,1216],{"class":1244},[1197,5442,5294],{"class":1262},[1197,5444,5297],{"class":1587},[1197,5446,3256],{"class":1262},[1197,5448,5449],{"class":1244},"/content/release/save\"",[1197,5451,1250],{"class":1203},[1197,5453,5454],{"class":1594}," headers",[1197,5456,1540],{"class":1203},[1197,5458,5459],{"class":1587},"headers",[1197,5461,1250],{"class":1203},[1197,5463,5307],{"class":1594},[1197,5465,5310],{"class":1203},[1197,5467,5468,5470,5472,5474,5476,5478,5481,5483],{"class":1199,"line":2171},[1197,5469,4282],{"class":1203},[1197,5471,3852],{"class":1244},[1197,5473,1216],{"class":1203},[1197,5475,1219],{"class":1203},[1197,5477,1231],{"class":1203},[1197,5479,5480],{"class":1244},"Delilah - Summer Version",[1197,5482,1216],{"class":1203},[1197,5484,1915],{"class":1203},[1197,5486,5487,5489,5492,5494,5496,5498,5501,5503],{"class":1199,"line":2237},[1197,5488,4282],{"class":1203},[1197,5490,5491],{"class":1244},"releaseType",[1197,5493,1216],{"class":1203},[1197,5495,1219],{"class":1203},[1197,5497,1231],{"class":1203},[1197,5499,5500],{"class":1244},"Single",[1197,5502,1216],{"class":1203},[1197,5504,1915],{"class":1203},[1197,5506,5507,5509,5512,5514,5516],{"class":1199,"line":2300},[1197,5508,4282],{"class":1203},[1197,5510,5511],{"class":1244},"artists",[1197,5513,1216],{"class":1203},[1197,5515,1219],{"class":1203},[1197,5517,1222],{"class":1203},[1197,5519,5520,5523,5525,5527,5529,5531,5533,5536,5538,5540,5542,5545,5547,5549,5551,5554,5556],{"class":1199,"line":2305},[1197,5521,5522],{"class":1203},"        {",[1197,5524,1216],{"class":1203},[1197,5526,1235],{"class":1244},[1197,5528,1216],{"class":1203},[1197,5530,1219],{"class":1203},[1197,5532,1231],{"class":1203},[1197,5534,5535],{"class":1244},"MIKOLAS",[1197,5537,1216],{"class":1203},[1197,5539,1250],{"class":1203},[1197,5541,1231],{"class":1203},[1197,5543,5544],{"class":1244},"role",[1197,5546,1216],{"class":1203},[1197,5548,1219],{"class":1203},[1197,5550,1231],{"class":1203},[1197,5552,5553],{"class":1244},"MainArtist",[1197,5555,1216],{"class":1203},[1197,5557,5558],{"class":1203},"},\n",[1197,5560,5561,5563,5565,5567,5569,5571,5573,5576,5578,5580,5582,5584,5586,5588,5590,5592,5594],{"class":1199,"line":3484},[1197,5562,5522],{"class":1203},[1197,5564,1216],{"class":1203},[1197,5566,1235],{"class":1244},[1197,5568,1216],{"class":1203},[1197,5570,1219],{"class":1203},[1197,5572,1231],{"class":1203},[1197,5574,5575],{"class":1244},"Mark Neve",[1197,5577,1216],{"class":1203},[1197,5579,1250],{"class":1203},[1197,5581,1231],{"class":1203},[1197,5583,5544],{"class":1244},[1197,5585,1216],{"class":1203},[1197,5587,1219],{"class":1203},[1197,5589,1231],{"class":1203},[1197,5591,5553],{"class":1244},[1197,5593,1216],{"class":1203},[1197,5595,1419],{"class":1203},[1197,5597,5598],{"class":1199,"line":3490},[1197,5599,5600],{"class":1203},"    ],\n",[1197,5602,5603,5605,5608,5610,5612,5614,5617,5619],{"class":1199,"line":3498},[1197,5604,4282],{"class":1203},[1197,5606,5607],{"class":1244},"genre",[1197,5609,1216],{"class":1203},[1197,5611,1219],{"class":1203},[1197,5613,1231],{"class":1203},[1197,5615,5616],{"class":1244},"Pop",[1197,5618,1216],{"class":1203},[1197,5620,1915],{"class":1203},[1197,5622,5623,5625,5628,5630,5632,5634,5637,5639],{"class":1199,"line":3511},[1197,5624,4282],{"class":1203},[1197,5626,5627],{"class":1244},"releaseDate",[1197,5629,1216],{"class":1203},[1197,5631,1219],{"class":1203},[1197,5633,1231],{"class":1203},[1197,5635,5636],{"class":1244},"2026-04-01",[1197,5638,1216],{"class":1203},[1197,5640,1915],{"class":1203},[1197,5642,5643,5645,5648,5650,5652],{"class":1199,"line":3517},[1197,5644,4282],{"class":1203},[1197,5646,5647],{"class":1244},"territories",[1197,5649,1216],{"class":1203},[1197,5651,1219],{"class":1203},[1197,5653,3209],{"class":1203},[1197,5655,5656,5659,5662,5664,5666,5668,5671,5673],{"class":1199,"line":3549},[1197,5657,5658],{"class":1203},"        \"",[1197,5660,5661],{"class":1244},"include",[1197,5663,1216],{"class":1203},[1197,5665,1219],{"class":1203},[1197,5667,1231],{"class":1203},[1197,5669,5670],{"class":1244},"Worldwide",[1197,5672,1216],{"class":1203},[1197,5674,1915],{"class":1203},[1197,5676,5677,5679,5682,5684,5686,5688,5690,5693,5695,5697,5699,5702,5704,5706,5708,5711,5713,5715,5717,5720,5722,5724,5726,5729,5731,5733,5735,5738,5740,5742,5744,5747,5749],{"class":1199,"line":3562},[1197,5678,5658],{"class":1203},[1197,5680,5681],{"class":1244},"exclude",[1197,5683,1216],{"class":1203},[1197,5685,1219],{"class":1203},[1197,5687,1543],{"class":1203},[1197,5689,1216],{"class":1203},[1197,5691,5692],{"class":1244},"JP",[1197,5694,1216],{"class":1203},[1197,5696,1250],{"class":1203},[1197,5698,1231],{"class":1203},[1197,5700,5701],{"class":1244},"DE",[1197,5703,1216],{"class":1203},[1197,5705,1250],{"class":1203},[1197,5707,1231],{"class":1203},[1197,5709,5710],{"class":1244},"AT",[1197,5712,1216],{"class":1203},[1197,5714,1250],{"class":1203},[1197,5716,1231],{"class":1203},[1197,5718,5719],{"class":1244},"CH",[1197,5721,1216],{"class":1203},[1197,5723,1250],{"class":1203},[1197,5725,1231],{"class":1203},[1197,5727,5728],{"class":1244},"NL",[1197,5730,1216],{"class":1203},[1197,5732,1250],{"class":1203},[1197,5734,1231],{"class":1203},[1197,5736,5737],{"class":1244},"AU",[1197,5739,1216],{"class":1203},[1197,5741,1250],{"class":1203},[1197,5743,1231],{"class":1203},[1197,5745,5746],{"class":1244},"NZ",[1197,5748,1216],{"class":1203},[1197,5750,1574],{"class":1203},[1197,5752,5753],{"class":1199,"line":3568},[1197,5754,5755],{"class":1203},"    }\n",[1197,5757,5758],{"class":1199,"line":3574},[1197,5759,5353],{"class":1203},[1197,5761,5762,5765,5767,5770,5772,5774,5776,5778,5781,5783],{"class":1199,"line":3581},[1197,5763,5764],{"class":1536},"release_id ",[1197,5766,1540],{"class":1203},[1197,5768,5769],{"class":1536}," release",[1197,5771,1675],{"class":1203},[1197,5773,1193],{"class":1587},[1197,5775,5370],{"class":1203},[1197,5777,1216],{"class":1203},[1197,5779,5780],{"class":1244},"id",[1197,5782,1216],{"class":1203},[1197,5784,1574],{"class":1203},[1197,5786,5788],{"class":1199,"line":5787},29,[1197,5789,1579],{"emptyLinePlaceholder":918},[1197,5791,5793],{"class":1199,"line":5792},30,[1197,5794,5795],{"class":1762},"# 3. Validate before delivery\n",[1197,5797,5799,5802,5804,5806,5808,5810],{"class":1199,"line":5798},31,[1197,5800,5801],{"class":1536},"validation ",[1197,5803,1540],{"class":1203},[1197,5805,5279],{"class":1536},[1197,5807,1675],{"class":1203},[1197,5809,5284],{"class":1587},[1197,5811,3444],{"class":1203},[1197,5813,5815,5818,5820,5822,5824,5826,5829,5831,5834,5836,5839],{"class":1199,"line":5814},32,[1197,5816,5817],{"class":1212},"    f",[1197,5819,1216],{"class":1244},[1197,5821,5294],{"class":1262},[1197,5823,5297],{"class":1587},[1197,5825,3256],{"class":1262},[1197,5827,5828],{"class":1244},"/distribution/release/",[1197,5830,5294],{"class":1262},[1197,5832,5833],{"class":1587},"release_id",[1197,5835,3256],{"class":1262},[1197,5837,5838],{"class":1244},"/validate\"",[1197,5840,1915],{"class":1203},[1197,5842,5844,5846,5848],{"class":1199,"line":5843},33,[1197,5845,3716],{"class":1594},[1197,5847,1540],{"class":1203},[1197,5849,5850],{"class":1587},"headers\n",[1197,5852,5854],{"class":1199,"line":5853},34,[1197,5855,1757],{"class":1203},[1197,5857,5859],{"class":1199,"line":5858},35,[1197,5860,1579],{"emptyLinePlaceholder":918},[1197,5862,5864],{"class":1199,"line":5863},36,[1197,5865,5866],{"class":1762},"# 4. Queue for delivery to DSPs\n",[1197,5868,5870,5873,5876,5878,5880,5882,5884,5887,5889],{"class":1199,"line":5869},37,[1197,5871,5872],{"class":1623},"if",[1197,5874,5875],{"class":1536}," validation",[1197,5877,1675],{"class":1203},[1197,5879,1193],{"class":1587},[1197,5881,5370],{"class":1203},[1197,5883,1216],{"class":1203},[1197,5885,5886],{"class":1244},"valid",[1197,5888,1216],{"class":1203},[1197,5890,1618],{"class":1203},[1197,5892,5894,5897,5899,5901,5903,5905,5907,5909,5911,5913,5916],{"class":1199,"line":5893},38,[1197,5895,5896],{"class":1536},"    httpx",[1197,5898,1675],{"class":1203},[1197,5900,5284],{"class":1587},[1197,5902,1591],{"class":1203},[1197,5904,5289],{"class":1212},[1197,5906,1216],{"class":1244},[1197,5908,5294],{"class":1262},[1197,5910,5297],{"class":1587},[1197,5912,3256],{"class":1262},[1197,5914,5915],{"class":1244},"/distribution/release/addtoqueue\"",[1197,5917,1915],{"class":1203},[1197,5919,5921,5924,5926,5928],{"class":1199,"line":5920},39,[1197,5922,5923],{"class":1594},"        headers",[1197,5925,1540],{"class":1203},[1197,5927,5459],{"class":1587},[1197,5929,1915],{"class":1203},[1197,5931,5933,5936,5939,5941,5944,5946,5948,5951],{"class":1199,"line":5932},40,[1197,5934,5935],{"class":1594},"        json",[1197,5937,5938],{"class":1203},"={",[1197,5940,1216],{"class":1203},[1197,5942,5943],{"class":1244},"releaseId",[1197,5945,1216],{"class":1203},[1197,5947,1219],{"class":1203},[1197,5949,5950],{"class":1587}," release_id",[1197,5952,1419],{"class":1203},[1197,5954,5956],{"class":1199,"line":5955},41,[1197,5957,3571],{"class":1203},[1800,5959,5960],{},[751,5961,5962,5963,5966,5967,5970],{},"This is a simplified example. In production, you'd also upload audio files via ",[963,5964,5965],{},"/media/audio/upload",", cover art via ",[963,5968,5969],{},"/media/image/upload",", and handle webhook callbacks for delivery status updates.",[2710,5972],{},[746,5974,5976],{"id":5975},"ddex-as-the-backbone","DDEX as the Backbone",[751,5978,5979],{},"Under the hood, every delivery to a DSP is a DDEX ERN message - an XML package describing the release, its resources (audio, artwork), and the commercial terms (deals) under which DSPs can exploit the content.",[751,5981,5982],{},"An ERN message has three critical sections:",[1065,5984,5986],{"id":5985},"resourcelist","ResourceList",[751,5988,5989],{},"Defines the audio files, cover art, and their metadata. Each sound recording includes an ISRC, title, artist credits, and territory-specific details:",[1189,5991,5995],{"className":5992,"code":5993,"language":5994,"meta":902,"style":902},"language-xml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u003CSoundRecording>\n  \u003CSoundRecordingId>\n    \u003CISRC>SKXXX2500001\u003C/ISRC>\n  \u003C/SoundRecordingId>\n  \u003CResourceReference>A1\u003C/ResourceReference>\n  \u003CSoundRecordingDetailsByTerritory>\n    \u003CTerritoryCode>Worldwide\u003C/TerritoryCode>\n    \u003CTitle TitleType=\"FormalTitle\">\n      \u003CTitleText>Delilah\u003C/TitleText>\n    \u003C/Title>\n    \u003CDisplayArtist>\n      \u003CPartyName>\u003CFullName>MIKOLAS\u003C/FullName>\u003C/PartyName>\n      \u003CArtistRole>MainArtist\u003C/ArtistRole>\n    \u003C/DisplayArtist>\n  \u003C/SoundRecordingDetailsByTerritory>\n\u003C/SoundRecording>\n","xml",[963,5996,5997,6006,6016,6035,6044,6062,6071,6088,6109,6128,6137,6146,6174,6191,6199,6207],{"__ignoreMap":902},[1197,5998,5999,6001,6004],{"class":1199,"line":1200},[1197,6000,3200],{"class":1203},[1197,6002,6003],{"class":3225},"SoundRecording",[1197,6005,4213],{"class":1203},[1197,6007,6008,6011,6014],{"class":1199,"line":903},[1197,6009,6010],{"class":1203},"  \u003C",[1197,6012,6013],{"class":3225},"SoundRecordingId",[1197,6015,4213],{"class":1203},[1197,6017,6018,6021,6024,6026,6029,6031,6033],{"class":1199,"line":1225},[1197,6019,6020],{"class":1203},"    \u003C",[1197,6022,6023],{"class":3225},"ISRC",[1197,6025,3206],{"class":1203},[1197,6027,6028],{"class":1536},"SKXXX2500001",[1197,6030,4238],{"class":1203},[1197,6032,6023],{"class":3225},[1197,6034,4213],{"class":1203},[1197,6036,6037,6040,6042],{"class":1199,"line":1269},[1197,6038,6039],{"class":1203},"  \u003C/",[1197,6041,6013],{"class":3225},[1197,6043,4213],{"class":1203},[1197,6045,6046,6048,6051,6053,6056,6058,6060],{"class":1199,"line":1304},[1197,6047,6010],{"class":1203},[1197,6049,6050],{"class":3225},"ResourceReference",[1197,6052,3206],{"class":1203},[1197,6054,6055],{"class":1536},"A1",[1197,6057,4238],{"class":1203},[1197,6059,6050],{"class":3225},[1197,6061,4213],{"class":1203},[1197,6063,6064,6066,6069],{"class":1199,"line":1339},[1197,6065,6010],{"class":1203},[1197,6067,6068],{"class":3225},"SoundRecordingDetailsByTerritory",[1197,6070,4213],{"class":1203},[1197,6072,6073,6075,6078,6080,6082,6084,6086],{"class":1199,"line":1374},[1197,6074,6020],{"class":1203},[1197,6076,6077],{"class":3225},"TerritoryCode",[1197,6079,3206],{"class":1203},[1197,6081,5670],{"class":1536},[1197,6083,4238],{"class":1203},[1197,6085,6077],{"class":3225},[1197,6087,4213],{"class":1203},[1197,6089,6090,6092,6095,6098,6100,6102,6105,6107],{"class":1199,"line":1410},[1197,6091,6020],{"class":1203},[1197,6093,6094],{"class":3225},"Title",[1197,6096,6097],{"class":1212}," TitleType",[1197,6099,1540],{"class":1203},[1197,6101,1216],{"class":1203},[1197,6103,6104],{"class":1244},"FormalTitle",[1197,6106,1216],{"class":1203},[1197,6108,4213],{"class":1203},[1197,6110,6111,6114,6117,6119,6122,6124,6126],{"class":1199,"line":1416},[1197,6112,6113],{"class":1203},"      \u003C",[1197,6115,6116],{"class":3225},"TitleText",[1197,6118,3206],{"class":1203},[1197,6120,6121],{"class":1536},"Delilah",[1197,6123,4238],{"class":1203},[1197,6125,6116],{"class":3225},[1197,6127,4213],{"class":1203},[1197,6129,6130,6133,6135],{"class":1199,"line":1766},[1197,6131,6132],{"class":1203},"    \u003C/",[1197,6134,6094],{"class":3225},[1197,6136,4213],{"class":1203},[1197,6138,6139,6141,6144],{"class":1199,"line":2063},[1197,6140,6020],{"class":1203},[1197,6142,6143],{"class":3225},"DisplayArtist",[1197,6145,4213],{"class":1203},[1197,6147,6148,6150,6153,6156,6159,6161,6163,6165,6167,6170,6172],{"class":1199,"line":2109},[1197,6149,6113],{"class":1203},[1197,6151,6152],{"class":3225},"PartyName",[1197,6154,6155],{"class":1203},">\u003C",[1197,6157,6158],{"class":3225},"FullName",[1197,6160,3206],{"class":1203},[1197,6162,5535],{"class":1536},[1197,6164,4238],{"class":1203},[1197,6166,6158],{"class":3225},[1197,6168,6169],{"class":1203},">\u003C/",[1197,6171,6152],{"class":3225},[1197,6173,4213],{"class":1203},[1197,6175,6176,6178,6181,6183,6185,6187,6189],{"class":1199,"line":2152},[1197,6177,6113],{"class":1203},[1197,6179,6180],{"class":3225},"ArtistRole",[1197,6182,3206],{"class":1203},[1197,6184,5553],{"class":1536},[1197,6186,4238],{"class":1203},[1197,6188,6180],{"class":3225},[1197,6190,4213],{"class":1203},[1197,6192,6193,6195,6197],{"class":1199,"line":2158},[1197,6194,6132],{"class":1203},[1197,6196,6143],{"class":3225},[1197,6198,4213],{"class":1203},[1197,6200,6201,6203,6205],{"class":1199,"line":2171},[1197,6202,6039],{"class":1203},[1197,6204,6068],{"class":3225},[1197,6206,4213],{"class":1203},[1197,6208,6209,6211,6213],{"class":1199,"line":2237},[1197,6210,4238],{"class":1203},[1197,6212,6003],{"class":3225},[1197,6214,4213],{"class":1203},[1065,6216,6218],{"id":6217},"releaselist","ReleaseList",[751,6220,6221],{},"Defines the product - the album or single - and links it to its component resources:",[1189,6223,6225],{"className":5992,"code":6224,"language":5994,"meta":902,"style":902},"\u003CRelease>\n  \u003CReleaseId>\u003CICPN>0123456789012\u003C/ICPN>\u003C/ReleaseId>\n  \u003CReleaseReference>R0\u003C/ReleaseReference>\n  \u003CReleaseType>Album\u003C/ReleaseType>\n  \u003CReleaseDetailsByTerritory>\n    \u003CTerritoryCode>Worldwide\u003C/TerritoryCode>\n    \u003CDisplayArtistName>MIKOLAS\u003C/DisplayArtistName>\n    \u003CTitle TitleType=\"FormalTitle\">\n      \u003CTitleText>ONE\u003C/TitleText>\n    \u003C/Title>\n  \u003C/ReleaseDetailsByTerritory>\n\u003C/Release>\n",[963,6226,6227,6236,6263,6281,6299,6308,6324,6341,6359,6376,6384,6392],{"__ignoreMap":902},[1197,6228,6229,6231,6234],{"class":1199,"line":1200},[1197,6230,3200],{"class":1203},[1197,6232,6233],{"class":3225},"Release",[1197,6235,4213],{"class":1203},[1197,6237,6238,6240,6243,6245,6248,6250,6253,6255,6257,6259,6261],{"class":1199,"line":903},[1197,6239,6010],{"class":1203},[1197,6241,6242],{"class":3225},"ReleaseId",[1197,6244,6155],{"class":1203},[1197,6246,6247],{"class":3225},"ICPN",[1197,6249,3206],{"class":1203},[1197,6251,6252],{"class":1536},"0123456789012",[1197,6254,4238],{"class":1203},[1197,6256,6247],{"class":3225},[1197,6258,6169],{"class":1203},[1197,6260,6242],{"class":3225},[1197,6262,4213],{"class":1203},[1197,6264,6265,6267,6270,6272,6275,6277,6279],{"class":1199,"line":1225},[1197,6266,6010],{"class":1203},[1197,6268,6269],{"class":3225},"ReleaseReference",[1197,6271,3206],{"class":1203},[1197,6273,6274],{"class":1536},"R0",[1197,6276,4238],{"class":1203},[1197,6278,6269],{"class":3225},[1197,6280,4213],{"class":1203},[1197,6282,6283,6285,6288,6290,6293,6295,6297],{"class":1199,"line":1269},[1197,6284,6010],{"class":1203},[1197,6286,6287],{"class":3225},"ReleaseType",[1197,6289,3206],{"class":1203},[1197,6291,6292],{"class":1536},"Album",[1197,6294,4238],{"class":1203},[1197,6296,6287],{"class":3225},[1197,6298,4213],{"class":1203},[1197,6300,6301,6303,6306],{"class":1199,"line":1304},[1197,6302,6010],{"class":1203},[1197,6304,6305],{"class":3225},"ReleaseDetailsByTerritory",[1197,6307,4213],{"class":1203},[1197,6309,6310,6312,6314,6316,6318,6320,6322],{"class":1199,"line":1339},[1197,6311,6020],{"class":1203},[1197,6313,6077],{"class":3225},[1197,6315,3206],{"class":1203},[1197,6317,5670],{"class":1536},[1197,6319,4238],{"class":1203},[1197,6321,6077],{"class":3225},[1197,6323,4213],{"class":1203},[1197,6325,6326,6328,6331,6333,6335,6337,6339],{"class":1199,"line":1374},[1197,6327,6020],{"class":1203},[1197,6329,6330],{"class":3225},"DisplayArtistName",[1197,6332,3206],{"class":1203},[1197,6334,5535],{"class":1536},[1197,6336,4238],{"class":1203},[1197,6338,6330],{"class":3225},[1197,6340,4213],{"class":1203},[1197,6342,6343,6345,6347,6349,6351,6353,6355,6357],{"class":1199,"line":1410},[1197,6344,6020],{"class":1203},[1197,6346,6094],{"class":3225},[1197,6348,6097],{"class":1212},[1197,6350,1540],{"class":1203},[1197,6352,1216],{"class":1203},[1197,6354,6104],{"class":1244},[1197,6356,1216],{"class":1203},[1197,6358,4213],{"class":1203},[1197,6360,6361,6363,6365,6367,6370,6372,6374],{"class":1199,"line":1416},[1197,6362,6113],{"class":1203},[1197,6364,6116],{"class":3225},[1197,6366,3206],{"class":1203},[1197,6368,6369],{"class":1536},"ONE",[1197,6371,4238],{"class":1203},[1197,6373,6116],{"class":3225},[1197,6375,4213],{"class":1203},[1197,6377,6378,6380,6382],{"class":1199,"line":1766},[1197,6379,6132],{"class":1203},[1197,6381,6094],{"class":3225},[1197,6383,4213],{"class":1203},[1197,6385,6386,6388,6390],{"class":1199,"line":2063},[1197,6387,6039],{"class":1203},[1197,6389,6305],{"class":3225},[1197,6391,4213],{"class":1203},[1197,6393,6394,6396,6398],{"class":1199,"line":2109},[1197,6395,4238],{"class":1203},[1197,6397,6233],{"class":3225},[1197,6399,4213],{"class":1203},[1065,6401,6403],{"id":6402},"deallist","DealList",[751,6405,1441,6406,6409],{},[842,6407,6408],{},"only"," section that grants commercial rights. This is where territory restrictions live:",[1189,6411,6413],{"className":5992,"code":6412,"language":5994,"meta":902,"style":902},"\u003CReleaseDeal>\n  \u003CDealReleaseReference>R0\u003C/DealReleaseReference>\n  \u003CDeal>\n    \u003CDealTerms>\n      \u003CTerritoryCode>Worldwide\u003C/TerritoryCode>\n      \u003CExcludedTerritoryCode>JP\u003C/ExcludedTerritoryCode>\n      \u003CCommercialModelType>SubscriptionModel\u003C/CommercialModelType>\n      \u003CUsage>\n        \u003CUseType>OnDemandStream\u003C/UseType>\n      \u003C/Usage>\n      \u003CValidityPeriod>\n        \u003CStartDate>2026-03-15\u003C/StartDate>\n      \u003C/ValidityPeriod>\n    \u003C/DealTerms>\n  \u003C/Deal>\n\u003C/ReleaseDeal>\n",[963,6414,6415,6424,6441,6450,6459,6475,6492,6510,6519,6538,6547,6556,6574,6582,6590,6598],{"__ignoreMap":902},[1197,6416,6417,6419,6422],{"class":1199,"line":1200},[1197,6418,3200],{"class":1203},[1197,6420,6421],{"class":3225},"ReleaseDeal",[1197,6423,4213],{"class":1203},[1197,6425,6426,6428,6431,6433,6435,6437,6439],{"class":1199,"line":903},[1197,6427,6010],{"class":1203},[1197,6429,6430],{"class":3225},"DealReleaseReference",[1197,6432,3206],{"class":1203},[1197,6434,6274],{"class":1536},[1197,6436,4238],{"class":1203},[1197,6438,6430],{"class":3225},[1197,6440,4213],{"class":1203},[1197,6442,6443,6445,6448],{"class":1199,"line":1225},[1197,6444,6010],{"class":1203},[1197,6446,6447],{"class":3225},"Deal",[1197,6449,4213],{"class":1203},[1197,6451,6452,6454,6457],{"class":1199,"line":1269},[1197,6453,6020],{"class":1203},[1197,6455,6456],{"class":3225},"DealTerms",[1197,6458,4213],{"class":1203},[1197,6460,6461,6463,6465,6467,6469,6471,6473],{"class":1199,"line":1304},[1197,6462,6113],{"class":1203},[1197,6464,6077],{"class":3225},[1197,6466,3206],{"class":1203},[1197,6468,5670],{"class":1536},[1197,6470,4238],{"class":1203},[1197,6472,6077],{"class":3225},[1197,6474,4213],{"class":1203},[1197,6476,6477,6479,6482,6484,6486,6488,6490],{"class":1199,"line":1339},[1197,6478,6113],{"class":1203},[1197,6480,6481],{"class":3225},"ExcludedTerritoryCode",[1197,6483,3206],{"class":1203},[1197,6485,5692],{"class":1536},[1197,6487,4238],{"class":1203},[1197,6489,6481],{"class":3225},[1197,6491,4213],{"class":1203},[1197,6493,6494,6496,6499,6501,6504,6506,6508],{"class":1199,"line":1374},[1197,6495,6113],{"class":1203},[1197,6497,6498],{"class":3225},"CommercialModelType",[1197,6500,3206],{"class":1203},[1197,6502,6503],{"class":1536},"SubscriptionModel",[1197,6505,4238],{"class":1203},[1197,6507,6498],{"class":3225},[1197,6509,4213],{"class":1203},[1197,6511,6512,6514,6517],{"class":1199,"line":1410},[1197,6513,6113],{"class":1203},[1197,6515,6516],{"class":3225},"Usage",[1197,6518,4213],{"class":1203},[1197,6520,6521,6524,6527,6529,6532,6534,6536],{"class":1199,"line":1416},[1197,6522,6523],{"class":1203},"        \u003C",[1197,6525,6526],{"class":3225},"UseType",[1197,6528,3206],{"class":1203},[1197,6530,6531],{"class":1536},"OnDemandStream",[1197,6533,4238],{"class":1203},[1197,6535,6526],{"class":3225},[1197,6537,4213],{"class":1203},[1197,6539,6540,6543,6545],{"class":1199,"line":1766},[1197,6541,6542],{"class":1203},"      \u003C/",[1197,6544,6516],{"class":3225},[1197,6546,4213],{"class":1203},[1197,6548,6549,6551,6554],{"class":1199,"line":2063},[1197,6550,6113],{"class":1203},[1197,6552,6553],{"class":3225},"ValidityPeriod",[1197,6555,4213],{"class":1203},[1197,6557,6558,6560,6563,6565,6568,6570,6572],{"class":1199,"line":2109},[1197,6559,6523],{"class":1203},[1197,6561,6562],{"class":3225},"StartDate",[1197,6564,3206],{"class":1203},[1197,6566,6567],{"class":1536},"2026-03-15",[1197,6569,4238],{"class":1203},[1197,6571,6562],{"class":3225},[1197,6573,4213],{"class":1203},[1197,6575,6576,6578,6580],{"class":1199,"line":2152},[1197,6577,6542],{"class":1203},[1197,6579,6553],{"class":3225},[1197,6581,4213],{"class":1203},[1197,6583,6584,6586,6588],{"class":1199,"line":2158},[1197,6585,6132],{"class":1203},[1197,6587,6456],{"class":3225},[1197,6589,4213],{"class":1203},[1197,6591,6592,6594,6596],{"class":1199,"line":2171},[1197,6593,6039],{"class":1203},[1197,6595,6447],{"class":3225},[1197,6597,4213],{"class":1203},[1197,6599,6600,6602,6604],{"class":1199,"line":2237},[1197,6601,4238],{"class":1203},[1197,6603,6421],{"class":3225},[1197,6605,4213],{"class":1203},[794,6607,6608],{},[751,6609,6610,2332,6613,6616,6617,6621,6622,6624,6625,6628],{},[842,6611,6612],{},"Common DDEX mistake:",[963,6614,6615],{},"DetailsByTerritory"," in ResourceList and ReleaseList describes ",[6618,6619,6620],"em",{},"how content is presented"," in different markets. The ",[963,6623,6403],{}," defines ",[6618,6626,6627],{},"where content is available",". Confusing these two - applying territory restrictions in metadata instead of deals - is one of the most frequent implementation errors.",[1065,6630,6632],{"id":6631},"territory-restrictions-in-practice","Territory Restrictions in Practice",[751,6634,6635,6636,1219],{},"When a distributor has agreements with partners who hold rights in specific regions, individual tracks must be excluded from those territories. This requires consistent territory entries across ",[842,6637,6638],{},"three XML sections",[2683,6640,6641,6646,6651],{},[1162,6642,6643,6645],{},[963,6644,6068],{}," in ResourceList",[1162,6647,6648,6650],{},[963,6649,6305],{}," in ReleaseList",[1162,6652,6653,6655],{},[963,6654,6456],{}," in DealList",[751,6657,6658,6659,6662],{},"Platforms like Revelator handle this at the release level through their UI, but ",[842,6660,6661],{},"track-level territory restrictions within an album"," are where the friction begins. This is exactly the kind of limitation that pushes distributors toward a custom frontend - you model the territory logic in your own system and push the correct per-track restrictions through the API.",[2710,6664],{},[746,6666,6668],{"id":6667},"real-world-gotchas","Real-World Gotchas",[751,6670,6671],{},"Having worked with distributors who use Revelator as their delivery backbone, here are the practical challenges we've encountered:",[794,6673,6674],{},[751,6675,6676,6679],{},[842,6677,6678],{},"1. Mandatory Human Approval Step","\nRevelator requires a parent account to approve distributions before they reach DSPs. There is no fully automated end-to-end delivery without a human clicking \"approve\" in the web UI. For high-volume operations, this creates a bottleneck that API-only workflows cannot bypass.",[1065,6681,6683],{"id":6682},"_2-full-object-re-submission","2. Full Object Re-submission",[751,6685,6686],{},"There is no PATCH support for releases. Editing a release requires re-submitting the full release object. If you omit files, they are auto-deleted. This means your backend must always maintain the complete release state.",[1065,6688,6690],{"id":6689},"_3-breaking-api-changes","3. Breaking API Changes",[751,6692,6693],{},"Revelator's API has had several breaking changes in 2025-2026:",[982,6695,6696,6706],{},[985,6697,6698],{},[988,6699,6700,6703],{},[991,6701,6702],{},"Change",[991,6704,6705],{},"When",[1004,6707,6708,6722,6733,6741],{},[988,6709,6710,6719],{},[1009,6711,6712,6713,6716,6717],{},"UPC type changed from ",[963,6714,6715],{},"number"," to ",[963,6718,3203],{},[1009,6720,6721],{},"Feb 2026",[988,6723,6724,6730],{},[1009,6725,6726,6727],{},"API base URL migrated to ",[963,6728,6729],{},"api.revelator.com",[1009,6731,6732],{},"Mar 2026",[988,6734,6735,6738],{},[1009,6736,6737],{},"Production/engineering credits became mandatory",[1009,6739,6740],{},"Jun 2025",[988,6742,6743,6746],{},[1009,6744,6745],{},"Zero-sentinel IDs deprecated",[1009,6747,6748],{},"Nov 2025",[751,6750,6751],{},"Your integration layer needs resilience against schema drift.",[1065,6753,6755],{"id":6754},"_4-dsp-specific-ddex-interpretation","4. DSP-Specific DDEX Interpretation",[751,6757,6758],{},"Even when Revelator generates valid ERN XML, each DSP interprets certain elements differently. Spotify's ingestion engine, Apple's Content Provider system, and Amazon's pipeline each have proprietary extensions and quirks. When delivery fails, debugging requires understanding both the DDEX standard and the specific DSP's interpretation.",[1065,6760,6762],{"id":6761},"_5-locked-distribution-states","5. Locked Distribution States",[751,6764,6765],{},"Tracks in certain distribution statuses (-10, -11, -20, -21) become read-only. If you need to modify metadata on a locked track, you may need to initiate a takedown and redeliver, adding complexity to your workflow engine.",[2710,6767],{},[746,6769,6771],{"id":6770},"when-does-option-a-become-a-dead-end","When Does Option A Become a Dead End?",[751,6773,6774],{},"The hybrid approach works well when:",[1159,6776,6777,6783,6789,6792],{},[1162,6778,6779,6780],{},"Your catalog is under ",[842,6781,6782],{},"50,000 releases",[1162,6784,6785,6786],{},"You have fewer than ",[842,6787,6788],{},"30 DSP targets",[1162,6790,6791],{},"Territory complexity is moderate (album-level restrictions, not per-track-per-DSP)",[1162,6793,6794],{},"Royalty reporting needs are standard (DSP-level aggregates, not sub-publishing splits)",[751,6796,6797],{},"It starts breaking down when:",[982,6799,6800,6810],{},[985,6801,6802],{},[988,6803,6804,6807],{},[991,6805,6806],{},"Signal",[991,6808,6809],{},"Why It Matters",[1004,6811,6812,6822,6832,6842],{},[988,6813,6814,6819],{},[1009,6815,6816],{},[842,6817,6818],{},"Royalty logic becomes the product",[1009,6820,6821],{},"If your competitive advantage is in how you calculate, split, and report royalties - with advances, recoupables, and multi-party splits - you'll outgrow Revelator's royalty engine before its delivery",[988,6823,6824,6829],{},[1009,6825,6826],{},[842,6827,6828],{},"You need real-time delivery control",[1009,6830,6831],{},"The mandatory approval step and lack of granular delivery status callbacks limit automation at scale",[988,6833,6834,6839],{},[1009,6835,6836],{},[842,6837,6838],{},"DSP-specific customization matters",[1009,6840,6841],{},"If you need different DDEX profiles per DSP (ERN 3.8.2 for legacy, ERN 4.3 for Spotify), you'll need your own generation pipeline",[988,6843,6844,6849],{},[1009,6845,6846],{},[842,6847,6848],{},"Vendor risk becomes unacceptable",[1009,6850,6851],{},"Revelator is VC-backed. API changes, pricing shifts, or an acquisition could force migration under pressure",[1800,6853,6854],{},[751,6855,6856,6857,6860],{},"The practical tipping point is usually ",[842,6858,6859],{},"2-3 years"," into the hybrid approach, when the workarounds and API limitations start costing more in engineering time than building the replaced components would.",[2710,6862],{},[746,6864,6866],{"id":6865},"the-hybrid-to-independent-migration-path","The Hybrid-to-Independent Migration Path",[751,6868,6869],{},"The smartest architecture for Option A anticipates Option B:",[2683,6871,6872,6878,6884,6890],{},[1162,6873,6874,6877],{},[842,6875,6876],{},"Own your metadata."," Never treat Revelator as the source of truth. Your database is canonical; Revelator is a sync target.",[1162,6879,6880,6883],{},[842,6881,6882],{},"Abstract the delivery layer."," Build an internal delivery interface that Revelator implements today but could be swapped for direct DSP integrations tomorrow.",[1162,6885,6886,6889],{},[842,6887,6888],{},"Build your own rights engine from day one."," Territory restrictions, split sheets, and rights ownership are your core IP. Never delegate this logic to the platform.",[1162,6891,6892,6895],{},[842,6893,6894],{},"Invest in DDEX competency."," Understanding ERN generation and validation - even if Revelator handles it today - is essential knowledge for the eventual transition.",[872,6897,6898],{},[751,6899,6900,6901,6904],{},"This way, when Option A hits its ceiling, you migrate ",[842,6902,6903],{},"component by component"," rather than executing a risky big-bang rewrite.",[2710,6906],{},[746,6908,6910],{"id":6909},"conclusion","Conclusion",[751,6912,6913],{},"For distributors with direct DSP contracts who are hitting the limits of their current platform, the hybrid approach - custom frontend on Revelator's API - is the fastest path to operational control without the multi-year investment of going fully independent.",[751,6915,6916],{},"The key is to build it with migration in mind. Own your metadata, abstract your delivery layer, and invest in DDEX expertise. When the time comes to replace the backend, you'll be swapping a component rather than rebuilding a platform.",[2710,6918],{},[746,6920,6922],{"id":6921},"resources","Resources",[1159,6924,6925,6932,6939,6946,6950,6955],{},[1162,6926,6927],{},[807,6928,6931],{"href":6929,"rel":6930},"https://api-docs.revelator.com",[811],"Revelator API Documentation",[1162,6933,6934],{},[807,6935,6938],{"href":6936,"rel":6937},"https://kb.ddex.net/implementing-each-standard/electronic-release-notification-message-suite-(ern)/",[811],"DDEX ERN Knowledge Base",[1162,6940,6941],{},[807,6942,6945],{"href":6943,"rel":6944},"https://ddexvalidator.musictechlab.io/",[811],"MTL DDEX Validator",[1162,6947,6948],{},[807,6949,136],{"href":137},[1162,6951,6952],{},[807,6953,6954],{"href":161},"Introduction to Generating DDEX Files Using Python",[1162,6956,6957,6960],{},[807,6958,6959],{"href":85},"AI-Powered Analytics Dashboard"," - once distribution data flows into your analytics pipeline, make it queryable with natural language",[2757,6962,6963],{},"html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}",{"title":902,"searchDepth":903,"depth":903,"links":6965},[6966,6967,6968,6975,6980,6986,6992,6993,6994,6995],{"id":4759,"depth":903,"text":4760},{"id":4825,"depth":903,"text":4826},{"id":4857,"depth":903,"text":4858,"children":6969},[6970,6971,6972,6973,6974],{"id":4867,"depth":1225,"text":4868},{"id":4888,"depth":1225,"text":4744},{"id":4920,"depth":1225,"text":4921},{"id":4935,"depth":1225,"text":4936},{"id":4950,"depth":1225,"text":4951},{"id":4976,"depth":903,"text":4977,"children":6976},[6977,6978,6979],{"id":5103,"depth":1225,"text":5104},{"id":5170,"depth":1225,"text":5171},{"id":5226,"depth":1225,"text":5227},{"id":5975,"depth":903,"text":5976,"children":6981},[6982,6983,6984,6985],{"id":5985,"depth":1225,"text":5986},{"id":6217,"depth":1225,"text":6218},{"id":6402,"depth":1225,"text":6403},{"id":6631,"depth":1225,"text":6632},{"id":6667,"depth":903,"text":6668,"children":6987},[6988,6989,6990,6991],{"id":6682,"depth":1225,"text":6683},{"id":6689,"depth":1225,"text":6690},{"id":6754,"depth":1225,"text":6755},{"id":6761,"depth":1225,"text":6762},{"id":6770,"depth":903,"text":6771},{"id":6865,"depth":903,"text":6866},{"id":6909,"depth":903,"text":6910},{"id":6921,"depth":903,"text":6922},"2026-02-17T00:00:00.000Z","A practical guide for music distributors evaluating a hybrid approach: custom frontend with Revelator's API as the delivery backbone. Covers architecture, DDEX integration, territory handling, and when to go fully independent.",{"src":6999},"/images/blog/musictechlab_blog_building-a-custom-music-delivery-platform-on-the-revelator-api.webp",{"enabled":918,"items":7001},[7002,7004,7007,7010],{"text":7003,"icon":922},"Revelator claims 100+ DSP integrations but requires a manual approval step before delivery.",{"text":7005,"icon":7006},"Territory restrictions must be consistent across three XML sections or deliveries fail silently.","i-lucide-alert-triangle",{"text":7008,"icon":7009},"Own your metadata from day one and treat Revelator as a sync target, not the source of truth.","i-lucide-database",{"text":7011,"icon":7012},"The hybrid approach typically hits its ceiling after 2-3 years of scaling.","i-lucide-trending-up",{},{"title":112,"description":6997},[911,933,3086,7016],"royalties","j-0HOY7SF2pZKgaTUKG4xI6pYGGOIVWAd9EiQc5LjGU",{"id":7019,"title":148,"authors":7020,"badge":741,"body":7024,"category":911,"client":741,"date":9203,"description":9204,"extension":914,"faq":741,"featured":69,"featuredOrder":741,"hidden":69,"image":9205,"keyTakeaways":9207,"meta":9220,"navigation":918,"path":149,"seo":9221,"status":741,"stem":150,"tags":9222,"teaser":741,"__hash__":9223,"score":1225},"posts/blog/music-data/how-to-transcribe-video-to-text-using-whisper.md",[7021],{"name":946,"to":7022,"avatar":7023},"https://www.linkedin.com/in/mariusz-smenzyk",{"src":949},{"type":743,"value":7025,"toc":9171},[7026,7030,7037,7040,7042,7046,7057,7059,7063,7066,7070,7086,7090,7116,7120,7129,7132,7145,7147,7151,7154,7169,7172,7201,7203,7207,7210,7242,7245,7271,7274,7308,7310,7314,7318,7343,7347,7453,7462,7466,7492,7509,7511,7515,7518,7522,7549,7553,7577,7581,7588,7594,7596,7600,7603,8425,8428,8440,8442,8446,8449,8662,8665,8671,8673,8677,8680,8816,8818,8822,8826,8840,8900,8904,8907,8941,8945,8961,9022,9024,9028,9097,9100,9111,9113,9117,9120,9138,9141,9143,9145,9168],[746,7027,7029],{"id":7028},"introduction","Introduction",[751,7031,7032,7033,7036],{},"Got a recorded interview, meeting, or podcast that needs transcription? Instead of paying for online transcription services, you can use ",[842,7034,7035],{},"OpenAI Whisper"," - a free, open-source speech recognition model that runs locally on your machine.",[751,7038,7039],{},"In this guide, we'll walk through the complete pipeline: from video file to ready-to-use text transcription.",[2710,7041],{},[746,7043,7045],{"id":7044},"requirements","Requirements",[1159,7047,7048,7051,7054],{},[1162,7049,7050],{},"Python 3.8+",[1162,7052,7053],{},"FFmpeg (for audio/video conversion)",[1162,7055,7056],{},"2-10 GB of free disk space (depending on model size)",[2710,7058],{},[746,7060,7062],{"id":7061},"step-1-install-ffmpeg","Step 1: Install FFmpeg",[751,7064,7065],{},"FFmpeg is needed to extract audio from video files.",[1065,7067,7069],{"id":7068},"macos-homebrew","macOS (Homebrew)",[1189,7071,7073],{"className":2369,"code":7072,"language":2372,"meta":902,"style":902},"brew install ffmpeg\n",[963,7074,7075],{"__ignoreMap":902},[1197,7076,7077,7080,7083],{"class":1199,"line":1200},[1197,7078,7079],{"class":1234},"brew",[1197,7081,7082],{"class":1244}," install",[1197,7084,7085],{"class":1244}," ffmpeg\n",[1065,7087,7089],{"id":7088},"ubuntudebian","Ubuntu/Debian",[1189,7091,7093],{"className":2369,"code":7092,"language":2372,"meta":902,"style":902},"sudo apt update\nsudo apt install ffmpeg\n",[963,7094,7095,7106],{"__ignoreMap":902},[1197,7096,7097,7100,7103],{"class":1199,"line":1200},[1197,7098,7099],{"class":1234},"sudo",[1197,7101,7102],{"class":1244}," apt",[1197,7104,7105],{"class":1244}," update\n",[1197,7107,7108,7110,7112,7114],{"class":1199,"line":903},[1197,7109,7099],{"class":1234},[1197,7111,7102],{"class":1244},[1197,7113,7082],{"class":1244},[1197,7115,7085],{"class":1244},[1065,7117,7119],{"id":7118},"windows","Windows",[751,7121,7122,7123,7128],{},"Download from ",[807,7124,7127],{"href":7125,"rel":7126},"https://ffmpeg.org/download.html",[811],"ffmpeg.org"," and add to PATH.",[751,7130,7131],{},"Verify installation:",[1189,7133,7135],{"className":2369,"code":7134,"language":2372,"meta":902,"style":902},"ffmpeg -version\n",[963,7136,7137],{"__ignoreMap":902},[1197,7138,7139,7142],{"class":1199,"line":1200},[1197,7140,7141],{"class":1234},"ffmpeg",[1197,7143,7144],{"class":1244}," -version\n",[2710,7146],{},[746,7148,7150],{"id":7149},"step-2-install-openai-whisper","Step 2: Install OpenAI Whisper",[751,7152,7153],{},"Install Whisper via pip:",[1189,7155,7157],{"className":2369,"code":7156,"language":2372,"meta":902,"style":902},"pip install openai-whisper\n",[963,7158,7159],{"__ignoreMap":902},[1197,7160,7161,7164,7166],{"class":1199,"line":1200},[1197,7162,7163],{"class":1234},"pip",[1197,7165,7082],{"class":1244},[1197,7167,7168],{"class":1244}," openai-whisper\n",[751,7170,7171],{},"For faster GPU transcription (NVIDIA):",[1189,7173,7175],{"className":2369,"code":7174,"language":2372,"meta":902,"style":902},"pip install openai-whisper torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118\n",[963,7176,7177],{"__ignoreMap":902},[1197,7178,7179,7181,7183,7186,7189,7192,7195,7198],{"class":1199,"line":1200},[1197,7180,7163],{"class":1234},[1197,7182,7082],{"class":1244},[1197,7184,7185],{"class":1244}," openai-whisper",[1197,7187,7188],{"class":1244}," torch",[1197,7190,7191],{"class":1244}," torchvision",[1197,7193,7194],{"class":1244}," torchaudio",[1197,7196,7197],{"class":1244}," --index-url",[1197,7199,7200],{"class":1244}," https://download.pytorch.org/whl/cu118\n",[2710,7202],{},[746,7204,7206],{"id":7205},"step-3-extract-audio-from-video","Step 3: Extract Audio from Video",[751,7208,7209],{},"Pull the audio track from your video file:",[1189,7211,7213],{"className":2369,"code":7212,"language":2372,"meta":902,"style":902},"ffmpeg -i interview.mp4 -vn -acodec libmp3lame -q:a 2 interview.mp3\n",[963,7214,7215],{"__ignoreMap":902},[1197,7216,7217,7219,7222,7225,7228,7231,7234,7237,7239],{"class":1199,"line":1200},[1197,7218,7141],{"class":1234},[1197,7220,7221],{"class":1244}," -i",[1197,7223,7224],{"class":1244}," interview.mp4",[1197,7226,7227],{"class":1244}," -vn",[1197,7229,7230],{"class":1244}," -acodec",[1197,7232,7233],{"class":1244}," libmp3lame",[1197,7235,7236],{"class":1244}," -q:a",[1197,7238,1754],{"class":1262},[1197,7240,7241],{"class":1244}," interview.mp3\n",[751,7243,7244],{},"Flag breakdown:",[1159,7246,7247,7253,7259,7265],{},[1162,7248,7249,7252],{},[963,7250,7251],{},"-i interview.mp4"," - input file",[1162,7254,7255,7258],{},[963,7256,7257],{},"-vn"," - no video (audio only)",[1162,7260,7261,7264],{},[963,7262,7263],{},"-acodec libmp3lame"," - MP3 codec",[1162,7266,7267,7270],{},[963,7268,7269],{},"-q:a 2"," - high audio quality",[751,7272,7273],{},"For a smaller file (sufficient for transcription):",[1189,7275,7277],{"className":2369,"code":7276,"language":2372,"meta":902,"style":902},"ffmpeg -i interview.mp4 -vn -ar 16000 -ac 1 -b:a 64k interview.mp3\n",[963,7278,7279],{"__ignoreMap":902},[1197,7280,7281,7283,7285,7287,7289,7292,7295,7298,7300,7303,7306],{"class":1199,"line":1200},[1197,7282,7141],{"class":1234},[1197,7284,7221],{"class":1244},[1197,7286,7224],{"class":1244},[1197,7288,7227],{"class":1244},[1197,7290,7291],{"class":1244}," -ar",[1197,7293,7294],{"class":1262}," 16000",[1197,7296,7297],{"class":1244}," -ac",[1197,7299,2090],{"class":1262},[1197,7301,7302],{"class":1244}," -b:a",[1197,7304,7305],{"class":1244}," 64k",[1197,7307,7241],{"class":1244},[2710,7309],{},[746,7311,7313],{"id":7312},"step-4-transcribe-with-whisper","Step 4: Transcribe with Whisper",[1065,7315,7317],{"id":7316},"basic-cli-usage","Basic CLI Usage",[1189,7319,7321],{"className":2369,"code":7320,"language":2372,"meta":902,"style":902},"whisper interview.mp3 --language English --model medium\n",[963,7322,7323],{"__ignoreMap":902},[1197,7324,7325,7328,7331,7334,7337,7340],{"class":1199,"line":1200},[1197,7326,7327],{"class":1234},"whisper",[1197,7329,7330],{"class":1244}," interview.mp3",[1197,7332,7333],{"class":1244}," --language",[1197,7335,7336],{"class":1244}," English",[1197,7338,7339],{"class":1244}," --model",[1197,7341,7342],{"class":1244}," medium\n",[1065,7344,7346],{"id":7345},"available-models","Available Models",[982,7348,7349,7368],{},[985,7350,7351],{},[988,7352,7353,7356,7359,7362,7365],{},[991,7354,7355],{},"Model",[991,7357,7358],{},"Size",[991,7360,7361],{},"VRAM",[991,7363,7364],{},"Quality",[991,7366,7367],{},"Speed",[1004,7369,7370,7387,7403,7419,7436],{},[988,7371,7372,7375,7378,7381,7384],{},[1009,7373,7374],{},"tiny",[1009,7376,7377],{},"39 MB",[1009,7379,7380],{},"~1 GB",[1009,7382,7383],{},"Low",[1009,7385,7386],{},"Very fast",[988,7388,7389,7392,7395,7397,7400],{},[1009,7390,7391],{},"base",[1009,7393,7394],{},"74 MB",[1009,7396,7380],{},[1009,7398,7399],{},"Medium",[1009,7401,7402],{},"Fast",[988,7404,7405,7408,7411,7414,7417],{},[1009,7406,7407],{},"small",[1009,7409,7410],{},"244 MB",[1009,7412,7413],{},"~2 GB",[1009,7415,7416],{},"Good",[1009,7418,7399],{},[988,7420,7421,7424,7427,7430,7433],{},[1009,7422,7423],{},"medium",[1009,7425,7426],{},"769 MB",[1009,7428,7429],{},"~5 GB",[1009,7431,7432],{},"Very good",[1009,7434,7435],{},"Slow",[988,7437,7438,7441,7444,7447,7450],{},[1009,7439,7440],{},"large",[1009,7442,7443],{},"1550 MB",[1009,7445,7446],{},"~10 GB",[1009,7448,7449],{},"Best",[1009,7451,7452],{},"Very slow",[751,7454,7455,7456,7458,7459,7461],{},"For most use cases, ",[963,7457,7407],{}," or ",[963,7460,7423],{}," offers the best quality-to-speed ratio.",[1065,7463,7465],{"id":7464},"save-to-text-file","Save to Text File",[1189,7467,7469],{"className":2369,"code":7468,"language":2372,"meta":902,"style":902},"whisper interview.mp3 --language English --model medium --output_format txt\n",[963,7470,7471],{"__ignoreMap":902},[1197,7472,7473,7475,7477,7479,7481,7483,7486,7489],{"class":1199,"line":1200},[1197,7474,7327],{"class":1234},[1197,7476,7330],{"class":1244},[1197,7478,7333],{"class":1244},[1197,7480,7336],{"class":1244},[1197,7482,7339],{"class":1244},[1197,7484,7485],{"class":1244}," medium",[1197,7487,7488],{"class":1244}," --output_format",[1197,7490,7491],{"class":1244}," txt\n",[751,7493,7494,7495,1146,7498,1146,7501,1146,7504,1146,7507],{},"Available output formats: ",[963,7496,7497],{},"txt",[963,7499,7500],{},"vtt",[963,7502,7503],{},"srt",[963,7505,7506],{},"tsv",[963,7508,1193],{},[2710,7510],{},[746,7512,7514],{"id":7513},"example-transcribing-a-user-interview","Example: Transcribing a User Interview",[751,7516,7517],{},"Let's say you recorded a 15-minute user feedback session about your product. Here's the complete workflow:",[1065,7519,7521],{"id":7520},"_1-extract-audio","1. Extract Audio",[1189,7523,7525],{"className":2369,"code":7524,"language":2372,"meta":902,"style":902},"ffmpeg -i user_feedback_session.mov -vn -ar 16000 -ac 1 feedback.mp3\n",[963,7526,7527],{"__ignoreMap":902},[1197,7528,7529,7531,7533,7536,7538,7540,7542,7544,7546],{"class":1199,"line":1200},[1197,7530,7141],{"class":1234},[1197,7532,7221],{"class":1244},[1197,7534,7535],{"class":1244}," user_feedback_session.mov",[1197,7537,7227],{"class":1244},[1197,7539,7291],{"class":1244},[1197,7541,7294],{"class":1262},[1197,7543,7297],{"class":1244},[1197,7545,2090],{"class":1262},[1197,7547,7548],{"class":1244}," feedback.mp3\n",[1065,7550,7552],{"id":7551},"_2-run-transcription","2. Run Transcription",[1189,7554,7556],{"className":2369,"code":7555,"language":2372,"meta":902,"style":902},"whisper feedback.mp3 --language English --model medium --output_format txt\n",[963,7557,7558],{"__ignoreMap":902},[1197,7559,7560,7562,7565,7567,7569,7571,7573,7575],{"class":1199,"line":1200},[1197,7561,7327],{"class":1234},[1197,7563,7564],{"class":1244}," feedback.mp3",[1197,7566,7333],{"class":1244},[1197,7568,7336],{"class":1244},[1197,7570,7339],{"class":1244},[1197,7572,7485],{"class":1244},[1197,7574,7488],{"class":1244},[1197,7576,7491],{"class":1244},[1065,7578,7580],{"id":7579},"_3-output","3. Output",[751,7582,7583,7584,7587],{},"Whisper creates ",[963,7585,7586],{},"feedback.txt"," with content like:",[1189,7589,7592],{"className":7590,"code":7591,"language":4422},[4420],"So the first thing about these signals before the interval.\nYes, so you set a 25-second interval and before the interval\nyou get 4 audio signals, let's say, the main signal with an\naccent and then 4 weaker ones again. So basically if you don't\narrive exactly on the signal, you know that you need to speed\nup by two seconds or slow down by two seconds because the sound\ntells you that.\n",[963,7593,7591],{"__ignoreMap":902},[2710,7595],{},[746,7597,7599],{"id":7598},"example-python-script-for-batch-processing","Example: Python Script for Batch Processing",[751,7601,7602],{},"For processing multiple files or integrating into your workflow:",[1189,7604,7606],{"className":1527,"code":7605,"language":1529,"meta":902,"style":902},"#!/usr/bin/env python3\n\"\"\"\nVideo to Text Transcription Pipeline\nUses FFmpeg + OpenAI Whisper\n\"\"\"\n\nimport subprocess\nimport whisper\nfrom pathlib import Path\n\n\ndef extract_audio(video_path: str, audio_path: str) -> None:\n    \"\"\"Extract audio from video using FFmpeg.\"\"\"\n    cmd = [\n        \"ffmpeg\", \"-i\", video_path,\n        \"-vn\", \"-ar\", \"16000\", \"-ac\", \"1\",\n        \"-b:a\", \"64k\", \"-y\",\n        audio_path\n    ]\n    subprocess.run(cmd, check=True, capture_output=True)\n    print(f\"Audio extracted: {audio_path}\")\n\n\ndef transcribe_audio(\n    audio_path: str,\n    output_path: str,\n    model_name: str = \"medium\",\n    language: str = \"en\"\n) -> str:\n    \"\"\"Transcribe audio using Whisper.\"\"\"\n    print(f\"Loading model {model_name}...\")\n    model = whisper.load_model(model_name)\n\n    print(\"Transcribing...\")\n    result = model.transcribe(audio_path, language=language)\n\n    text = result[\"text\"]\n\n    with open(output_path, \"w\", encoding=\"utf-8\") as f:\n        f.write(text)\n\n    print(f\"Transcription saved: {output_path}\")\n    return text\n\n\ndef main():\n    # Configuration\n    video_file = \"meeting_recording.mp4\"\n    audio_file = \"temp_audio.mp3\"\n    output_file = \"meeting_transcript.txt\"\n\n    # Pipeline\n    extract_audio(video_file, audio_file)\n    text = transcribe_audio(audio_file, output_file)\n\n    # Cleanup temp file\n    Path(audio_file).unlink()\n\n    print(f\"\\nTranscription preview:\\n{text[:500]}...\")\n\n\nif __name__ == \"__main__\":\n    main()\n",[963,7607,7608,7613,7618,7623,7628,7632,7636,7643,7650,7663,7667,7671,7704,7714,7723,7747,7793,7822,7827,7831,7860,7883,7887,7891,7900,7911,7922,7941,7959,7969,7978,8001,8022,8026,8041,8072,8076,8095,8099,8143,8159,8163,8185,8193,8198,8203,8214,8220,8235,8250,8265,8270,8276,8294,8315,8320,8326,8344,8349,8387,8392,8397,8417],{"__ignoreMap":902},[1197,7609,7610],{"class":1199,"line":1200},[1197,7611,7612],{"class":1762},"#!/usr/bin/env python3\n",[1197,7614,7615],{"class":1199,"line":903},[1197,7616,7617],{"class":1623},"\"\"\"\n",[1197,7619,7620],{"class":1199,"line":1225},[1197,7621,7622],{"class":1762},"Video to Text Transcription Pipeline\n",[1197,7624,7625],{"class":1199,"line":1269},[1197,7626,7627],{"class":1762},"Uses FFmpeg + OpenAI Whisper\n",[1197,7629,7630],{"class":1199,"line":1304},[1197,7631,7617],{"class":1623},[1197,7633,7634],{"class":1199,"line":1339},[1197,7635,1579],{"emptyLinePlaceholder":918},[1197,7637,7638,7640],{"class":1199,"line":1374},[1197,7639,3124],{"class":1623},[1197,7641,7642],{"class":1536}," subprocess\n",[1197,7644,7645,7647],{"class":1199,"line":1410},[1197,7646,3124],{"class":1623},[1197,7648,7649],{"class":1536}," whisper\n",[1197,7651,7652,7655,7658,7660],{"class":1199,"line":1416},[1197,7653,7654],{"class":1623},"from",[1197,7656,7657],{"class":1536}," pathlib ",[1197,7659,3124],{"class":1623},[1197,7661,7662],{"class":1536}," Path\n",[1197,7664,7665],{"class":1199,"line":1766},[1197,7666,1579],{"emptyLinePlaceholder":918},[1197,7668,7669],{"class":1199,"line":2063},[1197,7670,1579],{"emptyLinePlaceholder":918},[1197,7672,7673,7675,7678,7680,7683,7685,7688,7690,7693,7695,7697,7699,7701],{"class":1199,"line":2109},[1197,7674,1584],{"class":1212},[1197,7676,7677],{"class":1587}," extract_audio",[1197,7679,1591],{"class":1203},[1197,7681,7682],{"class":1594},"video_path",[1197,7684,1219],{"class":1203},[1197,7686,7687],{"class":1234}," str",[1197,7689,1250],{"class":1203},[1197,7691,7692],{"class":1594}," audio_path",[1197,7694,1219],{"class":1203},[1197,7696,7687],{"class":1234},[1197,7698,1603],{"class":1203},[1197,7700,1606],{"class":1203},[1197,7702,7703],{"class":1203}," None:\n",[1197,7705,7706,7709,7712],{"class":1199,"line":2152},[1197,7707,7708],{"class":1623},"    \"\"\"",[1197,7710,7711],{"class":1762},"Extract audio from video using FFmpeg.",[1197,7713,7617],{"class":1623},[1197,7715,7716,7719,7721],{"class":1199,"line":2158},[1197,7717,7718],{"class":1536},"    cmd ",[1197,7720,1540],{"class":1203},[1197,7722,1222],{"class":1203},[1197,7724,7725,7727,7729,7731,7733,7735,7738,7740,7742,7745],{"class":1199,"line":2171},[1197,7726,5658],{"class":1203},[1197,7728,7141],{"class":1244},[1197,7730,1216],{"class":1203},[1197,7732,1250],{"class":1203},[1197,7734,1231],{"class":1203},[1197,7736,7737],{"class":1244},"-i",[1197,7739,1216],{"class":1203},[1197,7741,1250],{"class":1203},[1197,7743,7744],{"class":1536}," video_path",[1197,7746,1915],{"class":1203},[1197,7748,7749,7751,7753,7755,7757,7759,7762,7764,7766,7768,7771,7773,7775,7777,7780,7782,7784,7786,7789,7791],{"class":1199,"line":2237},[1197,7750,5658],{"class":1203},[1197,7752,7257],{"class":1244},[1197,7754,1216],{"class":1203},[1197,7756,1250],{"class":1203},[1197,7758,1231],{"class":1203},[1197,7760,7761],{"class":1244},"-ar",[1197,7763,1216],{"class":1203},[1197,7765,1250],{"class":1203},[1197,7767,1231],{"class":1203},[1197,7769,7770],{"class":1244},"16000",[1197,7772,1216],{"class":1203},[1197,7774,1250],{"class":1203},[1197,7776,1231],{"class":1203},[1197,7778,7779],{"class":1244},"-ac",[1197,7781,1216],{"class":1203},[1197,7783,1250],{"class":1203},[1197,7785,1231],{"class":1203},[1197,7787,7788],{"class":1244},"1",[1197,7790,1216],{"class":1203},[1197,7792,1915],{"class":1203},[1197,7794,7795,7797,7800,7802,7804,7806,7809,7811,7813,7815,7818,7820],{"class":1199,"line":2300},[1197,7796,5658],{"class":1203},[1197,7798,7799],{"class":1244},"-b:a",[1197,7801,1216],{"class":1203},[1197,7803,1250],{"class":1203},[1197,7805,1231],{"class":1203},[1197,7807,7808],{"class":1244},"64k",[1197,7810,1216],{"class":1203},[1197,7812,1250],{"class":1203},[1197,7814,1231],{"class":1203},[1197,7816,7817],{"class":1244},"-y",[1197,7819,1216],{"class":1203},[1197,7821,1915],{"class":1203},[1197,7823,7824],{"class":1199,"line":2305},[1197,7825,7826],{"class":1536},"        audio_path\n",[1197,7828,7829],{"class":1199,"line":3484},[1197,7830,4369],{"class":1203},[1197,7832,7833,7836,7838,7841,7843,7846,7848,7851,7854,7857],{"class":1199,"line":3490},[1197,7834,7835],{"class":1536},"    subprocess",[1197,7837,1675],{"class":1203},[1197,7839,7840],{"class":1587},"run",[1197,7842,1591],{"class":1203},[1197,7844,7845],{"class":1587},"cmd",[1197,7847,1250],{"class":1203},[1197,7849,7850],{"class":1594}," check",[1197,7852,7853],{"class":1203},"=True,",[1197,7855,7856],{"class":1594}," capture_output",[1197,7858,7859],{"class":1203},"=True)\n",[1197,7861,7862,7865,7867,7869,7872,7874,7877,7879,7881],{"class":1199,"line":3498},[1197,7863,7864],{"class":1587},"    print",[1197,7866,1591],{"class":1203},[1197,7868,5289],{"class":1212},[1197,7870,7871],{"class":1244},"\"Audio extracted: ",[1197,7873,5294],{"class":1262},[1197,7875,7876],{"class":1587},"audio_path",[1197,7878,3256],{"class":1262},[1197,7880,1216],{"class":1244},[1197,7882,1757],{"class":1203},[1197,7884,7885],{"class":1199,"line":3511},[1197,7886,1579],{"emptyLinePlaceholder":918},[1197,7888,7889],{"class":1199,"line":3517},[1197,7890,1579],{"emptyLinePlaceholder":918},[1197,7892,7893,7895,7898],{"class":1199,"line":3549},[1197,7894,1584],{"class":1212},[1197,7896,7897],{"class":1587}," transcribe_audio",[1197,7899,3444],{"class":1203},[1197,7901,7902,7905,7907,7909],{"class":1199,"line":3562},[1197,7903,7904],{"class":1594},"    audio_path",[1197,7906,1219],{"class":1203},[1197,7908,7687],{"class":1234},[1197,7910,1915],{"class":1203},[1197,7912,7913,7916,7918,7920],{"class":1199,"line":3568},[1197,7914,7915],{"class":1594},"    output_path",[1197,7917,1219],{"class":1203},[1197,7919,7687],{"class":1234},[1197,7921,1915],{"class":1203},[1197,7923,7924,7927,7929,7931,7933,7935,7937,7939],{"class":1199,"line":3574},[1197,7925,7926],{"class":1594},"    model_name",[1197,7928,1219],{"class":1203},[1197,7930,7687],{"class":1234},[1197,7932,3220],{"class":1203},[1197,7934,1231],{"class":1203},[1197,7936,7423],{"class":1244},[1197,7938,1216],{"class":1203},[1197,7940,1915],{"class":1203},[1197,7942,7943,7946,7948,7950,7952,7954,7957],{"class":1199,"line":3581},[1197,7944,7945],{"class":1594},"    language",[1197,7947,1219],{"class":1203},[1197,7949,7687],{"class":1234},[1197,7951,3220],{"class":1203},[1197,7953,1231],{"class":1203},[1197,7955,7956],{"class":1244},"en",[1197,7958,4405],{"class":1203},[1197,7960,7961,7963,7965,7967],{"class":1199,"line":5787},[1197,7962,1603],{"class":1203},[1197,7964,1606],{"class":1203},[1197,7966,7687],{"class":1234},[1197,7968,1636],{"class":1203},[1197,7970,7971,7973,7976],{"class":1199,"line":5792},[1197,7972,7708],{"class":1623},[1197,7974,7975],{"class":1762},"Transcribe audio using Whisper.",[1197,7977,7617],{"class":1623},[1197,7979,7980,7982,7984,7986,7989,7991,7994,7996,7999],{"class":1199,"line":5798},[1197,7981,7864],{"class":1587},[1197,7983,1591],{"class":1203},[1197,7985,5289],{"class":1212},[1197,7987,7988],{"class":1244},"\"Loading model ",[1197,7990,5294],{"class":1262},[1197,7992,7993],{"class":1587},"model_name",[1197,7995,3256],{"class":1262},[1197,7997,7998],{"class":1244},"...\"",[1197,8000,1757],{"class":1203},[1197,8002,8003,8006,8008,8011,8013,8016,8018,8020],{"class":1199,"line":5814},[1197,8004,8005],{"class":1536},"    model ",[1197,8007,1540],{"class":1203},[1197,8009,8010],{"class":1536}," whisper",[1197,8012,1675],{"class":1203},[1197,8014,8015],{"class":1587},"load_model",[1197,8017,1591],{"class":1203},[1197,8019,7993],{"class":1587},[1197,8021,1757],{"class":1203},[1197,8023,8024],{"class":1199,"line":5843},[1197,8025,1579],{"emptyLinePlaceholder":918},[1197,8027,8028,8030,8032,8034,8037,8039],{"class":1199,"line":5853},[1197,8029,7864],{"class":1587},[1197,8031,1591],{"class":1203},[1197,8033,1216],{"class":1203},[1197,8035,8036],{"class":1244},"Transcribing...",[1197,8038,1216],{"class":1203},[1197,8040,1757],{"class":1203},[1197,8042,8043,8046,8048,8051,8053,8056,8058,8060,8062,8065,8067,8070],{"class":1199,"line":5858},[1197,8044,8045],{"class":1536},"    result ",[1197,8047,1540],{"class":1203},[1197,8049,8050],{"class":1536}," model",[1197,8052,1675],{"class":1203},[1197,8054,8055],{"class":1587},"transcribe",[1197,8057,1591],{"class":1203},[1197,8059,7876],{"class":1587},[1197,8061,1250],{"class":1203},[1197,8063,8064],{"class":1594}," language",[1197,8066,1540],{"class":1203},[1197,8068,8069],{"class":1587},"language",[1197,8071,1757],{"class":1203},[1197,8073,8074],{"class":1199,"line":5863},[1197,8075,1579],{"emptyLinePlaceholder":918},[1197,8077,8078,8081,8083,8085,8087,8089,8091,8093],{"class":1199,"line":5869},[1197,8079,8080],{"class":1536},"    text ",[1197,8082,1540],{"class":1203},[1197,8084,3675],{"class":1536},[1197,8086,1612],{"class":1203},[1197,8088,1216],{"class":1203},[1197,8090,4422],{"class":1244},[1197,8092,1216],{"class":1203},[1197,8094,1574],{"class":1203},[1197,8096,8097],{"class":1199,"line":5893},[1197,8098,1579],{"emptyLinePlaceholder":918},[1197,8100,8101,8104,8107,8109,8112,8114,8116,8119,8121,8123,8126,8128,8130,8133,8135,8137,8139,8141],{"class":1199,"line":5920},[1197,8102,8103],{"class":1623},"    with",[1197,8105,8106],{"class":1587}," open",[1197,8108,1591],{"class":1203},[1197,8110,8111],{"class":1587},"output_path",[1197,8113,1250],{"class":1203},[1197,8115,1231],{"class":1203},[1197,8117,8118],{"class":1244},"w",[1197,8120,1216],{"class":1203},[1197,8122,1250],{"class":1203},[1197,8124,8125],{"class":1594}," encoding",[1197,8127,1540],{"class":1203},[1197,8129,1216],{"class":1203},[1197,8131,8132],{"class":1244},"utf-8",[1197,8134,1216],{"class":1203},[1197,8136,1603],{"class":1203},[1197,8138,3138],{"class":1623},[1197,8140,5399],{"class":1536},[1197,8142,1636],{"class":1203},[1197,8144,8145,8148,8150,8153,8155,8157],{"class":1199,"line":5932},[1197,8146,8147],{"class":1536},"        f",[1197,8149,1675],{"class":1203},[1197,8151,8152],{"class":1587},"write",[1197,8154,1591],{"class":1203},[1197,8156,4422],{"class":1587},[1197,8158,1757],{"class":1203},[1197,8160,8161],{"class":1199,"line":5955},[1197,8162,1579],{"emptyLinePlaceholder":918},[1197,8164,8166,8168,8170,8172,8175,8177,8179,8181,8183],{"class":1199,"line":8165},42,[1197,8167,7864],{"class":1587},[1197,8169,1591],{"class":1203},[1197,8171,5289],{"class":1212},[1197,8173,8174],{"class":1244},"\"Transcription saved: ",[1197,8176,5294],{"class":1262},[1197,8178,8111],{"class":1587},[1197,8180,3256],{"class":1262},[1197,8182,1216],{"class":1244},[1197,8184,1757],{"class":1203},[1197,8186,8188,8190],{"class":1199,"line":8187},43,[1197,8189,1769],{"class":1623},[1197,8191,8192],{"class":1536}," text\n",[1197,8194,8196],{"class":1199,"line":8195},44,[1197,8197,1579],{"emptyLinePlaceholder":918},[1197,8199,8201],{"class":1199,"line":8200},45,[1197,8202,1579],{"emptyLinePlaceholder":918},[1197,8204,8206,8208,8211],{"class":1199,"line":8205},46,[1197,8207,1584],{"class":1212},[1197,8209,8210],{"class":1587}," main",[1197,8212,8213],{"class":1203},"():\n",[1197,8215,8217],{"class":1199,"line":8216},47,[1197,8218,8219],{"class":1762},"    # Configuration\n",[1197,8221,8223,8226,8228,8230,8233],{"class":1199,"line":8222},48,[1197,8224,8225],{"class":1536},"    video_file ",[1197,8227,1540],{"class":1203},[1197,8229,1231],{"class":1203},[1197,8231,8232],{"class":1244},"meeting_recording.mp4",[1197,8234,4405],{"class":1203},[1197,8236,8238,8241,8243,8245,8248],{"class":1199,"line":8237},49,[1197,8239,8240],{"class":1536},"    audio_file ",[1197,8242,1540],{"class":1203},[1197,8244,1231],{"class":1203},[1197,8246,8247],{"class":1244},"temp_audio.mp3",[1197,8249,4405],{"class":1203},[1197,8251,8253,8256,8258,8260,8263],{"class":1199,"line":8252},50,[1197,8254,8255],{"class":1536},"    output_file ",[1197,8257,1540],{"class":1203},[1197,8259,1231],{"class":1203},[1197,8261,8262],{"class":1244},"meeting_transcript.txt",[1197,8264,4405],{"class":1203},[1197,8266,8268],{"class":1199,"line":8267},51,[1197,8269,1579],{"emptyLinePlaceholder":918},[1197,8271,8273],{"class":1199,"line":8272},52,[1197,8274,8275],{"class":1762},"    # Pipeline\n",[1197,8277,8279,8282,8284,8287,8289,8292],{"class":1199,"line":8278},53,[1197,8280,8281],{"class":1587},"    extract_audio",[1197,8283,1591],{"class":1203},[1197,8285,8286],{"class":1587},"video_file",[1197,8288,1250],{"class":1203},[1197,8290,8291],{"class":1587}," audio_file",[1197,8293,1757],{"class":1203},[1197,8295,8297,8299,8301,8303,8305,8308,8310,8313],{"class":1199,"line":8296},54,[1197,8298,8080],{"class":1536},[1197,8300,1540],{"class":1203},[1197,8302,7897],{"class":1587},[1197,8304,1591],{"class":1203},[1197,8306,8307],{"class":1587},"audio_file",[1197,8309,1250],{"class":1203},[1197,8311,8312],{"class":1587}," output_file",[1197,8314,1757],{"class":1203},[1197,8316,8318],{"class":1199,"line":8317},55,[1197,8319,1579],{"emptyLinePlaceholder":918},[1197,8321,8323],{"class":1199,"line":8322},56,[1197,8324,8325],{"class":1762},"    # Cleanup temp file\n",[1197,8327,8329,8332,8334,8336,8339,8342],{"class":1199,"line":8328},57,[1197,8330,8331],{"class":1587},"    Path",[1197,8333,1591],{"class":1203},[1197,8335,8307],{"class":1587},[1197,8337,8338],{"class":1203},").",[1197,8340,8341],{"class":1587},"unlink",[1197,8343,3664],{"class":1203},[1197,8345,8347],{"class":1199,"line":8346},58,[1197,8348,1579],{"emptyLinePlaceholder":918},[1197,8350,8352,8354,8356,8358,8360,8363,8366,8368,8370,8372,8375,8378,8381,8383,8385],{"class":1199,"line":8351},59,[1197,8353,7864],{"class":1587},[1197,8355,1591],{"class":1203},[1197,8357,5289],{"class":1212},[1197,8359,1216],{"class":1244},[1197,8361,8362],{"class":1536},"\\n",[1197,8364,8365],{"class":1244},"Transcription preview:",[1197,8367,8362],{"class":1536},[1197,8369,5294],{"class":1262},[1197,8371,4422],{"class":1587},[1197,8373,8374],{"class":1203},"[:",[1197,8376,8377],{"class":1262},"500",[1197,8379,8380],{"class":1203},"]",[1197,8382,3256],{"class":1262},[1197,8384,7998],{"class":1244},[1197,8386,1757],{"class":1203},[1197,8388,8390],{"class":1199,"line":8389},60,[1197,8391,1579],{"emptyLinePlaceholder":918},[1197,8393,8395],{"class":1199,"line":8394},61,[1197,8396,1579],{"emptyLinePlaceholder":918},[1197,8398,8400,8402,8405,8408,8410,8413,8415],{"class":1199,"line":8399},62,[1197,8401,5872],{"class":1623},[1197,8403,8404],{"class":1536}," __name__ ",[1197,8406,8407],{"class":1203},"==",[1197,8409,1231],{"class":1203},[1197,8411,8412],{"class":1244},"__main__",[1197,8414,1216],{"class":1203},[1197,8416,1636],{"class":1203},[1197,8418,8420,8423],{"class":1199,"line":8419},63,[1197,8421,8422],{"class":1587},"    main",[1197,8424,3664],{"class":1203},[751,8426,8427],{},"Run it:",[1189,8429,8431],{"className":2369,"code":8430,"language":2372,"meta":902,"style":902},"python transcribe.py\n",[963,8432,8433],{"__ignoreMap":902},[1197,8434,8435,8437],{"class":1199,"line":1200},[1197,8436,1529],{"class":1234},[1197,8438,8439],{"class":1244}," transcribe.py\n",[2710,8441],{},[746,8443,8445],{"id":8444},"example-transcription-with-timestamps","Example: Transcription with Timestamps",[751,8447,8448],{},"Need timestamps for subtitles or reference? Use the segments feature:",[1189,8450,8452],{"className":1527,"code":8451,"language":1529,"meta":902,"style":902},"import whisper\n\nmodel = whisper.load_model(\"medium\")\nresult = model.transcribe(\"podcast_episode.mp3\", language=\"en\")\n\n# Print segments with timestamps\nfor segment in result[\"segments\"]:\n    start = segment[\"start\"]\n    end = segment[\"end\"]\n    text = segment[\"text\"].strip()\n    print(f\"[{start:.1f}s - {end:.1f}s] {text}\")\n",[963,8453,8454,8460,8464,8487,8523,8527,8532,8555,8575,8594,8618],{"__ignoreMap":902},[1197,8455,8456,8458],{"class":1199,"line":1200},[1197,8457,3124],{"class":1623},[1197,8459,7649],{"class":1536},[1197,8461,8462],{"class":1199,"line":903},[1197,8463,1579],{"emptyLinePlaceholder":918},[1197,8465,8466,8469,8471,8473,8475,8477,8479,8481,8483,8485],{"class":1199,"line":1225},[1197,8467,8468],{"class":1536},"model ",[1197,8470,1540],{"class":1203},[1197,8472,8010],{"class":1536},[1197,8474,1675],{"class":1203},[1197,8476,8015],{"class":1587},[1197,8478,1591],{"class":1203},[1197,8480,1216],{"class":1203},[1197,8482,7423],{"class":1244},[1197,8484,1216],{"class":1203},[1197,8486,1757],{"class":1203},[1197,8488,8489,8492,8494,8496,8498,8500,8502,8504,8507,8509,8511,8513,8515,8517,8519,8521],{"class":1199,"line":1269},[1197,8490,8491],{"class":1536},"result ",[1197,8493,1540],{"class":1203},[1197,8495,8050],{"class":1536},[1197,8497,1675],{"class":1203},[1197,8499,8055],{"class":1587},[1197,8501,1591],{"class":1203},[1197,8503,1216],{"class":1203},[1197,8505,8506],{"class":1244},"podcast_episode.mp3",[1197,8508,1216],{"class":1203},[1197,8510,1250],{"class":1203},[1197,8512,8064],{"class":1594},[1197,8514,1540],{"class":1203},[1197,8516,1216],{"class":1203},[1197,8518,7956],{"class":1244},[1197,8520,1216],{"class":1203},[1197,8522,1757],{"class":1203},[1197,8524,8525],{"class":1199,"line":1304},[1197,8526,1579],{"emptyLinePlaceholder":918},[1197,8528,8529],{"class":1199,"line":1339},[1197,8530,8531],{"class":1762},"# Print segments with timestamps\n",[1197,8533,8534,8537,8540,8542,8544,8546,8548,8551,8553],{"class":1199,"line":1374},[1197,8535,8536],{"class":1623},"for",[1197,8538,8539],{"class":1536}," segment ",[1197,8541,1630],{"class":1623},[1197,8543,3675],{"class":1536},[1197,8545,1612],{"class":1203},[1197,8547,1216],{"class":1203},[1197,8549,8550],{"class":1244},"segments",[1197,8552,1216],{"class":1203},[1197,8554,1618],{"class":1203},[1197,8556,8557,8560,8562,8565,8567,8569,8571,8573],{"class":1199,"line":1410},[1197,8558,8559],{"class":1536},"    start ",[1197,8561,1540],{"class":1203},[1197,8563,8564],{"class":1536}," segment",[1197,8566,1612],{"class":1203},[1197,8568,1216],{"class":1203},[1197,8570,2194],{"class":1244},[1197,8572,1216],{"class":1203},[1197,8574,1574],{"class":1203},[1197,8576,8577,8580,8582,8584,8586,8588,8590,8592],{"class":1199,"line":1416},[1197,8578,8579],{"class":1536},"    end ",[1197,8581,1540],{"class":1203},[1197,8583,8564],{"class":1536},[1197,8585,1612],{"class":1203},[1197,8587,1216],{"class":1203},[1197,8589,2207],{"class":1244},[1197,8591,1216],{"class":1203},[1197,8593,1574],{"class":1203},[1197,8595,8596,8598,8600,8602,8604,8606,8608,8610,8613,8616],{"class":1199,"line":1766},[1197,8597,8080],{"class":1536},[1197,8599,1540],{"class":1203},[1197,8601,8564],{"class":1536},[1197,8603,1612],{"class":1203},[1197,8605,1216],{"class":1203},[1197,8607,4422],{"class":1244},[1197,8609,1216],{"class":1203},[1197,8611,8612],{"class":1203},"].",[1197,8614,8615],{"class":1587},"strip",[1197,8617,3664],{"class":1203},[1197,8619,8620,8622,8624,8626,8629,8631,8633,8636,8638,8641,8643,8645,8647,8649,8652,8654,8656,8658,8660],{"class":1199,"line":2063},[1197,8621,7864],{"class":1587},[1197,8623,1591],{"class":1203},[1197,8625,5289],{"class":1212},[1197,8627,8628],{"class":1244},"\"[",[1197,8630,5294],{"class":1262},[1197,8632,2194],{"class":1587},[1197,8634,8635],{"class":1212},":.1f",[1197,8637,3256],{"class":1262},[1197,8639,8640],{"class":1244},"s - ",[1197,8642,5294],{"class":1262},[1197,8644,2207],{"class":1587},[1197,8646,8635],{"class":1212},[1197,8648,3256],{"class":1262},[1197,8650,8651],{"class":1244},"s] ",[1197,8653,5294],{"class":1262},[1197,8655,4422],{"class":1587},[1197,8657,3256],{"class":1262},[1197,8659,1216],{"class":1244},[1197,8661,1757],{"class":1203},[751,8663,8664],{},"Output:",[1189,8666,8669],{"className":8667,"code":8668,"language":4422},[4420],"[0.0s - 4.2s] Welcome to the show. Today we're talking about...\n[4.2s - 8.7s] ...building hardware products for athletes.\n[8.7s - 15.3s] Our guest has been working on a tempo trainer device.\n",[963,8670,8668],{"__ignoreMap":902},[2710,8672],{},[746,8674,8676],{"id":8675},"example-multi-language-detection","Example: Multi-Language Detection",[751,8678,8679],{},"Don't know the language? Let Whisper detect it:",[1189,8681,8683],{"className":1527,"code":8682,"language":1529,"meta":902,"style":902},"import whisper\n\nmodel = whisper.load_model(\"medium\")\n\n# Auto-detect language\nresult = model.transcribe(\"unknown_language.mp3\")\n\nprint(f\"Detected language: {result['language']}\")\nprint(f\"Text: {result['text']}\")\n",[963,8684,8685,8691,8695,8717,8721,8726,8749,8753,8785],{"__ignoreMap":902},[1197,8686,8687,8689],{"class":1199,"line":1200},[1197,8688,3124],{"class":1623},[1197,8690,7649],{"class":1536},[1197,8692,8693],{"class":1199,"line":903},[1197,8694,1579],{"emptyLinePlaceholder":918},[1197,8696,8697,8699,8701,8703,8705,8707,8709,8711,8713,8715],{"class":1199,"line":1225},[1197,8698,8468],{"class":1536},[1197,8700,1540],{"class":1203},[1197,8702,8010],{"class":1536},[1197,8704,1675],{"class":1203},[1197,8706,8015],{"class":1587},[1197,8708,1591],{"class":1203},[1197,8710,1216],{"class":1203},[1197,8712,7423],{"class":1244},[1197,8714,1216],{"class":1203},[1197,8716,1757],{"class":1203},[1197,8718,8719],{"class":1199,"line":1269},[1197,8720,1579],{"emptyLinePlaceholder":918},[1197,8722,8723],{"class":1199,"line":1304},[1197,8724,8725],{"class":1762},"# Auto-detect language\n",[1197,8727,8728,8730,8732,8734,8736,8738,8740,8742,8745,8747],{"class":1199,"line":1339},[1197,8729,8491],{"class":1536},[1197,8731,1540],{"class":1203},[1197,8733,8050],{"class":1536},[1197,8735,1675],{"class":1203},[1197,8737,8055],{"class":1587},[1197,8739,1591],{"class":1203},[1197,8741,1216],{"class":1203},[1197,8743,8744],{"class":1244},"unknown_language.mp3",[1197,8746,1216],{"class":1203},[1197,8748,1757],{"class":1203},[1197,8750,8751],{"class":1199,"line":1374},[1197,8752,1579],{"emptyLinePlaceholder":918},[1197,8754,8755,8758,8760,8762,8765,8767,8769,8771,8773,8775,8777,8779,8781,8783],{"class":1199,"line":1410},[1197,8756,8757],{"class":1587},"print",[1197,8759,1591],{"class":1203},[1197,8761,5289],{"class":1212},[1197,8763,8764],{"class":1244},"\"Detected language: ",[1197,8766,5294],{"class":1262},[1197,8768,869],{"class":1587},[1197,8770,1612],{"class":1203},[1197,8772,1683],{"class":1203},[1197,8774,8069],{"class":1244},[1197,8776,1683],{"class":1203},[1197,8778,8380],{"class":1203},[1197,8780,3256],{"class":1262},[1197,8782,1216],{"class":1244},[1197,8784,1757],{"class":1203},[1197,8786,8787,8789,8791,8793,8796,8798,8800,8802,8804,8806,8808,8810,8812,8814],{"class":1199,"line":1416},[1197,8788,8757],{"class":1587},[1197,8790,1591],{"class":1203},[1197,8792,5289],{"class":1212},[1197,8794,8795],{"class":1244},"\"Text: ",[1197,8797,5294],{"class":1262},[1197,8799,869],{"class":1587},[1197,8801,1612],{"class":1203},[1197,8803,1683],{"class":1203},[1197,8805,4422],{"class":1244},[1197,8807,1683],{"class":1203},[1197,8809,8380],{"class":1203},[1197,8811,3256],{"class":1262},[1197,8813,1216],{"class":1244},[1197,8815,1757],{"class":1203},[2710,8817],{},[746,8819,8821],{"id":8820},"tips-and-optimizations","Tips and Optimizations",[1065,8823,8825],{"id":8824},"_1-faster-transcription-on-apple-silicon","1. Faster Transcription on Apple Silicon",[1189,8827,8829],{"className":2369,"code":8828,"language":2372,"meta":902,"style":902},"pip install mlx-whisper\n",[963,8830,8831],{"__ignoreMap":902},[1197,8832,8833,8835,8837],{"class":1199,"line":1200},[1197,8834,7163],{"class":1234},[1197,8836,7082],{"class":1244},[1197,8838,8839],{"class":1244}," mlx-whisper\n",[1189,8841,8843],{"className":1527,"code":8842,"language":1529,"meta":902,"style":902},"import mlx_whisper\n\nresult = mlx_whisper.transcribe(\n    \"audio.mp3\",\n    path_or_hf_repo=\"mlx-community/whisper-medium-mlx\"\n)\n",[963,8844,8845,8852,8856,8871,8882,8896],{"__ignoreMap":902},[1197,8846,8847,8849],{"class":1199,"line":1200},[1197,8848,3124],{"class":1623},[1197,8850,8851],{"class":1536}," mlx_whisper\n",[1197,8853,8854],{"class":1199,"line":903},[1197,8855,1579],{"emptyLinePlaceholder":918},[1197,8857,8858,8860,8862,8865,8867,8869],{"class":1199,"line":1225},[1197,8859,8491],{"class":1536},[1197,8861,1540],{"class":1203},[1197,8863,8864],{"class":1536}," mlx_whisper",[1197,8866,1675],{"class":1203},[1197,8868,8055],{"class":1587},[1197,8870,3444],{"class":1203},[1197,8872,8873,8875,8878,8880],{"class":1199,"line":1269},[1197,8874,4282],{"class":1203},[1197,8876,8877],{"class":1244},"audio.mp3",[1197,8879,1216],{"class":1203},[1197,8881,1915],{"class":1203},[1197,8883,8884,8887,8889,8891,8894],{"class":1199,"line":1304},[1197,8885,8886],{"class":1594},"    path_or_hf_repo",[1197,8888,1540],{"class":1203},[1197,8890,1216],{"class":1203},[1197,8892,8893],{"class":1244},"mlx-community/whisper-medium-mlx",[1197,8895,4405],{"class":1203},[1197,8897,8898],{"class":1199,"line":1339},[1197,8899,1757],{"class":1203},[1065,8901,8903],{"id":8902},"_2-handling-long-recordings","2. Handling Long Recordings",[751,8905,8906],{},"For recordings over 1 hour, consider splitting:",[1189,8908,8910],{"className":2369,"code":8909,"language":2372,"meta":902,"style":902},"ffmpeg -i long_recording.mp3 -f segment -segment_time 1800 -c copy chunk_%03d.mp3\n",[963,8911,8912],{"__ignoreMap":902},[1197,8913,8914,8916,8918,8921,8924,8926,8929,8932,8935,8938],{"class":1199,"line":1200},[1197,8915,7141],{"class":1234},[1197,8917,7221],{"class":1244},[1197,8919,8920],{"class":1244}," long_recording.mp3",[1197,8922,8923],{"class":1244}," -f",[1197,8925,8564],{"class":1244},[1197,8927,8928],{"class":1244}," -segment_time",[1197,8930,8931],{"class":1262}," 1800",[1197,8933,8934],{"class":1244}," -c",[1197,8936,8937],{"class":1244}," copy",[1197,8939,8940],{"class":1244}," chunk_%03d.mp3\n",[1065,8942,8944],{"id":8943},"_3-improving-quality-for-difficult-audio","3. Improving Quality for Difficult Audio",[1159,8946,8947,8955],{},[1162,8948,8949,8950,8952,8953,1603],{},"Use a larger model (",[963,8951,7440],{}," instead of ",[963,8954,7423],{},[1162,8956,8957,8958,1219],{},"Add context with ",[963,8959,8960],{},"initial_prompt",[1189,8962,8964],{"className":1527,"code":8963,"language":1529,"meta":902,"style":902},"result = model.transcribe(\n    \"audio.mp3\",\n    language=\"en\",\n    initial_prompt=\"This is a conversation about swimming training and interval timers.\"\n)\n",[963,8965,8966,8980,8990,9004,9018],{"__ignoreMap":902},[1197,8967,8968,8970,8972,8974,8976,8978],{"class":1199,"line":1200},[1197,8969,8491],{"class":1536},[1197,8971,1540],{"class":1203},[1197,8973,8050],{"class":1536},[1197,8975,1675],{"class":1203},[1197,8977,8055],{"class":1587},[1197,8979,3444],{"class":1203},[1197,8981,8982,8984,8986,8988],{"class":1199,"line":903},[1197,8983,4282],{"class":1203},[1197,8985,8877],{"class":1244},[1197,8987,1216],{"class":1203},[1197,8989,1915],{"class":1203},[1197,8991,8992,8994,8996,8998,9000,9002],{"class":1199,"line":1225},[1197,8993,7945],{"class":1594},[1197,8995,1540],{"class":1203},[1197,8997,1216],{"class":1203},[1197,8999,7956],{"class":1244},[1197,9001,1216],{"class":1203},[1197,9003,1915],{"class":1203},[1197,9005,9006,9009,9011,9013,9016],{"class":1199,"line":1269},[1197,9007,9008],{"class":1594},"    initial_prompt",[1197,9010,1540],{"class":1203},[1197,9012,1216],{"class":1203},[1197,9014,9015],{"class":1244},"This is a conversation about swimming training and interval timers.",[1197,9017,4405],{"class":1203},[1197,9019,9020],{"class":1199,"line":1304},[1197,9021,1757],{"class":1203},[2710,9023],{},[746,9025,9027],{"id":9026},"comparison-with-alternatives","Comparison with Alternatives",[982,9029,9030,9044],{},[985,9031,9032],{},[988,9033,9034,9036,9039,9042],{},[991,9035,4469],{},[991,9037,9038],{},"Cost",[991,9040,9041],{},"Privacy",[991,9043,7364],{},[1004,9045,9046,9059,9073,9085],{},[988,9047,9048,9051,9054,9057],{},[1009,9049,9050],{},"Whisper (local)",[1009,9052,9053],{},"Free",[1009,9055,9056],{},"Full privacy",[1009,9058,7432],{},[988,9060,9061,9064,9067,9070],{},[1009,9062,9063],{},"OpenAI API",[1009,9065,9066],{},"$0.006/min",[1009,9068,9069],{},"Cloud-based",[1009,9071,9072],{},"Excellent",[988,9074,9075,9078,9081,9083],{},[1009,9076,9077],{},"Google Speech-to-Text",[1009,9079,9080],{},"$0.016/min",[1009,9082,9069],{},[1009,9084,7432],{},[988,9086,9087,9090,9093,9095],{},[1009,9088,9089],{},"AssemblyAI",[1009,9091,9092],{},"$0.015/min",[1009,9094,9069],{},[1009,9096,7432],{},[751,9098,9099],{},"Choose local Whisper when:",[1159,9101,9102,9105,9108],{},[1162,9103,9104],{},"Data privacy matters",[1162,9106,9107],{},"You have lots of content to transcribe",[1162,9109,9110],{},"You want to avoid recurring costs",[2710,9112],{},[746,9114,9116],{"id":9115},"summary","Summary",[751,9118,9119],{},"The video → mp3 → text pipeline with Whisper is straightforward:",[2683,9121,9122,9130],{},[1162,9123,9124,4660,9127],{},[842,9125,9126],{},"Extract audio",[963,9128,9129],{},"ffmpeg -i video.mp4 -vn audio.mp3",[1162,9131,9132,4660,9135],{},[842,9133,9134],{},"Transcribe",[963,9136,9137],{},"whisper audio.mp3 --language English --model medium",[751,9139,9140],{},"Everything runs locally, it's free, and delivers production-quality results.",[2710,9142],{},[746,9144,6922],{"id":6921},[1159,9146,9147,9154,9161],{},[1162,9148,9149],{},[807,9150,9153],{"href":9151,"rel":9152},"https://github.com/openai/whisper",[811],"OpenAI Whisper GitHub",[1162,9155,9156],{},[807,9157,9160],{"href":9158,"rel":9159},"https://ffmpeg.org/documentation.html",[811],"FFmpeg Documentation",[1162,9162,9163],{},[807,9164,9167],{"href":9165,"rel":9166},"https://github.com/openai/whisper/blob/main/model-card.md",[811],"Whisper Model Card",[2757,9169,9170],{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}",{"title":902,"searchDepth":903,"depth":903,"links":9172},[9173,9174,9175,9180,9181,9182,9187,9192,9193,9194,9195,9200,9201,9202],{"id":7028,"depth":903,"text":7029},{"id":7044,"depth":903,"text":7045},{"id":7061,"depth":903,"text":7062,"children":9176},[9177,9178,9179],{"id":7068,"depth":1225,"text":7069},{"id":7088,"depth":1225,"text":7089},{"id":7118,"depth":1225,"text":7119},{"id":7149,"depth":903,"text":7150},{"id":7205,"depth":903,"text":7206},{"id":7312,"depth":903,"text":7313,"children":9183},[9184,9185,9186],{"id":7316,"depth":1225,"text":7317},{"id":7345,"depth":1225,"text":7346},{"id":7464,"depth":1225,"text":7465},{"id":7513,"depth":903,"text":7514,"children":9188},[9189,9190,9191],{"id":7520,"depth":1225,"text":7521},{"id":7551,"depth":1225,"text":7552},{"id":7579,"depth":1225,"text":7580},{"id":7598,"depth":903,"text":7599},{"id":8444,"depth":903,"text":8445},{"id":8675,"depth":903,"text":8676},{"id":8820,"depth":903,"text":8821,"children":9196},[9197,9198,9199],{"id":8824,"depth":1225,"text":8825},{"id":8902,"depth":1225,"text":8903},{"id":8943,"depth":1225,"text":8944},{"id":9026,"depth":903,"text":9027},{"id":9115,"depth":903,"text":9116},{"id":6921,"depth":903,"text":6922},"2026-02-03T00:00:00.000Z","A practical guide to the video → mp3 → text pipeline using OpenAI Whisper. Free, local transcription for interviews, podcasts, and meetings.",{"src":9206},"/images/blog/musictechlab_blog_how-to-transcribe-video-to-text-using-whisper.webp",{"enabled":918,"items":9208},[9209,9211,9214,9217],{"text":9210,"icon":4729},"Whisper runs locally and for free, with no data sent to the cloud.",{"text":9212,"icon":9213},"The medium model offers the best quality-to-speed ratio for most transcription tasks.","i-lucide-zap",{"text":9215,"icon":9216},"FFmpeg extracts audio from video in one command before Whisper processes it.","i-lucide-terminal",{"text":9218,"icon":9219},"Supports 90+ languages with automatic language detection when the source is unknown.","i-lucide-globe",{},{"title":148,"description":9204},[4736,933],"BuviUKMZPE9TPst9p1kaETZ_AO8QysHB5AZaUwEOroo",1780305210138]