Wiki home
Support

Troubleshooting

Start with daemon status and a foreground launch. Those two checks separate shortcut problems from Amazon Music discovery, attachment, runtime, and plugin failures.

Fast diagnostic sequence

amazify daemon status
amazify list-candidates
amazify run --foreground

Keep the foreground terminal open while reproducing the issue, then inspect the newest file in %APPDATA%\Amazify\logs.

The shortcut appears to do nothing

  • Check amazify daemon status.
  • Run amazify run --foreground to expose launch errors.
  • Recreate shortcuts with amazify shortcuts install.
  • If files are missing, rerun the current installer and keep your existing plugin data.

No Amazon Music DevTools target

  • Close all Amazon Music windows, wait a few seconds, and launch through Amazon Music (Amazify).
  • Use amazify list-candidates to confirm that the supported app installation is discovered.
  • Do not launch a normal Amazon Music shortcut first when testing a clean Amazify start.
  • Check whether another stale Amazon Music process still owns the previous session.

Amazon Music opens, but the Amazify menu is missing

  • Wait for the Amazon Music page to finish loading, then use amazify run once more to request attachment.
  • Check foreground logs for target validation, WebSocket, or runtime injection errors.
  • An Amazon Music update may have changed selectors or its Chromium surface. Check the Amazify issue tracker for a compatibility report.

A plugin is installed but does not run

  • Downloaded plugins are disabled by default; enable the package in Marketplace.
  • Confirm no newer catalog version is waiting.
  • Disable and re-enable the plugin to force its cleanup and activation paths.
  • Test without another UI plugin when two packages modify the same Amazon Music surface.
  • Reinstall the package if its local files were manually changed.

The daemon will not stop or update

Run amazify daemon stop before reinstalling. If the installer still reports a running file, close Amazon Music and any open Amazify foreground terminals, then retry. Avoid deleting the installation directory while an update is in progress.

Taskbar pinning did not work

Windows does not guarantee programmatic taskbar pinning. Find Amazon Music (Amazify) in Start, right-click it, and pin it manually. The Start Menu shortcut remains the source identity used by Amazify.

Application or plugin update fails

Check HTTPS access to GitHub, then review logs for redirect, size, digest, or catalog errors. Do not work around a digest failure by copying unverified files into the install or plugin directory.

Report a reproducible bug

Include the Amazify version, Windows version, Amazon Music installation type, plugin versions, exact steps, and relevant redacted log lines. Never post cookies, credentials, bridge tokens, or private account data.

Open GitHub issues