Differences

This shows you the differences between two versions of the page.

--- muse_software [2019/04/20 05:56] – [Additional Software Needed to Install Python 3] jtkorb
+++ muse_software [2019/04/23 05:29] (current) – [Overview] jtkorb
@@ Line 1: / Line 1: @@
-<WRAP center round important 60%>
-\\
-**Under Construction!**
-</WRAP>
 ====== Muse Software ======
 This page describes my software setup to communicate with the [[https://choosemuse.com/|Muse]] brain-sensing headband.
+<WRAP center round info 40%>
+These instructions have only been lightly tested.
+</WRAP>
 ===== Overview =====
-I am running the Muse software on a MacBook Pro (Retina, 13-inch, Early 2015).
+I am running the Muse software on a MacBook Pro (Retina, 13-inch, Early 2015).  These notes apply to using the Muse LSL software to communicate with the Muse or Muse 2 using a BLED112 bluetooth USB dongle.
 Base software environment:
   * Mac OS Mojave (10.14.3)
-  * Default installation of Python 2.7 will work
+  * Default Python 2.7, but Python 3.x preferred
-  * Python 3.7 is preferred
-===== Additional Software Needed to Install Python 3 =====
+===== To Install Python 3 =====
-  * XCode Command Line Tools
+These instructions are based largely on [[https://docs.python-guide.org/starting/install3/osx/|Installing Python 3 on Mac OS X]] from [[https://docs.python-guide.org/|The Hitcher's Guide to Python]].
-  * Homebrew
-===== Setup Virtual Environment =====
+Open a terminal (e.g., iTerm) to run these commands.
-Open a terminal (e.g., iTerm) to run these commands.  Create a directory, e.g., muse, and cd into it.
+  * Install XCode Command Line Tools following instructions at [[https://developer.apple.com/download/more/|More Downloads for Apple Developers]].
+  * Install [[https://brew.sh/|Homebrew]]((I am also using [[https://guide.macports.org/|Mac Ports]] to manage some software packages, which may cause conflicts with Homebrew.)) using the command:
+  $ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+  * Adjust PATH, if necessary((Set ''export PATH="/usr/local/opt/python/libexec/bin:$PATH"'' in your Bash startup file, e.g., ''.bash_profile''.)).
+  * Install Python using this command:((Python 3 is installed by default with this command.))
+  $ brew install python
+===== Setup Virtual Environment =====
   $ mkdir muse
@@ Line 37: / Line 45: @@
 ==== Python 3 ====
-  $ python3 -m venv py3
+  $ virtualenv -p python3 py3
   $ source py3/bin/activate
@@ Line 47: / Line 55: @@
-===== Install and Run in Muse LSL Streamer and Viewer =====
+===== Install Muse LSL and Run a Streamer and a Viewer =====
-Muse software is [[https://github.com/alexandrebarachant/muse-lsl|Muse LSL]].
+Muse software is described at [[https://github.com/alexandrebarachant/muse-lsl|Muse LSL]].
   $ pip install muselsl
-Plug in the Bluetooth USB (BLED112) dongle and turn on your Muse headband before launching muselsl.
+Plug in the Bluetooth USB (BLED112) dongle and turn on your Muse headband before running ''muselsl''.
   $ muselsl stream
@@ Line 76: / Line 84: @@
   $ pip install --ignore-installed scipy
-==== Some Depended Packages Don't get Installed ====
+==== Some Dependent Packages Don't get Installed ====
 If when installing scipy, it complains that matplotlib is not installed, then install it directly:
@@ Line 88: / Line 96: @@
   $ pip install muselsl --user
-===== Useful Resources =====
-* [[https://docs.python-guide.org/starting/install3/osx/|Installing Python 3 on Mac OS X]] from [[https://docs.python-guide.org/|The Hitcher's Guide to Python]]