==================
Download / Install
==================

.. note:: If you experience any problems installing or crashes while
          running SpinDrops, please let us know by email at
          help@spindrops.org.  Include your operating system, the
          SpinDrops version, what you were doing when the problem
          appeared, and any other information you can think of that
          will help us reproduce the problem, thanks!

SpinDrops Installers
--------------------

Current Release
===============

**Version** |release|

.. list-table::
   :class: no-cap-num

   * - `Android Notes`_
     - |
       | Coming Soon!
   * - `iOS Notes`_
     - |
       | Coming Soon!
   * - `macOS Notes`_
     - |
       | :sdl:`macOS Installer <.dmg>`
       | (App Store: Coming Soon!)

   * - `Linux Notes`_
     - |
       | :sdl:`Linux RPM Package <-1.x86_64.rpm>`
       | :sdlu:`Linux .deb Package <_amd64.deb>`
       | :sdl:`Linux Tarball <.x86_64.tar.gz>`
   * - `in-Browser Notes`_
     - |
       | |spindrops_web|
   * - `MSWindows Notes`_
     - |
       | :sdl:`Windows Installer <-install-win32.exe>`


The :ref:`ChangeLog` has a history of updates and bug fixes.


Other Documentation
-------------------

====================================== =======================================================
File                                   Description
-------------------------------------- -------------------------------------------------------
| :dl:`SpinDrops1.2.2_Tutorial.pdf`    Tutorial for the 1.2.2 version of SpinDrops for iOS.

:dl:`PhaseCyclingTutorial_Wengert.pdf` Phase Cycling Tutorial using SpinDrops by Simon Wengert
====================================== =======================================================


Android Notes
-------------

SpinDrops for Android is coming soon.

iOS Notes
---------

SpinDrops for iOS is coming soon.

macOS Notes
-----------

When installing from the ``.dmg``, there is a SpinDrops binary and a
link to your Mac's Applications folder. To install SpinDrops, open the
``.dmg`` and drag the SpinDrops icon into the Applications folder. The
SpinDrops application binary is not cryptographically signed, so the
first time it is run, macOS may not allow it to run. In order to
bypass Apple's anti-trojan protection, *Right-click the SpinDrops icon
and select Open from the menu.*

For lazy command line jockeys who just want the latest version
installed in /Applications:

.. parsed-literal::
   
    curl -LO https\://spindrops.org/downloads/SpinDrops-|release|.dmg
    sudo hdiutil attach SpinDrops-|release|.dmg
    sudo rm -rf /Applications/SpinDrops.app
    sudo cp -R /Volumes/SpinDrops-|release|/SpinDrops.app /Applications
    sudo hdiutil unmount /Volumes/SpinDrops-|release|


Linux Notes
-----------

There is an RPM, a .deb, and a .tar.gz containing binaries built on
a current Ubuntu LTS release.

When installing using the ``.rpm``, the SpinDrops binary executable
will be by default installed as ``/opt/SpinDrops/SpinDrops`` .

Copy/paste one liners for easy installation from the command line:

RedHat / CentOS / Fedora
========================

.. parsed-literal::
   
    sudo dnf install https\://spindrops.org/downloads/SpinDrops-|release|-1.x86_64.rpm
    PATH=${PATH}:/opt/SpinDrops

Debian / Ubuntu / Mint
======================

.. parsed-literal::
   
    curl -sLO https\://spindrops.org/downloads/SpinDrops\_\ |release|\ _amd64.deb
    sudo apt install ./SpinDrops\_\ |release|\ _amd64.deb
    PATH=${PATH}:/opt/SpinDrops

From Tarball
============

.. parsed-literal::
   
    curl -sLO https\://spindrops.org/downloads/SpinDrops-|release|.x86_64.tar.gz
    sudo tar -xzv -C /opt -f SpinDrops-|release|.x86_64.tar.gz
    sudo mv /opt/SpinDrops-|release|.x86_64 /opt/SpinDrops
    PATH=${PATH}:/opt/SpinDrops


in-Browser Notes
----------------

`Your browser must support WebGL
<https://get.webgl.org/get-a-webgl-implementation/>`_, as all current
browsers do.

The web version of SpinDrops saves its state (your edited sequences,
local preferences, etc...) in your web browser's local storage.
Because of this, `private browsing` mode on some browsers may prevent
SpinDrops from working.  Also, sometimes this state can become
corrupted.  To force a reset of the preferences to a known state,
simply add :code:`&--reset` to the end of the url, such as here:
|spindrops_web_reset|.

If resetting the preferences doesn't work, try clearing your browser's
cache and reloading.  SpinDrops stores its preferences and User
Sequences locally in your browser's `IndexedDB
<https://www.google.com/search?q=IndexedDB>`_, so if the RESET link
above and clearing the cache don't work, try also clearing your
browser's local "IndexedDB" (Warning: this will delete any custom
pulse sequences you had saved within the web app.)

MSWindows Notes
---------------

Older versions of Microsoft Windows may be missing dlls necessary for
running SpinDrops. The required dlls are part of the OS (since 2015),
and are also installed with updates, but may be missing from older
Windows versions.  They are available from Microsoft as a free
download, and you can find them by googling "Visual C++
Redistributable for Visual Studio 2015" :

https://www.google.com/search?q=Visual+C%2B%2B+Redistributable+for+Visual+Studio+2015

Please do contact us if you have any problems using SpinDrops on
Windows, and we'll do our best to help out!