Personal tools

Script Sharing

Scripts: Plugins for OMERO, allowing you to add functionality to OMERO

Available Scripts

Whether you are writing a script or looking for a script to use, the following list provides an overview of all scripts that have been tested to work with a standard OMERO installation. Other scripts and examples, specialized for particular institutions or third-party extensions, are available from other repositories listed below. Scripts may require other software in addition to OMERO, which will be detailed in the description and should be readily available.

A note about versions - we use Github branches to manage our various development lines. Scripts for OMERO 5.3 release versions are located on our develop branch in the core repository, while the dev_5_2 branch is for OMERO 5.2.x. Since OMERO 5.2.x has entered maintenance mode, we recommend you work against the develop branch as a default.

Other places to find scripts

Below is a list of repositories on Github and elsewhere that have been submitted to the OME team. All of the included scripts and repositories can be downloaded following the instructions below in order to run the scripts locally (although some of them are intended as examples only - check the associated README). Some of the included scripts are also detailed above.

Downloading and installing scripts

The easiest way to make use of scripts is for your system administrator to upload them to the server. Once a script has been added under the lib/scripts directory, you can run them from the OMERO clients or the command line. Documentation for script developers and admins is available here. However, you will not be notified of any updates to the script, nor will you be able to automatically update them. This means that when your OMERO installation is upgraded, all your additional scripts will be lost.

Therefore, we recommend you use a Github repository to manage your scripts. If you aren't familiar with Git, you can use the Github app for your OS (available for Mac and Windows). The basic workflow is:

Save the scripts you want to use into the appropriate sub-directory in your cloned location lib/scripts/YOUR_SCRIPTS

If all you want to do is add scripts from someone else's repository to your server, you can simply clone that repository in your lib/scripts directory and the scripts within it will be added to your script list as described in the OMERO-user-script repository readme.

Developing your own scripts

The easiest way to get started developing scripts for your own site is to fork the github.com/ome/omero-user-scripts repository and clone it somewhere under lib/scripts as described above. Then go into YOUR_SCRIPTS and rename the existing script to match your needs (cd lib/scripts/YOUR_SCRIPTS; git mv Example.py util_scripts/New_function.py). Once you've done that, you can edit and test run the script and then when you're happy with it, you can save it and push it back to your fork for others to see and share.

If you are a biologist with no previous coding experience, you may find the Python for Biologists free online course helpful.

Submitting scripts back to the OME Consortium

If you have modified one of the core scripts or developed your own that you would like to contribute back to the OME Consortium, please get in touch. We can either add your repository to the list above so people can find it, or if the script is likely to have wide appeal, we can look into adding it to the core scripts that are distributed with an OMERO release.