{"record":{"id":"ceff072bfbe48e20","repo":"spicetify/cli","slug":"aborting-the-patching-process-due-to-unsupported-b","errorCode":null,"errorMessage":"aborting the patching process due to unsupported build","messagePattern":"aborting the patching process due to unsupported build","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"critical","filePath":"src/preprocess/preprocess.go","lineNumber":148,"sourceCode":"\t\tdllPath := filepath.Join(spotifyBasePath, \"spotify.dll\")\n\t\texePath := filepath.Join(spotifyBasePath, \"spotify.exe\")\n\n\t\tif _, err := os.Stat(dllPath); err == nil {\n\t\t\tspotifyBinaryPath = dllPath\n\t\t} else if _, err := os.Stat(exePath); err == nil {\n\t\t\tspotifyBinaryPath = exePath\n\t\t} else {\n\t\t\tutils.PrintError(\"Could not find spotify.dll or spotify.exe in Spotify installation directory\")\n\t\t\tutils.Fatal(errors.New(\"aborting the patching process due to missing Spotify binaries\"))\n\t\t}\n\tcase \"darwin\":\n\t\tspotifyBinaryPath = filepath.Join(spotifyBasePath, \"..\", \"MacOS\", \"Spotify\")\n\t}\n\n\tif spotifyBinaryPath != \"\" {\n\t\tif err := validateReleaseBuild(spotifyBinaryPath); err != nil {\n\t\t\tutils.PrintError(err.Error())\n\t\t\tutils.Fatal(errors.New(\"aborting the patching process due to unsupported build\"))\n\t\t}\n\t}\n\n\tframeworkResourcesPath := \"\"\n\tswitch runtime.GOOS {\n\tcase \"darwin\":\n\t\tframeworkResourcesPath = filepath.Join(spotifyBasePath, \"..\", \"Frameworks\", \"Chromium Embedded Framework.framework\", \"Resources\")\n\tcase \"windows\", \"linux\":\n\t\tframeworkResourcesPath = spotifyBasePath\n\tdefault:\n\t\tutils.PrintError(\"Unsupported OS for V8 snapshot finding: \" + runtime.GOOS)\n\t}\n\n\tif frameworkResourcesPath != \"\" {\n\t\tfiles, err := os.ReadDir(frameworkResourcesPath)\n\t\tif err != nil {\n\t\t\tutils.PrintWarning(fmt.Sprintf(\"Could not read directory %s for V8 snapshots: %v\", frameworkResourcesPath, err))\n\t\t} else {","sourceCodeStart":130,"sourceCodeEnd":166,"githubUrl":"https://github.com/spicetify/cli/blob/1f13f736163165234eef4fb792a03f9b5b732aa4/src/preprocess/preprocess.go#L130-L166","documentation":"After locating the Spotify binary, preprocess.Start() calls validateReleaseBuild on it. If validation fails (the binary is not a supported official release build — e.g. an incorrect version or a modified build), spicetify aborts patching with this fatal error since its patches assume a specific binary layout.","triggerScenarios":"Running spicetify against a Spotify build that fails validateReleaseBuild: beta/dev Spotify versions, Spotify installed from unofficial sources, or a Spotify update that changed the binary after spicetify's supported range.","commonSituations":"Spotify auto-updated to a version not yet supported by the installed spicetify; users on Spotify beta channels; patched/tampered clients failing integrity checks.","solutions":["Update spicetify (`spicetify upgrade`) to get support for newer Spotify builds","Downgrade Spotify to a supported release version and block auto-updates (spicetify block-updates)","Use the official stable Spotify installer, not beta/unofficial builds","Check the spicetify GitHub issues/releases for the currently supported Spotify version"],"exampleFix":"// before\nspotify: 1.2.99 beta (unsupported)\n// after\nspicetify upgrade && spicetify backup apply   # with supported stable Spotify 1.2.x","handlingStrategy":"fallback","validationCode":"// Confirm your Spotify version is within the range supported by your spicetify release\n// (see spicetify release notes) before running apply/preprocess.","typeGuard":null,"tryCatchPattern":"out, err := exec.Command(\"spicetify\", \"apply\").CombinedOutput()\nif err != nil && strings.Contains(string(out), \"unsupported build\") {\n    // fallback: downgrade Spotify / upgrade spicetify, then retry\n}","preventionTips":["Keep spicetify updated (`spicetify upgrade`) alongside Spotify","Block Spotify auto-updates (`spicetify block-updates`) to avoid surprise version bumps","Use official stable Spotify builds; avoid beta/unofficial installers","Check supported versions in spicetify release notes before upgrading Spotify"],"tags":["spotify-version","incompatible-build","version-mismatch"],"backgroundTag":"unsupported-version","analyzedSha":"1f13f736163165234eef4fb792a03f9b5b732aa4","analyzedAt":"2026-08-31T18:57:59.754Z","schemaVersion":2},"datasetVersion":"2026-08-31T19:17:28.585Z"}