To quickly search for selected string (when its different from the previous search string), you can use Select and Find Next (Ctrl/Cmd-F3) and Select and Find Previous (Ctrl/Cmd-Shift-F3). You may need to adjust permissions and create desktop entries manually. Per-user configuration is stored in HOME/.zbstudio/user.lua (where HOME is the path specified by the HOME environment variable). Individual commands can also be specified as configuration parameters; for example, zbstudio.exe -cfg "language='ru'" will set Russian as the user interface language in the IDE. (v1.40+) All the changes in the file system will be reflected in the Project tree when they happen in the folders expanded in the tree. Images loaded as toolbar and other icons can be tinted; this allows for easy changes to the style of the IDE without any modifications to the images themselves. To search or replace using regular expressions, you can toggle Regular expression icon on the search panel toolbar. (v1.80+) editor.specmap table provides a way to associate file extension with a file format. what a breath of fresh air. (doctorbling), IMHO, ZBS is the fastest, most-flexible, best-thought-out IDE AND Debugger I've used since I began coding professionally in 1980. (Michael Berlyn), Love ZeroBrane Studio. To switch back either remove the configuration setting or reset debugger.init back to an empty value. Note that on macOS the per-system configuration file and packages may be overwritten when a new version of ZeroBrane Studio is installed to the Applications directory, so you may want to save them before upgrading. To make them recognized as the code fragment, just add a new line or make it more than one line long. You can access this configuration file by going to Edit | Preferences | Settings: System (v0.37+). To limit the negative impact of socket checks for pending messages, the debugger in the application only checks for incoming requests every 200 statements (by default), so if your tests include fewer statements, then, If breakpoints are still not working, you may want to enable verbose debugging (, Open popup menu using mouse right-click, and. The editor provides default shortcuts that can be modified using editor key mapping settings. You can access this configuration file by going to Edit | Preferences | Settings: User (v0.37+). To add your own custom API to be recognized in auto-complete and tooltips, you can use the api configuration setting. I've moved over to it, forsaking my previous investment in Decoda! (Stephen Nichols), my kids love ZeroBrane. (Phil Hagelberg), ZBS is beautiful experience. You can also execute the IDE directly from the mounted dmg file, but you will not be able to make modifications to the sample scripts in the myprograms directory. To uninstall the IDE you can simply remove the directory where it was installed and delete the link added to the startup menu. For example, when searching for MyVariable([1-9]) and replacing with MyOtherVariable\1, MyVariable1 will be replaced with MyOtherVariable1, MyVariable2 with MyOtherVariable2, and so on. I am using it usually 10 hrs every day w/o problems. (Srdjan Markovic), I love ZBS. The description takes four parameters: Note that the editor key mapping is different from the IDE key mapping as the former only works when the editor is in focus and the latter may work when other components have focus. This will modify the default shortcut for Program | Start Debugging command. Yes; see Lua 5.4 debugging section for details. local mdb = require('mobdebug') (v0.80 and earlier) You may add the following line to system or user configuration: unhidewindow.ConsoleWindowClass = 0. To run multiple instances of the IDE, you can start one instance as you normally do, and then start the second instance using this command: zbstudio -cfg "singleinstance=false". For example, the value \t\tPage %p of %P for the header will print Page 1 of 1 adjusted to the right for one-page output. These schemes can be configured as shown in user-sample.lua. See all Corona-specific preferences for details. (v0.80+) This option is enabled by default. $HOME/Library/Preferences/ZeroBraneStudio Preferences on macOS, and in I am using it usually 10 hrs every day w/o problems. (Srdjan Markovic), I love ZBS. For example, when searching for MyVariable([1-9]) and replacing with MyOtherVariable\1, MyVariable1 will be replaced with MyOtherVariable1, MyVariable2 with MyOtherVariable2, and so on. To print complex elements on multiple lines, you can prepend the expression with =, as in ={1,2,3,'a','b','c'}. * parameters in configuration file(s). To open and edit the same file in multiple windows, you can use clone view plugin. You can change the current project in several ways: (v1.40+) All the changes in the file system will be reflected in the Project tree when they happen in the folders expanded in the tree. This is covered in the description of system configuration. Before version 1.21, local G = was used to provide access to the global environment from the config file. ZeroBrane Studio uses Lua files to allow users to modify its default settings and to set editor color scheme, UI language, paths to executables, and other general and editor preferences. (v0.39+) To search and auto-complete commands in the console history, you can start typing the command and then use TAB, which will auto-complete the last matching command. Works. Then update the cd (change directory) command in the zbstudio.sh script to match the directory where you moved the program. Yes; see Lua 5.3 debugging section for details. You can try changing the current line marker to something more visible, like underline by adding the following code to the configuration file: styles.marker.currentline.ch = wxstc.wxSTC_MARK_UNDERLINE. For example, on Windows the command zbstudio.exe -cfg myconfig.lua will apply settings from myconfig.lua. You may also review xcode-keys configuration file that can be used to modify keyboard shortcuts to match those in XCode. No compilation is needed as the binary components are already included, although the scripts to compile required libraries for Windows, macOS, and Linux platforms are available in the build/ directory. Powerful. (Ross Berteig), Love the debugger, saving my life. (Troy Sandal), Thanks again for your awesome IDE. This IDE is fantastic! (Eddie Dover), ZeroBrane Studio has got a working debugger, full IDE feature set, small footprint, and is completely customizable in lua. Lua (and some engines based on it, like LVE) has output buffered by default, If you need to set several values you can separate them with a semicolon: zbstudio.exe -cfg "language='ru'; editor.fontsize = 12". Lua 5.1 lists escape sequences it recognizes, but it will accept other sequences as well, for example, \/. You can open cfg/scheme-picker.lua in the IDE and click on links with color scheme names to test included schemes. Lightweight. (v0.90+) The list of functions is shown in the Outline tab located next to the Project tab. In most cases you dont need to specify this as ZeroBrane Studio will check default locations for the executable, but in those cases when auto-detection fails, you can specify the path yourself. You have no idea how excited I was to find this little gem! (Jonathan Shieh), It's a joy to use; totally rock solid. (Jeff Smith), Complaining about Zerobrane is like complaining that a beautiful spring day is a couple degrees too warm. (Jim Burnes). For more information on how to modify colors and appearance of IDE elements, check documentation on styles and color schemes. You can still refresh the Project tree content manually when it gets out of sync by using Refresh item in the Project tree local menu (activated with right click on an item). To modify the key mapping, you can add the following line to the configuration file: This will bind Ctrl-E combination to remove the line content from the current position to the end of the line. (v1.40+) The parameters will be saved per-project and restored when the project directory is updated. and those local variables that are shadowed by other local variables are striken out. This command disables a singleinstance check for the second instance and configures it to use port 8173 for debugging. To move the window, click and hold the mouse on the window caption area (when the window is undocked); then drag the window to a new location. 
You can start one instance as you normally do and then start the second instance using the following command: zbstudio -cfg "singleinstance=false; debugger.port = 8173". See the link in this ticket for alternative solutions if this doesnt work. You can specify styles.text.bg = {240,240,240} in configuration settings. it is located in %APPDATA%\ZeroBraneStudio.ini (for v0.36 and later) and in %HOME%\ZeroBraneStudio.ini (for v0.35 and earlier) on Windows (%APPDATA% is mapped to a hidden folder C:\Users\
The single instance check is disabled on macOS by default; to run multiple instances, you need to use open -n ZeroBraneStudio.app. $HOME/.ZeroBraneStudio on Linux. (as any character), char-sets ([] and [^]), modifiers + and *, and characters ^ and $ to match beginning and end of the string. (v1.10 and earlier) Right-click on ZeroBrane Studio icon -> Properties -> Compatibility -> "Disable display scaling on high DPI settings". I am using it usually 10 hrs every day w/o problems. (Srdjan Markovic), I love ZBS. The configuration files allow for several special commands: There are some rare cases in which you may need to access or change some values that are not configuration settings in the IDE. You can refresh search results by using right click on the tab and selecting Refresh Search Results from the popup menu. The IDE can be installed by dragging its directory icon from the downloaded dmg installer file into /Applications or any other directory. You may be trying to load a 64bit module using Lua executable that is included with the IDE. See the example. I am using it usually 10 hrs every day w/o problems. (Srdjan Markovic), I love ZBS. All results shown in the Console window are pretty printed as one line, with all complex results shown with all their elements. You can use any option supported by the Serpent serializer, for example, you can change the format for the results of the expression using numformat option: val --{numformat = "%x"}. what a breath of fresh air. (doctorbling), IMHO, ZBS is the fastest, most-flexible, best-thought-out IDE AND Debugger I've used since I began coding professionally in 1980. (Michael Berlyn), Love ZeroBrane Studio. When you select all instance of a variable, you can navigate them forward and backward using Find Next (F3) and Find Previous (Shift-F3).
Works. See Debugging of 64bit applications section for details. You can set the project directory, which will be used to set the current directory when your application is run or debugged. so if you only print a small number of bytes, you may see the results only after the script is completed. This IDE is fantastic! (Eddie Dover), ZeroBrane Studio has got a working debugger, full IDE feature set, small footprint, and is completely customizable in lua. Regular expressions only match within a single line (not over multiple lines). The location (and the name) of this file is system dependent: I use it for all of the work Ive started doing in Lua! An extension can also be specified on the shebang line as long as that extension is listed in the specmap table. Re-open the document or run GetEditor():SetViewEOL(0) to disable showing end-of-line sequences. If you get a firewall warning, you need to allow the connection for the debugging to work properly. Command line configuration can be specified by adding -cfg
The solution in this case is to fix the escape sequence and replace \/ with /, which will have the same effect in Lua 5.1, LuaJIT, and Lua 5.2. You will see a prompt in the Output window where you can enter your input.
Works. The values shown are example values for a Windows-based system, not default values. Upvalues shown in watch/console/stack windows will only include those upvalues that are used or referenced in the current function. In addition to system-wide and per-user configurations, it is also possible to provide a set of parameters that will be in effect only for one session. LuaJIT is a bit more strict than Lua 5.1 in some checks and may return errors even when your application runs fine by Lua 5.1. (v0.39+) When regular expression search is used with search and replace, \n refer to first through ninth pattern captures marked with brackets (). The content of the Outline can be configured in various ways. Possible placeholder values to use in formats (v0.61+): To modify a key mapping for a particular menu item, you can add the following command to your configuration: These regular expressions do not accept Lua character classes that start with % (like %s, %d, and others), but accept . Regular expressions only match within a single line (not over multiple lines). Powerful. (Ross Berteig), Love the debugger, saving my life. (Troy Sandal), Thanks again for your awesome IDE. If you are using an older version, you may need to open and edit the file directly. I use it for all of the work Ive started doing in Lua! outputshell option to specify Output window attributes has been replaced by output in v1.61+. To change the order of functions displayed in the Outline between sorted and in the order of appearence in the source file, Make sure to save your ZeroBrane Studio system settings (Edit | Preferences | Settings: System) before upgrading as those are saved inside the application directory and will be lost during the upgrade. When you release the mouse, the panel will become a standalone window that you can then re-position and dock as described earlier in this section. If you are on macOS, you may need to use open -n ZeroBraneStudio.app. To change the format of numeric values, add the following fragment to the configuration file or execute it in the Local Console (in which case it will only be active for the current session): This will affect all the numbers shown in the Watch, Stack, tooltips, and Remote Console windows. You can then navigate back to the original location by using Alt/Opt-Left. To limit the number of levels shown during pretty printing, instead of val, use return require('mobdebug').line(val, {maxlevel = 1}), and instead of =val, use return require('mobdebug').line(a, {indent = ' ', maxlevel = 1}). Lightweight. Lightweight. The access and the processing is the same for all config files.
Powerful. (Ross Berteig), Love the debugger, saving my life. (Troy Sandal), Thanks again for your awesome IDE. Use outputshell instead of output in earlier versions. To set project-specific settings, you can use project settings plugin. To enable document map that provides a birds-eye view of the currently edited document, you can use document map plugin. One typical example is string escape sequences. (v1.11+) If you are using v1.11 or later, this is no longer be needed as the IDE launcher (zbstudio.exe) enables dpi awareness by default. ]], option supported by the Serpent serializer, Use the context menu in the Project tree (mouse right click) and then. For example, .svn and *.svn will exclude all files with svn extension and .svn/ and .svn\ will completely skip processing of the .svn directory. To start the debugger server automatically when the IDE is started, you can use autostart debugger plugin. Each string may include tabs to separate parts of the header/footer that have different adjustments.
and as shown in user-sample.lua. If you try to access the value of b in the Watch or the Console window, youll get nil as that upvalue is not present in the scope of that function. Tabs in notebooks can also be split vertically or horizontally. The icon used may refer to the existing image file by name ("FILE-OPEN") or to wx.wxBitmap object; see this plugin for an example on how to create a toolbar bitmap. Collapse/Expand a particular directory, which will refresh its content. To display values from your program while it is running, you can use real-time watches view plugin. You can resize windows by dragging the splitters between them. If you launch the application outside of the IDE, make sure you flush the printed output (or use io.stdout:setvbuf('no')) before accepting the input. If you are using a server version of Ubuntu, you may need to run sudo apt-get install libgtk2.0-0 xdg-utils. To copy a value from the Watch window to the clipboard (which may be useful if the string representation of the value doesnt fit in the window), You have no idea how excited I was to find this little gem! (Jonathan Shieh), It's a joy to use; totally rock solid. (Jeff Smith), Complaining about Zerobrane is like complaining that a beautiful spring day is a couple degrees too warm. (Jim Burnes). I've moved over to it, forsaking my previous investment in Decoda! (Stephen Nichols), my kids love ZeroBrane. (Phil Hagelberg), ZBS is beautiful experience. Use outputshell instead of console in earlier versions. System and user configuration changes do not take effect until the configuration file is saved and ZeroBrane Studio is restarted. To modify default general preferences, you can use these commands and apply them When using an older version (before v0.95), reference them in the global environment: local G = ; toolbar.icons[G.ID_NEW] = false. This also works for messages in the stack trace as long as they include the file name. Any existing button on the toolbar can be removed individually by setting toolbar.icons[ID-of-the-button] to false. for example: 1+2, collectgarbage('count'), or tbl and tbl[1] or nil. what a breath of fresh air. (doctorbling), IMHO, ZBS is the fastest, most-flexible, best-thought-out IDE AND Debugger I've used since I began coding professionally in 1980. (Michael Berlyn), Love ZeroBrane Studio. No additional installation steps are needed for repository clones and snapshots (you only need to unpack the files into a destination directory). (v1.51+) To change the format of numeric values shown in Stack/Watch windows, set debugger.numformat contiguration setting to the desired value. I use it for all of the work Ive started doing in Lua! For example, to show the values in the hexadecimal format, add the following fragment to the configuration file: This will affect all the numbers shown in the Watch, Stack, and tooltips, but will not affect Local/Remote Console windows. When you reference ID value from the config file, make sure to use ID.value syntax: toolbar.icons[ID.NEW] = false (v0.95+). The format of the arguments passed using the command line is exactly the same as specified in the configuration files. local variables are maked with dotted underlines, outputshell option to specify Console window attributes has been replaced by console in v1.61+. Starting from v0.35 the debugging of LuaJIT applications is supported out-of-the-box. (v0.50+) To auto-reload externally modified files set editor.autoreload configuration setting to true. File names without a wildcard * will be applied as is; file names that end with a path separator (both file separators \ and / work on all platforms) will be applied as directory names.
The installation using the setup script requires administrative privileges. the description for possible accelerator values, For example, you may need access the spec configuration (ide.specs.lua) or call lua functions from an inline package (package { onRegister = function() table.insert(something, 'else') end }). If you are using macOS or Linux, set the path accordingly. (v1.30+) Any configured parameters will be saved and restored on the next IDE launch. This IDE is fantastic! (Eddie Dover), ZeroBrane Studio has got a working debugger, full IDE feature set, small footprint, and is completely customizable in lua. Breakpoints set in source files may not work for several reasons: See this section in the documentation for details on how to enable it. access the context menu (right click on the mouse) in the Outline and select toggle Sort By Name. When launching the IDE and passing a filename as a parameter, its possible to include the line number (using filename:
Some of the auxiliary panels can be pulled out of the notebook. For example, in local foo = 1; local foo = 2, first foo variable will be striken out as its shadowed by the second foo instance and the second foo variable will be marked with dashed underline. If you are on macOS, you may need to use open -n ZeroBraneStudio.app --args -cfg "debugger.port = 8173". Yes; see Lua 5.2 debugging section for details. what a breath of fresh air. (doctorbling), IMHO, ZBS is the fastest, most-flexible, best-thought-out IDE AND Debugger I've used since I began coding professionally in 1980. (Michael Berlyn), Love ZeroBrane Studio. The only modification that is done to the system outside of the installation directory is adding a link to the executable to the startup menu. To avoid this issue you need to configure the IDE to use your own 64bit Lua executable by setting path.lua = '/full/path/lua-executable' in the configuration. Yes; even when you use a 32bit version of the IDE, you can still run and debug 64bit applications. and as shown in user-sample.lua. See Scintilla documentation for details on what special characters are accepted. To add a confirmation dialog on moving or renaming files in the project tree, the following fragment can be added to the configuration file. To dock the window, release the mouse when one side of the main window changes its color to light blue. After the file is opened, the cursor will be moved to the specified position or the beginning of the specified line. If you want to start the execution from a different file, you may set it using the following steps: This will set the selected file as the start file; the file will have a different icon to help distinguish it from other files. (v0.38+) To select all instances of a variable (scope-aware), you can use Ctrl/Cmd+DblClick or right mouse click and select Rename All Instances. You need to execute the downloaded script as a shell script to install the IDE. If you are using one of the earlier versions, you can check Refresh Project plugin (Windows only). There is one caveat with debugging of fragments loaded with loadstring: one-line code fragments will be interpreted as filenames. (v1.20 and earlier) You need to output something using print or io.write before reading input. For example, click and hold the mouse on the tab of the Markers panel and drag it out of the notebook. Powerful. (Ross Berteig), Love the debugger, saving my life. (Troy Sandal), Thanks again for your awesome IDE. You can click the area that shows command line parameters and select other recently used parameters from the list. you may need to right click on ZeroBrane Studio application and select Show Package Contents. You can then open that file in the IDE or configure it to auto-open it for you. (v1.61+) The format of the lists has been changed from array ({"*.jpg", "*.png"}) to hash ({["*.jpg"] = true, ["*.png"] = true}) to simplify addition and removal of values. In addition to placeholders from this list, %D can be used for the current timestamp, %p for the current page, and %P for the total number of pages. You have no idea how excited I was to find this little gem! (Jonathan Shieh), It's a joy to use; totally rock solid. (Jeff Smith), Complaining about Zerobrane is like complaining that a beautiful spring day is a couple degrees too warm. (Jim Burnes). The settings set in these files are applied in the same order: system, user, command line (thus parameters specified using the command line will overwrite those specified in the system-wide configuration file). The IDE is using port 8172 to communicate with the application being debugged. See an example in user-sample.lua, You may be using your own Lua engine that doesnt report file names relative to the project directory (as set in the IDE). either by adding singleinstance=false to the configuration file Lightweight. By default the execution of the project starts with the file in the current editor tab (at least with the default Lua interpreters). Since the Lua executable is 32bit, you get the error about incompatible architectures. To search or replace using regular expressions, you can enable a checkbox Regular Expression. (v0.50 and earlier) You can set hidpi = true in configuration settings; this setting is enabled by default on macOS starting from v0.60. as described in the configuration section what a breath of fresh air. (doctorbling), IMHO, ZBS is the fastest, most-flexible, best-thought-out IDE AND Debugger I've used since I began coding professionally in 1980. (Michael Berlyn), Love ZeroBrane Studio. See Scintilla documentation for details on what special characters are accepted. All rights reserved 2012-2021 Paul Kulchenko, [[ This IDE is fantastic! (Eddie Dover), ZeroBrane Studio has got a working debugger, full IDE feature set, small footprint, and is completely customizable in lua.
The values shown are the default values. You can use this setting to specify an alternative interpreter you want to use (for example, LuaJIT instead of Lua interpreter). You can change their types, colors, or disable them. For example, on macOS it is going to be /Applications/ZeroBraneStudio.app/Contents/ZeroBraneStudio/cfg/user.lua; For example, abc/*.lua will exclude all Lua files in abc directory, but not in its subdirectories, while abc/**.lua will exclude all Lua files in abc directory and all its subdirectories and abc/ will exclude abc directory along with all its subdirectories. The editor component provides its own shortcut handling mechanism linked to specific editor actions. You can see the location of the HOME directory if you type wx.wxGetHomeDir() into the Local console. To merge or split windows and tabs and to change their positions, check the section in the Tips and Tricks document. When there is a conflict, the IDE shortcuts take preference over editor shortcuts.
what a breath of fresh air. (doctorbling), IMHO, ZBS is the fastest, most-flexible, best-thought-out IDE AND Debugger I've used since I began coding professionally in 1980. (Michael Berlyn), Love ZeroBrane Studio. If you want to continue editing this file in the IDE, you have two choices: You can start multiple instances if you disable single instance check mdb.origline, mdb.line = mdb.line, function(v) return mdb.origline(v, {numformat = "0x%x"}) end If you want to avoid docking, press Ctrl/Cmd button before releasing the mouse button. (v0.81+) You may set corona = {showconsole = true} in system or user configuration. (v1.30 and earlier) Note that using this setting negatively affects indicators that have alpha property (the indicators are not shown when this setting is enabled). You need to have a file opened in the IDE before you can step into functions defined in that file. To quickly search for previously searched word, you can use Find Next (F3) and Find Previous (Shift-F3). To modify default editor preferences, you can use these commands and apply them