> For the complete documentation index, see [llms.txt](https://docs.blippar.com/blippbuilder-app-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blippar.com/blippbuilder-app-sdk/debugging-utilities/sdk-debug-telnet-console.md).

# SDK Debug Telnet Console

{% content-ref url="/spaces/3UKy7VHRJWrNarYaMp13" %}
[Blippar Documentation Centre](https://docs.blippar.com/blippar-documentation-centre/)
{% endcontent-ref %}

The purpose of the following document is to introduce developers to the Blippar SDK Telnet Console. Telnet console is a very useful debugging instrument, that allows easily to collect logs from SDK debug log remotely as well as the information about currently open blipp. You can find out more about the available functionality in the Telnet console menu that is displayed in case the connection was successful.

## Starting Telnet Console Client in the Custom SDK App <a href="#blipparsdkdebugtelnetconsole-startingtelnetconsoleclientinthecustomsdkapp" id="blipparsdkdebugtelnetconsole-startingtelnetconsoleclientinthecustomsdkapp"></a>

To start the telnet console you can do the following from the SDK:

* **iOS - Objective C**

```
BOOL didStart = [BlipparSDK sharedInstance].debugConsole start];
```

* **Android - Java**

```
boolean didStart = Blippar.getSDK().getDebugConsole().start();
```

{% hint style="info" %}
In the rare case when the console fails to start, this normally means that there is a port conflict. Choose another port and try again. Make a note of the port, on iOS it is set to `23` by default and on Android it is set to `1123.`
{% endhint %}

## Connecting to the Telnet Console from Remote Client <a href="#blipparsdkdebugtelnetconsole-connectingtothetelnetconsolefromremoteclient" id="blipparsdkdebugtelnetconsole-connectingtothetelnetconsolefromremoteclient"></a>

* To connect to the running telnet console on the device you **must** be on the same network as the device. Find out what the IP of that device is in the device wifi settings.
* Now in Terminal (on OSX) type:`telnet`
* You will be presented with a menu screen that has a host of options, it operates just like regular telnet consoles.&#x20;
* At any point, type `menu` to get back to the main menu.
* As of OSX High Sierra (10.13.2), telnet is no longer bundled as part of the OS. You can download and install it manually or easily get it via homebrew: `brew install telnet`

## Blippar SDK Telnet Console Menu <a href="#blipparsdkdebugtelnetconsole-blipparsdktelnetconsolemenu" id="blipparsdkdebugtelnetconsole-blipparsdktelnetconsolemenu"></a>

* Type `menu` in the remote Telnet client to see the list of available commands. It may differ for different SDK builds and licenses, so some of the commands may be not available to you.
* All SDK instances allow to gather app and blipp logs through the Telnet console. By using the `log` command with different keys, listed in the console menu you can configure the amount of logs you will receive from the device.
* Please use  `menu` command to discover other options available to you with their detailed description provided in the telnet console menu.

## Stopping Telnet Console Client in the Custom SDK App <a href="#blipparsdkdebugtelnetconsole-stoppingtelnetconsoleclientinthecustomsdkapp" id="blipparsdkdebugtelnetconsole-stoppingtelnetconsoleclientinthecustomsdkapp"></a>

To stop the console again (this will disconnect your machine from the device) just the following:

**iOS - Objective C**

```
[[BlipparSDK sharedInstance].debugConsole stop];
```

**Android - Java**

```
Blippar.getSDK().getDebugConsole().stop();
```