@@ -63,6 +63,22 @@ If you want to package your project (it is required only if you need to have a p
 
 If you want to package without python, just remember to change the UnrealEnginePython.uplugin to have this line: https://github.com/20tab/UnrealEnginePython/blob/master/UnrealEnginePython.uplugin#L20 set as "Editor" instead of "Runtime"
 
+# Binaries installation on MaxOSX
+
+Check in the releases page (https://github.com/20tab/UnrealEnginePython/releases) if there is a binary version that matches your configuration (otherwise open an issue asking us for it [please specify the python version too]) and download it.
+
+Binary releases for MacOSX expects an official python installation (the packages you get from python.org).
+
+Create (if it does not already exist) a Plugins directory in your project root directory (at the same level of Content/ and the .uproject file) and unzip the plugin into it. If your project is named FooBar you will end with FooBar/Plugins/UnrealEnginePython.
+
+Open your project and go to the Edit/Plugins menu. Go to the bottom and under "Project/Scripting Languages" enable UnrealEnginePython.
+
+Restart your project and you should see the PythonConsole under the "Window/Developer Tools" menu
+
+Binary releases are mainly useful for editor scripting, if you want to package your project for distribution and you need the python runtime, you need a source release (see below).
+
+If instead, you want to package your project without python, just remember to change the UnrealEnginePython.uplugin to have this line: https://github.com/20tab/UnrealEnginePython/blob/master/UnrealEnginePython.uplugin#L20 set as "Editor" instead of "Runtime"
+
 # Installation from sources on MacOSX
 
 * install the latest official python distribution from python.org (the installation will end in the "/Library/Frameworks/Python.framework/Versions/X.Y" directory).
@@ -872,7 +888,7 @@ class Ball:
 
 Now we create (at runtime !!!) a whole new PyActor:
 
-```py
+```python
 class SuperHero:
     def begin_play(self):
         # spawn a new PyActor
@@ -890,6 +906,47 @@ class SuperHero:
         pass
 ```
 
+Spawning Notes
+--------------
+
+Remember that only Actors can be spawned in a world, and that even the editor is a valid world:
+
+```python
+import unreal_engine as ue
+from unreal_engine.classes import Actor, Character
+from unreal_engine import FVector, FRotator
+
+world = ue.get_editor_world()
+actor000 = world.actor_spawn(Actor, FVector(0, 0, 0), FRotator(0, 0, 0))
+character000 = world.actor_spawn(Character, FVector(100, 100, 100), FRotator(0, 0, 0))
+```
+
+Remember that the Blueprint asset is not a valid actor by itself, you need to get the class generated by the blueprint:
+
+```python
+import unreal_engine as ue
+from unreal_engine.classes import Blueprint
+from unreal_engine import FVector, FRotator
+
+world = ue.get_editor_world()
+
+blueprint = ue.load_object(Blueprint, '/Game/TestBall.TestBall')
+actor000 = world.actor_spawn(blueprint.GeneratedClass, FVector(0, 0, 0), FRotator(0, 0, 0))
+```
+
+otherwise you can directly reference the BlueprintGeneratedClass
+
+```python
+import unreal_engine as ue
+from unreal_engine.classes import BlueprintGeneratedClass
+from unreal_engine import FVector, FRotator
+
+world = ue.get_editor_world()
+
+blueprint_actor = ue.load_object(BlueprintGeneratedClass, '/Game/TestBall.TestBall_C')
+actor000 = world.actor_spawn(blueprint_actor, FVector(0, 0, 0), FRotator(0, 0, 0))
+```
+
 Integration with PyQT
 ---------------------
 
 
@@ -7,7 +7,7 @@ This is a plugin module giving you a shell for running python commands. It is th
 
 In this screenshot you can see how to get access to the editor world, and how to add actors to it.
 
-The console is still in early stage of development (it is really raw, do not expected a good user experience)
+The console supports history
 
 Running python scripts
 ----------------------
@@ -25,10 +25,12 @@ ue.exec('yourscript.py')
 
 python scripts are searched from the /Content/Scripts directory
 
-Editor scripting
-----------------
+Note: on python2 ue.exec is not a valid function, you need to use ue.py_exec
 
-The following functions allows access to editor internals:
+Editor scripting example
+------------------------
+
+This is an example of editor scripting from the python console
 
 ```py
 # get access to the editor world
@@ -47,8 +49,8 @@ unreal_engine.editor_select_actor(an_actor)
 new_asset = unreal_engine.import_asset(filename, package[, factory_class])
 ```
 
-Asset importing
----------------
+Asset importing example
+-----------------------
 
 The following code shows how to import an asset from python (an image as a texture):
 
@@ -86,17 +88,17 @@ factory_obj.set_property('bRGBToEmissive', True)
 new_object = ue.import_asset('C:/Users/Tester/Desktop/logo.png', '/Game/FooBar/20tab', factory_obj)
 ```
 
-Reimporting
------------
+Reimporting example
+-------------------
 
 You can reimport an object with the asset_reimport() method:
 
 ```py
 uobject.asset_reimport([ask_for_new_file, show_notification, filename])
 ```
 
-Assets listing
---------------
+Assets listing example
+----------------------
 
 ```py
 # get the assets under the specified path
@@ -169,3 +171,8 @@ ret = ue.message_dialog_open(ue.APP_MSG_TYPE_YES_NO, "Do you want to shot ?")
 if ret == ue.APP_RETURN_TYPE_YES:
     ue.log('You choose "YES"')
 ```
+
+Multiline mode
+--------------
+
+If a statement ends with ':' the python console will assume an 'incomplete' commands and will wait for the next line NOT starting with a space to issue the instructions. This mode allows you to enter functions, classes, cycles in the console.