{"id":45499,"library":"muzical-ui","title":"Muzical UI","description":"Muzical UI is a local-first music player built with Next.js, allowing users to scan folders on their machine, build a library, queue tracks, and play audio in the browser. Version 0.1.22 is the current stable release, with active development on GitHub. It supports browsing MusicBrainz and YouTube for discovery and streaming, stores all data locally via IndexedDB and localStorage, and requires Node.js 20+ and a Chromium-based browser for folder scanning. Differentiators include a self-contained standalone production build, resizable layout, and optional API keys for YouTube and Last.fm for enhanced features.","status":"active","version":"0.1.22","language":"javascript","source_language":"en","source_url":"https://github.com/f3rnox/muzical-ui","tags":["javascript","music","player","local-library","musicbrainz","nextjs"],"install":[{"cmd":"npm install muzical-ui","lang":"bash","label":"npm"},{"cmd":"yarn add muzical-ui","lang":"bash","label":"yarn"},{"cmd":"pnpm add muzical-ui","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Web framework for app routing and server-side rendering","package":"next","optional":false},{"reason":"UI library required by Next.js","package":"react","optional":false},{"reason":"DOM rendering required by Next.js","package":"react-dom","optional":false}],"imports":[{"note":"Package is ESM-only. No default export exists; the recommended usage is via the CLI or Next.js server integration.","wrong":"const MuzicalUI = require('muzical-ui')","symbol":"default","correct":"import MuzicalUI from 'muzical-ui'"},{"note":"Run the CLI directly with npx after installation. The bin script starts the standalone Next.js server.","wrong":"node bin/muzical-ui.js (requires build)","symbol":"CLI","correct":"npx muzical-ui"},{"note":"Named export, not default. Used to configure API keys and preferences.","wrong":"import config from 'muzical-ui'","symbol":"config","correct":"import { config } from 'muzical-ui'"}],"quickstart":{"code":"pnpm add muzical-ui\npnpm build\nnpx muzical-ui --port 3000\n# Open http://localhost:3000","lang":"bash","description":"Install, build, and run the production server with default port."},"warnings":[{"fix":"Update Node.js to version 20 or later.","message":"Requires Node.js 20+","severity":"breaking","affected_versions":">=0.1.0"},{"fix":"Use Chrome, Edge, or Opera. Firefox and Safari are not supported for local library scanning.","message":"Chromium-based browser required for folder scanning due to File System Access API","severity":"breaking","affected_versions":">=0.1.0"},{"fix":"Use 'npx muzical-ui' or update your scripts to reference 'node bin/muzical-ui.js' after build.","message":"Previous bin script path changed in v0.1.20","severity":"deprecated","affected_versions":"<0.1.20"},{"fix":"Inform users to back up their data or avoid clearing site data.","message":"Local storage (IndexedDB/localStorage) is cleared on browser cache wipe; users may lose library data and settings.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Use restrictive API keys and educate users about local-only storage.","message":"YouTube and Last.fm API keys stored in localStorage and sent to their respective APIs; keys can be viewed via browser dev tools.","severity":"gotcha","affected_versions":">=0.1.0"}],"env_vars":null,"search_vec":"'0.1.22':35 '20':67 'activ':42 'allow':15 'api':90 'audio':30 'base':72 'brows':48 'browser':33,73 'build':23,85 'built':12 'chromium':71 'chromium-bas':70 'contain':82 'current':38 'data':58 'develop':43 'differenti':77 'discoveri':53 'enhanc':97 'featur':98 'first':9 'folder':19,75 'github':45 'includ':78 'indexeddb':61 'javascript':99 'key':91 'last.fm':95 'layout':87 'librari':25,104 'local':8,59,103 'local-first':7 'local-librari':102 'localstorag':63 'machin':22 'music':10,100 'musicbrainz':49,105 'muzic':1,3 'next.js':14 'nextj':106 'node.js':66 'option':89 'play':29 'player':11,101 'product':84 'queue':26 'releas':40 'requir':65 'resiz':86 'scan':18,76 'self':81 'self-contain':80 'stabl':39 'standalon':83 'store':56 'stream':55 'support':47 'track':27 'ui':2,4 'user':16 'version':34 'via':60 'youtub':51,93","created_at":"2026-06-07T12:55:18.984670+00:00","updated_at":"2026-06-07T12:55:18.984670+00:00","problems":[{"fix":"Run 'pnpm build' before 'npx muzical-ui'.","cause":"Running CLI without building first.","error":"Error: ENOENT: no such file or directory, open '.next/standalone/server.js'"},{"fix":"Switch to a Chromium-based browser (Chrome, Edge, Opera).","cause":"Using a non-Chromium browser for local folder scanning.","error":"The File System Access API is not supported on this browser."},{"fix":"Obtain an API key from Google Cloud Console and enter it in Settings.","cause":"Missing YouTube Data API key in Settings.","error":"YouTube API key is required for reliable video resolution."},{"fix":"Run 'npm install next' or 'pnpm add next'.","cause":"Next.js not installed as a dependency.","error":"Module not found: Can't resolve 'next'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/f3rnox/muzical-ui#readme","github":"https://github.com/f3rnox/muzical-ui","docs":null,"changelog":null,"pypi":null,"npm":"muzical-ui","openapi_spec":null,"status_page":null,"smithery":null,"categories":["productivity"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}