---
title: "Connect a Python client to Shogun Live"
canonical: "https://help.vicon.com/space/Shogun111/13208693/Connect%20a%20Python%20client%20to%20Shogun%20Live"
format: markdown
---
This section covers topics related to connecting a Python client to Live.

## Create a client and check the connection


    **To connect a Python client to Shogun Live:**


1. Start Shogun Live. It is now ready to be interacted with via the Python API.
2. Start Python and begin by importing the Vicon Core API:
  `from vicon_core_api import *`
3. Create a client. In this example, the object is named `shogun_client`:
  `shogun_client = Client('localhost')`
  Where:
  - `shogun_client` is the name of the object, which can be any name you want
  - `localhost`
                can be replaced with an IP address or hostname running Shogun Live.
4. Check that the client is connected:
  `shogun_client.connected`
  This returns True if connected, and False if not.

> Macro (scroll-pagebreak)

## Example: Setting the capture name

In Shogun Live, towards the top of the Capture panel, the default capture name is **Take**.

![image](media://79ec22ab-da59-4ca0-bf26-712152c8fa65)

This example shows how you can change the capture name using the Python API.

1. Import the relevant class for interacting with capture:
  `from shogun_live_api import CaptureServices`
2. Create an object for the capture services. In this example, the object is named `capture`, but you can name it as required.
  It references the object name used for the shogun client that was created:
  `capture = CaptureServices(shogun_client)`
3. Use the `set_capture_name` method to set the capture name to `'MyTake001'`:
  `result = capture.set_capture_name('MyTake001')`
4. Check the return value to make sure that this succeeded:
  In Shogun Live the capture name has changed:

For further information, see:

- The readme file:
  *C:\Program Files\Vicon\ShogunLive**1.11**\SDK\Python\readme.txt*
- Sample scripts:
  *C:\Program Files\Vicon\ShogunLive**1.11**\SDK\Python\sample_scripts*

## Explore using Python

Run the Python `dir()` command on objects created, to show the methods that can be called:

For example, `dir(shogun_client)` or `dir(capture)`

![image](media://a3409a47-0a01-4b13-921e-cb1d6f06d1a0)

Run `help()` on specific methods or classes.

For example, `help(capture.set_capture_name)`

![image](media://8a66be8e-88a9-45f8-9b24-324120ee3a1e)