Support

Troubleshooting

PyQt5 installation problems

If you have trouble installing neoscore, first try installing PyQt5 alone with pip install PyQt5. If this fails too, follow these troubleshooting steps.

First try upgrading pip with pip install --upgrade pip; this should fix many errors.

If that doesn’t help and you’re on a Mac system using an M1 chip, try running within the M1 compatibility layer Rosetta as described here.

If none of these steps help, check your python version with python --version. If you aren’t running on 3.7, try switching your environment’s version to 3.7 (we recommend using pyenv if you don’t know how to do this) and repeat the above steps.

Pillow installation problems

Some versions of Mac OS have trouble installing one of our dependencies, Pillow. If your installation fails, try running these commands in your environment:

pip uninstall Pillow
pip install --upgrade Pillow --no-binary :all:

Other Python Errors

If you’re getting errors saying neoscore isn’t installed or other strange Python errors, confirm that you are running on Python version 3.7 or higher with python --version. If you don’t have it, you’ll need to install it. We strongly recommend using a dedicated virtual environment for each of your projects using neoscore.

Bug Reports

We track bugs and known feature gaps at our issue tracker. If you think you’ve encountered a bug, please let us know by opening an issue! But please be sure to check for neoscore updates first (pip install --upgrade neoscore) in case we’ve already fixed it, and otherwise try to find if the bug has already been reported.

Please also consider opening an issue or posting in our forum if any part of these docs were confusing or difficult for you. If you’ve found a typo in these docs please feel free to directly open a pull request to fix it!