Lightweight Lua-based IDE for Lua with code completion, syntax highlighting, live coding, remote debugger, and code analyzer; supports Lua 5.1, 5.2, 5.3, LuaJIT and other Lua interpreters on Windows, OSX, and Linux
Lua Shell Other

README.md

Project Description

ZeroBrane Studio is a lightweight cross-platform Lua IDE with code completion, syntax highlighting, remote debugger, code analyzer, live coding, and debugging support for various Lua engines (Lua 5.1, Lua 5.2, Lua 5.3, LuaJIT, LÖVE, Moai, Gideros, Corona, Marmalade Quick, Cocos2d-x, OpenResty/Nginx, Torch7, Redis, GSL-shell, Adobe Lightroom, Lapis, Moonscript, and others).

ZeroBrane Studio debugger screenshot

Features

  • Small, portable, and cross-platform (Windows, Mac OSX, and Linux).
  • Written in Lua and is extensible with Lua packages.
  • Bundled with several of the most popular Lua modules (luasocket, luafilesystem, lpeg, and luasec) compiled for all supported Lua versions.
  • Auto-complete for functions, keywords, and custom APIs with scope-aware completion for variables.
  • Syntax highlighting and scope-aware variable indicators.
  • Interactive console to directly test code snippets with local and remote execution.
  • Integrated debugger with local and remote debugging for Lua 5.1, Lua 5.2, Lua 5.3, LuaJIT, and other Lua engines.
  • Live coding with Lua, LÖVE, Gideros, Moai, Corona SDK, GSL-shell, and other engines.
  • Project view with auto-refresh and ability to hide files and directories from the list.
  • Static analysis to catch errors and typos during development.
  • Function outline.
  • Go to definition navigation.
  • Multi-cursor editing with scope-aware variable selection and renaming.
  • Fuzzy search with Go To File, project-wide Go To Symbol navigation, and Insert Library Function.
  • Find and replace in multiple files with preview and undo.
  • Several ways to extend the current functionality:
    • packages (packages/): plugins that provide additional functionality;
    • translations (cfg/i18n/): translations of the menus and messages to other languages;
    • user configuration (cfg/): settings for various components, styles, color themes, and other preferences;
    • apis (api/): descriptions for code completion and tooltips;
    • interpreters (interpreters/): components for setting debugging and run-time project environment;
    • specs (spec/): specifications for file syntax, lexer, and keywords;
    • tools (tools/): additional tools.

Documentation

Installation

The IDE can be installed into and run from any directory. There are three options to install it:

No compilation is needed for any of the installation options, although the scripts to compile required libraries for all supported platforms are available in the build/ directory.

Usage

The IDE can be launched by using the zbstudio command with slight variations depending on whether a packaged installation or a repository copy is used:

  • Windows: Run zbstudio from the directory that the IDE is installed to or create a shortcut pointing to zbstudio.exe.
  • Linux: Run zbstudio when installed from the package installation or run ./zbstudio.sh when using a snapshot/clone of the repository.
  • Mac OSX: Launch the ZeroBrane Studio application if installed or run ./zbstudio.sh when using a snapshot/clone of the repository.

The general command for launching is the following: zbstudio [option] [<project directory>] [<filename>...].

  • Open files: zbstudio <filename> [<filename>...].
  • Set project directory (and optionally open files): zbstudio <project directory> [<filename>...].
  • Overwrite default configuration: zbstudio -cfg "string with configuration settings", for example: zbstudio -cfg "editor.fontsize=12; editor.usetabs=true".
  • Load custom configuration file: zbstudio -cfg <filename>, for example: zbstudio -cfg cfg/estrela.lua.

All configuration changes applied from the command line are only effective for the current session.

If you are loading a file, you can also set the cursor on a specific line or at a specific position by using filename:<line> and filename:p<pos> syntax (0.71+).

In all cases only one instance of the IDE will be allowed to launch by default: if one instance is already running, the other one won't launch, but the directory and file parameters passed to the second instance will trigger opening of that directory and file(s) in the already started instance.

Contributing

See CONTRIBUTING.

Author

ZeroBrane Studio and MobDebug

ZeroBrane LLC: Paul Kulchenko (paul@zerobrane.com)

Estrela Editor

Luxinia Dev: Christoph Kubisch (crazybutcher@luxinia.de)

Where is Estrela?

The Estrela project that this IDE is based on has been merged into ZeroBrane Studio. If you have used Estrela for graphics shader authoring, you can use this GraphicsCodePack to get access to all API files, specifications and tools.

License

See LICENSE.