In the attempt to install Crayfish plugin from QGIS Plugin Repository, I often encounter such problem as "Crayfish depends on a platform specifi complied library which was not found. Would you like to automatically download and install one from the developer's website?" By clicking on Yes, a window with a message "Download and installation successful" will be seen. But by clicking "Ok", another message saying "couldn't load plugin crayfish due to error when calling its initGui() method" would be displayed.

  • The plugin seems to load fine in QGIS 2.16.1, which QGIS version are you using? – Joseph Oct 19 '16 at 14:05
  • Probably, I would need to get a new version. I am using QGIS 2.12.1 version. Could the error be from this? Thank you Joesph. Do I need to delete the current edition to download the new one? Or how does it works? – user74501 Oct 19 '16 at 14:16
  • You can keep the old version of QGIS if you want to. Keep in mind that a number of plugins require a certain QGIS version to work. If you download and install the latest QGIS, go to the plugin repository and it will tell you if your version of Crayfish needs to be updated. In which case, you can click the Upgrade Plugin button on the interface :) – Joseph Oct 19 '16 at 14:21
  • same issue on latest QGIS 2.16.3 on linux – Victor Oct 19 '16 at 14:38

Crayfish seems to refer to specific versions of librairies (.so.x) rather than to the main ones (.so), and therefore creates the error you have when loading since it cannot find the library.

Creating symlinks to the main libraries (itself a symlink to the current version of the library) for all libraries in question enables you to start the plugin. I cannot test if the plugin works since I have no files for it.


On (manjaro) linux you can use:

sudo ln -s libproj.so libproj.so.0
sudo ln -s libgdal.so libgdal.so.1
sudo ln -s libnetcdf.so libnetcdf.so.7
sudo ln -s libhdf5.so libhdf5.so.7

in your /lib folder.


According to the developper's website:

If you have problems downloading the binary files, it is likely caused by your proxy server. You can download the files manually and place them under your plugin folder. Make sure you choose the right binaries for your platform. For DLL files you can click here and for ffmpge click here to download the zip files from our server.

You should report this bug to get it fixed (if possible) upstream.

| improve this answer | |
  • Thanks Victor for your additional insight. But the challenge is that I use window. Not sure if it works. I will try both means and report back. Thank you all. – user74501 Oct 19 '16 at 15:51
  • 1
    Thank you all. I have been able to install Crayfish Plugin eventually. I downloaded new version of QGIS 2.18, 63-bit and then manually download compatible libraries. Thanks guys – user74501 Oct 25 '16 at 14:39
  • Any hint where to put the dll? Which plugin folder? Inside crayfish subfolder in python folder? At the root? I'm using qgis 2 btw. :) – kogexo Feb 18 '19 at 9:29
  • I tried to debug the python code loading the dll but the path indicated (.qgis2/python/plugins/crayfish/crayfish.dll) is valid and this is where I put my DLL. Any idea? – kogexo Feb 18 '19 at 9:34

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.