spyder: Spyder fails to launch on MacOS with case-sensitive root volume

Issue Report Checklist

  • Searched the issues page for similar reports
  • Read the relevant sections of the Spyder Troubleshooting Guide and followed its advice
  • Reproduced the issue after updating with conda update spyder (or pip, if not using Anaconda)
  • Could not reproduce inside jupyter qtconsole (if console-related)
  • Tried basic troubleshooting (if a bug/error)
    • Restarted Spyder
    • Reset preferences with spyder --reset
    • Reinstalled the latest version of Anaconda
    • Tried the other applicable steps from the Troubleshooting Guide
  • Completed the Problem Description, Steps to Reproduce and Version sections below

Problem Description

Spyder crashes on launch with a Mac that has a case-sensitive root volume (APFS) QT Webengine linkage incorrect

What steps reproduce the problem?

  1. Fresh install of spyder on a case-sensitive root volume in MacOS
  2. run spyder from terminal with --debug-info=verbose

What is the expected output? What do you see instead?

The QT webengine resources are installed at /Library/spyder-6/envs/spyder-runtime/resources but the linkage points to /Library/spyder-6/envs/spyder-runtime/Resources

Paste Traceback/Error Below (if applicable)

Qt WebEngine resources not found at /Library/spyder-6/envs/spyder-runtime/Resources. Trying parent directory...
Qt WebEngine resources not found at /Library/spyder-6/envs/spyder-runtime. Trying application directory...
Qt WebEngine resources not found at /Library/spyder-6/envs/spyder-runtime/bin. Trying fallback directory... The application MAY NOT work.

Versions

  • Spyder version: 6.0.3
  • Operating System name/version: MACOS Sequoia 15.1

Dependencies

PASTE DEPENDENCIES HERE

About this issue

  • Original URL
  • State: closed
  • Created 2 years ago
  • Comments: 19 (14 by maintainers)

Most upvoted comments

@mrclary Issue resolved. Installer worked, Spyder starts after installation, did a Hello world and it worked. I appreciate the effort and I think the solution was implemented in an elegant way. Good work!

@iamaiy, #24321 should resolve your issue. Will you please test that the installer works for you? First uninstall your current version of Spyder then install using this installer: https://github.com/spyder-ide/spyder/suites/37912904591/artifacts/3039044770

@mrclary, could you work on this one for 6.1.0? Thanks!

Yeah, I tried symlinking, it works… buuuut… It seems a hacky way to patch it

This is why I suggested the alternative to rename the directory to Resources, rather than create a symlink.

what would happen on a “regular” case-insensitve system when you try symlinking to the “same” directory?

Symlinking does not cause any issues, either (I did test this). But still recommend just changing the name of the directory. I tested this on my system and there appears to be no side effects. I think this makes sense since the case-insensitive file system is, well, case-insensitive 😄.

@mrclary, what if we add to the installer (in the post install script) a symlink

@ccordoba12, this may work.

@iamaiy, could you test this? First restore the original directory name to /Library/spyder-6/envs/spyder-runtime/resources. Then create a symbolic link

ln -s /Library/spyder-6/envs/spyder-runtime/resources /Library/spyder-6/envs/spyder-runtime/Resources

Alternatively, we could just rename the directory to Resources in our post-install script. This appears to work on my (case-insensitive) machine.

Also, all Apple partitions are case-sensitive, so this would not cause your issue. I’ve just installed Spyder 6.0.3 into the /Library directory using our installer and did not have any issues.

Screenshot 2025-01-06 at 12 07 03 PM

A shortcut appears at /Applications/Spyder 6.app and successfully launches. To launch from the terminal in debug mode, I recommend for macOS:

SPYDER_DEBUG=2 open -a /Applications/Spyder\ 6.app