Steamworks Documentation
Connecting adb to Lepton
Android Debug Bridge (ADB) is a tool for communicating with a mobile device from a PC and can be downloaded from Google here. It is also included with Android Studio.

Lepton is a container for running Android apps on Linux devices such as Steam Frame. There is no Lepton container running by default on Steam Frame, so adb will not have anything to connect to until we start one. You can do this by going to your Steam Library on the Steam Frame, find "Lepton Development" and start the application. You should see a floating window appear with an Android home screen.

Note: Launching any Android game from Steam starts a Lepton container and can be connected similarly without needing to launch Lepton Development separately.

First, make sure you have turned on Developer Mode as described in the Setting up your Steam Frame for development this will let you connect and deploy to the headset.

Connecting via Wifi

  1. Open a command prompt to where you downloaded adb.exe
  2. Run adb connect frame (or substitute frame for your current hostname if you've changed it.)

Connecting via USB

By default, adb over USB will connect to the native Linux OS, while Lepton instead listens on tcp port 5555. So to connect to Lepton over USB using adb you first need to forward that port and then explicitly connect to it.
  1. Open a command prompt to where you downloaded adb.exe
  2. Run adb forward tcp:5555 tcp:5555
  3. Run adb connect localhost:5555

Note: Your PC likely does not provide enough power over USB to keep the headset running. If you prefer this method you'll want to get a cable or adapter that allows you to connect a separate power source.

Once you have run adb connect you should see:
connected to frame:5555

This means you're successfully connected to the device, and can now deploy builds like you would to any other Android device!

Troubleshooting

If you get an error, ensure:
  • A Lepton development session is currently running
  • The Steam Frame is connected to the same network as your PC
  • Your router doesn't have "client isolation" enabled
  • You don't have multiple devices on the same network with the same hostname (2 different Steam Frames with the default hostname frame)

If you see:
cannot resolve host 'frame' and port 5555: No such host is known. (11001)
You may need to use the headset's IP address instead. This can be found by clicking on your wifi network in headset under Quick Settings or Steam Settings > Internet (Example: 192.168.4.80).