= blender_migration branch setup =
The `blender_migration` branch is the "main" branch with the most active development.  Blender is being used to replace Continuity's Client.

[[TableOfContents()]]

[[Anchor(linux)]]
== Linux / Mac ==
=== Branch checkout ===
 1. [http://continuity.ucsd.edu/Continuity/Documentation/DeveloperDocs/CheckingOutSourceFromGit#head-b542ceb61279cea9627e942c1524e1f1cd183e6c Check out the developer version of Continuity from Git]
 
 1. [http://continuity.ucsd.edu/Continuity/Documentation/DeveloperDocs/CheckingOutSourceFromGit#head-fb55972a49e5b1db1c0eb74919cc74810c7b28a8 Obtain blender_migration branch]
 {{{
git checkout blender_migration
 }}}
=== Blender setup ===
 1. Download [http://ftp.nluug.nl/pub/graphics/blender/release/Blender2.78/blender-2.78c-linux-glibc219-x86_64.tar.bz2 Blender 2.78]
 
 1. Install Blendercomprimises
 {{{
tar -xjvf blender-2.78c-linux-glibc219-x86_64.tar.bz2
mv blender-2.78c-linux-glibc219-x86_64 blender
 }}}

 1. Continuity requires a full install of Python 3.5. Download and move this [attachment:python.tar.gzip gzip] of Python 3.5 into the `blender/2.78/` directory.
 {{{
mv python.tar.gzip blender/2.78/
cd blender/2.78/
mv python blenders_old_python
tar -xvzf python.tar.gzip
 }}}
  * Note this compromises the use of the `blender` executable without using the start script (`startBlender.sh`) inside the Continuity repo

 1. Continuity is a Blender add-on.  We need to make Blender find it inside it's add-on directory with a symbolic link. From the `blender/2.78/` directory:
 {{{
cd scripts/addonscomprimisescomprimises
ln -s path_to_Continuity_git_repo Continuity
 }}}
 
 1. To give inform our start scripts where Blender is add the path to Blender to our `systemSpecific/blenderDir.txt` in the Continuity repository.
 Mine looks like:
 {{{
$ cat systemSpecific/blenderDir.txt 
/home/seb/cont_dev/blender
 }}}
 
 1. Blender will try to launch Continuity when using Continuity as a Blender add-on, we must makes sure that Continuity is up to date. From the Continuity repository:
 {{{
./startServer.sh --update-binaries
 }}}
 When you see `listening on port 9970` stop the server with `CTRL+C`

 1. Now blender is ready to be launched. Start Blender with:
 {{{
./startBlender.sh
 }}}

 1. Attach the add-on so every time we start Blender it also launches Continuity. Inside Blender:
 {{{
"File"→"User Preferences..."
Select the "Add-ons" tab
Search for "Continuity"
Check the box for "System:Continuity"
Click "Save User Settings"
 }}}