{"record":{"id":"8a2d2656d23b692f","repo":"spicetify/cli","slug":"aborting-the-patching-process-due-to-missing-spoti","errorCode":null,"errorMessage":"aborting the patching process due to missing Spotify binaries","messagePattern":"aborting the patching process due to missing Spotify binaries","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"critical","filePath":"src/preprocess/preprocess.go","lineNumber":139,"sourceCode":"\t\tspotifyMinor, _ = strconv.Atoi(verParts[1])\n\t}\n\tif len(verParts) > 2 {\n\t\tspotifyPatch, _ = strconv.Atoi(verParts[2])\n\t}\n\n\tvar spotifyBinaryPath string\n\tswitch runtime.GOOS {\n\tcase \"windows\":\n\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","sourceCodeStart":121,"sourceCodeEnd":157,"githubUrl":"https://github.com/spicetify/cli/blob/1f13f736163165234eef4fb792a03f9b5b732aa4/src/preprocess/preprocess.go#L121-L157","documentation":"During preprocessing, spicetify locates the Spotify binary to patch: on Windows it looks for spotify.dll or spotify.exe in the Spotify installation directory. If neither file exists, it prints a detail message and fatals with this error, aborting patching because there is no binary to modify.","triggerScenarios":"Running `spicetify apply`/`preprocess` on Windows when os.Stat fails for both spotifyBasePath/spotify.dll and spotifyBasePath/spotify.exe — Spotify not installed, installed per-user vs per-machine mismatch, or a Microsoft Store (WindowsApps) installation whose files aren't at spotifyBasePath.","commonSituations":"Spotify installed from Microsoft Store instead of the standard installer; Spotify uninstalled or moved after spicetify config was created; a SPOTIFY_PATH env/config pointing at the wrong directory; corporate machines where install location differs.","solutions":["Install the standard desktop Spotify client from spotify.com (not the Microsoft Store version)","Correct the spotify_path in config-xpui.ini to the folder containing spotify.exe/spotify.dll","Reinstall Spotify if it was uninstalled or moved, then re-run spicetify","Verify the files exist: check <spotify_path>/spotify.exe manually"],"exampleFix":"// before (config-xpui.ini, wrong dir)\nspotify_path = C:\\Users\\me\\AppData\\Local\\Microsoft\\WindowsApps\n// after\nspotify_path = C:\\Users\\me\\AppData\\Roaming\\Spotify","handlingStrategy":"validation","validationCode":"spotifyPath := cfg.Get(\"Preprocess\", \"spotify_path\")\nfor _, f := range []string{\"spotify.dll\", \"spotify.exe\"} {\n    if _, err := os.Stat(filepath.Join(spotifyPath, f)); err == nil {\n        break\n    }\n    return fmt.Errorf(\"%s not found in %s; fix spotify_path or install desktop Spotify\", f, spotifyPath)\n}","typeGuard":null,"tryCatchPattern":"// spicetify fatals internally (utils.Fatal); wrap at process level:\nout, err := exec.Command(\"spicetify\", \"apply\").CombinedOutput()\nif err != nil && strings.Contains(string(out), \"missing Spotify binaries\") {\n    // fix spotify_path / reinstall Spotify before retrying\n}","preventionTips":["Install the standard desktop Spotify client, never the Microsoft Store version","Verify spotify_path in config-xpui.ini points to the folder containing spotify.exe/spotify.dll","Re-check paths after Spotify reinstalls or moves","Run `spicetify path` diagnostics after changing install locations"],"tags":["spotify-installation","windows","missing-binary"],"backgroundTag":"spotify-binary-not-found","analyzedSha":"1f13f736163165234eef4fb792a03f9b5b732aa4","analyzedAt":"2026-08-31T18:57:59.754Z","schemaVersion":2},"datasetVersion":"2026-08-31T19:17:28.585Z"}