HOWTO: Install Cytoflow#

Windows#

On Windows, you can use a graphical to install Cytoflow.

  1. Browse to https://cytoflow.github.io/

  2. Download the Windows binaries by clicking the button at the top of the page.

    ../../_images/install9.png

  3. Even though I’ve signed the Windows app, Windows doesn’t recognize me as a “certified” developer. (It’s EXPENSIVE – even more so than becoming an Apple developer.) So you’ll get a Windows protected your PC message:

    ../../_images/install10.png

    However, if you click “More information”, then you can verify that the installer is signed “Open Source Developer, Brian Teague” (that’s me!) and then click “Run anyway.”

    ../../_images/install11.png

    Note that signing this application costs me about $150 a year. Help me defray some of those costs by tossing me a few bucks at https://ko-fi.com/bteague?

  4. Follow the instructions in the installer. Once you’ve completed the installation, you should be able to find Cytoflow in your Start menu.

MacOS#

These instructions were developed using OSX Catalina. I don’t own a Mac or use one on a regular basis, so if these instructions could be improved, please let me know. Also, these binaries were almost certainly built on an Intel Mac, so they may not work on an A1 mac.

  1. Browse to https://cytoflow.github.io/

  2. Download the MacOS binaries by clicking the button at the top of the page.

    ../../_images/install3.png

  3. Using Finder, browse to your Downloads folder.

    ../../_images/install4.png

  4. Right-click on the .ZIP file you downloaded and choose “Open With –> Archive Utility.”

    ../../_images/install5.png

    This will extract the application from the archive.

  5. Double-click the new application. Because I am paying Apple $150 per year, you should not see a security warning – the app should “just work.”

    (Consider helping me defray some of that cost by donating a few bucks at https://ko-fi.com/bteague?)

  6. (Optional) Move the Cytoflow application to somewhere else “permanent”, like the desktop or your Applications folder.

Linux#

These instructions were developed on Ubuntu 20.04 – they should work on any modern Linux desktop system. However, they do require some comfort with the command line. If they don’t work for you, or you are desparate for a point-and-click installer, please file a bug (or better, a patch or pull-request.)

This results in a program that you can launch from your desktop launcher – the “Programs” menu or similar.

  1. Browse to https://cytoflow.github.io/

  2. Download the Linux binaries by clicking the button at the top of the page.

    ../../_images/install1.png

  3. Extract the archive:

    ../../_images/install2.png

  4. Move the resulting directory to a “permanent” home. I like to drop such things in ~/.local/lib, but you may prefer to put it elsewhere.

    The remaining steps should be completed from the command line, starting in the directory containing the extracted files.

    If you would like to launch Cytoflow from the command line, you can do so by navigating to this directory and running the executable cytoflow.

  5. Update the location of the icon in the .desktop file by calling the set_launcher_icon script:

    $ ./set_launcher_icon

  6. Link cytoflow.desktop into the ~/.local/share/applications directory:

    $ ln -s $PWD/cytoflow.desktop $HOME/.local/share/applications/cytoflow.desktop

  7. Update the database of desktop entries:

    $ update-desktop-database ~/.local/share/applications
On this page