Skip to content
| Marketplace
Sign in
Visual Studio Code>Programming Languages>Codea Air CodeNew to Visual Studio Code? Get it now.
Codea Air Code

Codea Air Code

Two Lives Left

|
33 installs
| (0) | Free
A remote editor and debugger for Codea projects.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Codea Air Code

This extension can connect remotely to the Codea iOS application, allowing to modify, tweak and debug Codea projects directly from Visual Studio Code.

Table of Contents

  • Features
    • Editor
    • Parameters
    • Debugger
  • Installation
  • Usage
    • Connection
    • Files and Dependencies
    • Commands
  • Requirements
  • License
  • Change Log

Features

Editor

Once connected to Codea, Visual Studio Code will list the files for the currently opened project, allowing to modify them, even if the project is running.

Screenshot of the editor

Parameters

The Codea button on the Visual Studio Code Sidebar will show the current parameters for the running project in Codea, if any.

All parameters can be controlled directly from Visual Studio Code even if the parameters are hidden in Codea, making it easier to tweak the projects.

Screenshot of parameters

Debugger

With a project running, Visual Studio Code can be used to attach to the running project and then used for debugging.

Some features such as modifying variables are not available yet but will be added in future updates of Codea and the extension.

Screenshot of the debugger

Conditional Breakpoints

To set a condition on a breakpoint, right click a breakpoint and select Edit Breakpoint...:

Screenshot of parameters

Enter a valid Lua expression which must be true for the breakpoint to hit.

Screenshot of parameters

Installation

Search for "Codea Air Code" in Visual Studio Code's Marketplace and install the extension.

Screenshot of the debugger

Usage

Connection

After installing the extension, open the Command Palette (Ctrl+Shift+P on Windows, ⇧⌘P on Mac), and run the Codea: Connect to Host... command to connect to a running instance of Codea on an iOS device.

Screenshot of the debugger

After typing Enter or clicking the command, Visual Studio Code will ask for Codea's IP:

Screenshot of the debugger

To find the device's IP to connect to, use the Air Code icon on the project selection screen in Codea. The default port is 18513.

Fun Fact

The idea for this extension started as a proof-of-concept of a browser based "Remote Console". The idea was to see a Codea project's logs and execute commands directly from a web browser.

Air Code's default port 18513 is actually based on the letters R (18) E (5) M (13), for REMote console.

Files and Dependencies

Files can be added, removed or renamed in Codea using the corresponding operations in Visual Studio Code.

Dependencies can be added to the active project using the Add dependency... command.

To remove a dependency, simply delete its corresponding folder in the Explorer.

Commands

All commands included with this extension are prefixed with Codea:.

Command Description
Connect to Host... Enter the IP and port to connect to a running instance of Codea.
Execute current line Executes the Lua code on the active line.
Execute selection Executes the select Lua code in Codea.
Execute command... Enter a Lua command to execute in Codea.
Restart project Restart the running project in Codea.
Add dependency... Select a dependency to add to the active Codea project.

Requirements

Codea 3.8

Screenshot of the editor

License

MIT License

Change Log

See the change log here

  • Contact us
  • Jobs
  • Privacy
  • Terms of use
  • Trademarks
© 2023 Microsoft