Bixby Developer Studio (Bixby Studio) is available for macOS and Windows. Download the installer from the link below and run it to install Bixby Studio.
Bixby Developer Studio has the following minimum hardware recommendations:
Bixby Developer Studio requires the following minimum OS versions:
After installation, you'll need to set up Bixby Studio.
Launch Bixby Studio. On first launch, you will be asked to log in to the Bixby Developer Center.
Before logging in, check the "Server" URL in the lower-left corner of the startup screen. You should see https://bixbydevelopers.com
.
Click Log In. Your browser will open and be directed to the Samsung Account login page.
Enter your Samsung Account username and password.
After logging in, the browser displays a "Login Successful" screen. Click Launch Bixby Studio. If your browser asks if you want to allow the page to launch Bixby Studio, click Allow.
Bixby Studio then connects to the Bixby server and sets up your workspace.
Bixby Studio requires an internet connection for operation. There is no offline mode.
To connect properly, all traffic to and from these domains must pass freely over SSL (port 443):
https://bixbydevelopers.com
https://ces.bixbydevelopers.com
https://bixbydevelopers.zendesk.com
https://d215tfnc26u50d.cloudfront.net
(Bixby Studio 7.13 and older versions)https://bixby-client.aibixby.com
(Bixby Studio 7.14 and newer versions)When you first start Bixby Studio or when no files are open, you'll see the welcome screen. You can also return to this screen by clicking the Home icon in the top right corner.
The welcome screen gives you options for creating capsules, and provides information about new or interesting features. You can also quickly access current release notes and a selection of video tutorials.
Bixby Developer Studio might occasionally give you notifications about new features, upgrades, or other important information. If you have notifications waiting, the bell in the lower right corner will have a red "unread" dot on it. You can click on the bell to view these unread notifications. Notifications will also automatically be displayed when the IDE starts.
When you're working on a capsule, Bixby Studio follows design patterns you'll likely be familiar with if you've used other integrated development environments or code editors: a sidebar on the left, usually displaying a file/resource tree for your project, and a larger tabbed editor window to the right.
There are four areas of Bixby Studio's main window:
Bixby Studio's left margin displays nine icons, four at the top and five at the bottom. These Activity Bar icons switch between various tasks used in Bixby capsule development:
Nearly all tasks in Bixby Studio can be accomplished through keyboard shortcuts rather than using the mouse and menus. Bixby Studio generally follows standard platform conventions for keyboard navigation, selection, and clipboard (cut/copy/paste).
For a full list of Bixby Studio keyboard shortcuts, refer to the Keyboard Shortcuts cheatsheet.
The Files sidebar displays your list of open capsules and all the associated files within the capsules, containing source code, assets, training, and other resources. This is the currently selected view in this screenshot. This is much like the project or explorer view in other IDEs. Click on any file to preview it within the editor, and double-click it to open it. (The Settings tab allows you to change this behavior to opening files with a single-click.) Toggle the Files sidebar by clicking its activity icon or using Ctrl+1 (Windows/Linux) or Cmd+1 (Mac).
All of your currently open capsules will be displayed in the sidebar; click the disclosure triangle to the right of the capsule name to see the file trees within the capsule. For synced capsules, icons will appear by the capsule name to indicate the presence of warnings or errors; the icons will also appear by individual files that contain warnings or errors. If a capsule is not synced, its name will be dimmed and an "unsynced" icon will appear to the right of its name.
Buttons at the top of the Files sidebar allow you to create files and capsules in your workspace and to manage currently open capsules.
New has options for adding capsules, folders, and files to the workspace:
Open has options for opening existing capsules and recently used capsules.
These commands are also available from the File menu:
Sync lets you manage the capsules currently open in the workspace:
Bixby Studio supports searching for and replacing text references and symbols across either the current capsule or all open capsules. In addition to clicking the search activity icon, you can use keyboard shortcuts to open these views:
You can set the following options for find and replace:
Bixby Studio's regular expression engine is PCRE-compatible.
When you find or replace within files, the search/replace window will appear in the bottom pane of the editor window.
From this pane, you can find how many matches are found in which files, and get a preview of the matches in context by single-clicking on a line in the result pane. Double-click a line in the result pane to open that file in the editor at the selected line.
You can choose whether to find matching files in all capsules or a specific capsule. To further refine folders and files to search through, click the More button (•••) to expand the search fields.
In the additional fields, you can specify one or more folders or files to include in the search, and/or one or more folders or files to exclude. These fields are always case-sensitive and always match partial words (that is, "apple" will match "apple", "apples" and "pineapple"). Folder and filenames can be matched with glob patterns:
*
character matches everything except slashes**
sequence matches everything including slashes?
character matches any single character except a slashExample:
Foo*.bxb
will match any file that ends with .bxb
and starts with Foo
: Food.model.bxb
, FoodOrder.dialog.bxb
, and so on.models/**/*.bxb
will match any file that ends with .bxb
and is in a subfolder of models/
.training
will match any file in the training
folder.The fields can be combined. Entering *.bxb
in the "Files to include" field and training
in the "Files to exclude" field will search through all files ending in .bxb
, excluding files in the training
folder.
This view opens a pane at the bottom of the editing window that shows problems Bixby Studio has found in the currently open capsules, listed by file. Open the Warnings & Errors view by clicking its activity icon or using Ctrl+3 or Cmd+3.
Open any file listed here in the editor by clicking on it to reveal a list of errors, warnings, and deprecations within that file. Click on a line number to be taken directly to that line in the file.
The Warnings & Errors pane might provide a link to documentation that goes into more detail about a specific problem, or offer to fix the error for you. Read Quick Fix for more information.
You can choose which kinds of messages to show by checking or unchecking the boxes by Warnings, Errors, and Deprecations. Click the Recompile button to recompile all capsules and re-check them for problems.
The Warnings & Errors pane and Search pane are two tabs within the same pane. When either one is open, you can switch between them by clicking their respective activity icons, clicking the tabs themselves, or using keyboard shortcuts.
This sidebar lets you search through Bixby's developer documentation. Simply start typing a term, and relevant reference keys, guides, and documentation sections will be displayed. Open this sidebar by clicking the documentation search activity icon.
You can use the Filter menu to refine your results. Uncheck sections of the documentation you want to exclude from searching.
If you click the Open Documentation Site button, the Developer Center will open in your web browser.
Clicking this activity icon opens the Device Simulator in a separate window. You can also open the Simulator with Ctrl+7 or Cmd+7.
Clicking this activity icon opens the Debug Console in a separate window. You can also open the Debug Console with Cmd+Shift+D or Ctrl+Shift+D.
Display the status of your submissions to the Bixby Developer Center in a new editor tab by clicking the Submissions activity icon or using Ctrl+8 or Cmd+8.
This button is a shortcut to opening the Bixby Developer Center in your browser, which gives you full access to documentation as well as the tools for managing your capsule and setting up dynamic configuration and secrets.
The editor allows you to create and edit your capsule's resources. When source code is open, as in the screen shot above, the editor behaves like other code editors you might have used. Bixby Studio provides syntax highlighting for Bixby Language and JavaScript, along with automatic indenting and other helpful editing features. Bixby Studio will also show you errors and warnings in your code in real time.
The editor can have more than one file open at a time. Similar to web browsers, multiple files open in tabs along the top of the window showing the filename (or other informational view, such as training or a submission). The top right corner of the editor displays the number of open tabs; you can click in that corner to get a list of all open tabs. This lets you easily navigate between tabs, even when there are more open than can fit along the top of the editor window.
Training for your capsule opens as a tab in the editor. Other views, such as Settings and Submissions, also open in separate editor tabs.
Nearly all of Bixby Studio's functionality is accessible from the keyboard, even for commands that have no keyboard shortcut, via the Command Palette. Use Shift+Cmd+P or Shift+Ctrl+P to bring the Palette up, and start typing the command you're looking for.
The Palette displays the keyboard shortcut for any command if one is assigned. Nearly all commands available in the Palette can have keyboard shortcuts assigned to them in the Keyboard Shortcut Editor.
You can call up the history of recently opened capsules from the workspace and capsule management buttons, from the Command Palette with "Open Recent Capsules", and from File > Open Recent > More….
The history list is searchable. Individual items can be removed from the list with the × icon. The entire list can be cleared by selecting File > Open Recent > Clear Recent Capsules or executing "Clear Recent Capsules" in the Command Palette.
The bottom of the window displays, from left to right, the following content:
You can either create a new capsule from scratch, or start with a template. When you select either creation method, Bixby Studio will create your capsule's folder structure and initialize required files for you. When you start with a template for a specific kind of capsule, Bixby Studio will help you create models and code to jumpstart your development.
In addition, Bixby Developer Studio can create a new capsule based on a sample capsule to help you learn the Bixby platform.
To create a new capsule, do one of the following:
You will be prompted for a folder to save the capsule in and a capsule ID.
Bixby Studio creates a base project folder layout for you, with folders for assets, code, models, and resources, along with default capsule.bxb
and endpoints.bxb
files.
By starting from a capsule template, Bixby Studio creates basic code for you that matches your capsule's domain—a search-based capsule, for instance, or a store capsule. This can streamline your development by cutting down on the amount of boilerplate you need to create to get your capsule going.
To create a new capsule from a template, do one of the following:
You're asked to select a template.
Templates are stored on Bixby's server, which always gives you the current list of available templates. You can read more about some of the included templates in the Templates documentation.
After you choose a template, you'll be prompted to configure the capsule's language. The available languages are dependent on what's available in the template; all templates will support English as the default language. Once you've selected a language, click Next Step.
On the next screen, you'll be prompted to fill in more information specific to that template. The quiz capsule template, for example, prompts you for the quiz title and individual questions and answers, with buttons to add as many new questions as you need.
Click Next Step to advance. The final step in template creation prompts you for a folder to save the capsule in and a capsule ID. Fill in that information, and click Generate Capsule:
Bixby Studio creates a base project folder layout for you, with capsule.bxb
and endpoints.bxb
files tailored to your capsule. Depending on the template you've based your project on, basic models, resources, and other assets are already created.
Your new capsule will be opened and synced in Bixby Studio. Check the README.md
file for more detailed information on your new capsule, including documentation on the models, code, and next steps you can take to further customize its behavior and appearance, add training, and prepare it for submission to the Marketplace. Also, check for any warnings or errors, and go over the generated models, code, and resources.
Bixby Studio can automatically check out sample capsules and add them to a workspace for you.
To create a new capsule from a sample, do one of the following:
Bixby Studio will present a list of preselected sample capsules for you to choose from.
Choose a capsule name and a path for your new capsule, and then click Create Local Copy.
Bixby Studio will check out and open the sample capsule from the Bixby Developers GitHub repository.
Some sample capsules available on the Bixby Developers GitHub repository might not be available through the New Capsule from Sample function. However, you can still check out sample code directly yourself and open it within Bixby Studio.
Bixby Studio provides a full set of IDE-style features for code editing, including syntax highlighting, smart indenting, autocompletion, multiple selection, navigating through editor history (including both cursor location and current tab selection), and realtime code error-checking. The editor also has customization settings, including dark and light themes.
In addition to Bixby's modeling language and Expression Language, Bixby Studio includes highlighting and editing features for JavaScript and Markdown.
For a full list of keyboard shortcuts you can use during editing, refer to the Keyboard Shortcuts cheatsheet.
In addition to menus, you can use the Command Palette to find and execute commands, including commands that do not have shortcuts assigned to them. Bring up the command palette with Shift+Ctrl+P or Shift+Cmd+P. You can search for commands in the palette using fuzzy rather than exact matching: commands will be searched for as you type, and "Check for updates..." could be matched with "check", "upd", or "cfu".
Bixby Studio includes context-aware autocompletion of JavaScript keywords and Bixby Language keys, suggesting completions for valid keys at the current point in the file. You can trigger autocompletion with Ctrl+Space at any point.
In addition, in Bixby Language Files, hovering the pointer over a key will display a brief description of the key from the Bixby Language Reference Guide, with a link to more documentation when appropriate.
Hovering over a macro or a macro parameter reference will allow you to jump to the macro definition by clicking on it while holding down Cmd (Mac) or Ctrl (PC). A popup will show all definitions for the macro and let you select one or open the file search pane for the symbol.
When editing a view, the autocompletion feature can also be used to insert code from the Component Gallery. Read the documentation on the Component Gallery in the Creating Bixby Views section for more information.
You can create new files within a capsule by clicking Add to Workspace and Create File, or by using the New File... command (Ctrl+N or Cmd+N) in the File menu. The Create New File dialog box lets you specify the kind of file you're creating and its location. For certain kinds of files, it also provides starter templates to make file creation easier.
Use the File Type drop-down to specify the kind of file you're creating. Bixby Studio will fill in the "Name" field with the suggested directory to use within your capsule. Different items become available depending on the file type you select; for instance, if you select "Training," you can select the device and language, and Bixby Studio will set the filename correctly based on your selections.
For certain kinds of files, such as models and macros, you can select a Template (such as Action, Structure, or a primitive Concept type for models, or Dialog or Layout for macros). When you select a template, Bixby Studio will create the file with appropriate starter content. For instance, if you select a file type of Model, a template of Action, and change the filename to CreateWidget.model.bxb
, you'll get the following template:
action (CreateWidget) {
description (__DESCRIPTION__)
collect {
input (__INPUT_NAME__) {
type (__INPUT_TYPE__)
min (Optional) max (One)
}
}
output (__OUTPUT__)
}
You can open files by clicking them in the file view or by opening them by name. Use Ctrl+P or Cmd+P to find any file in the currently opened capsule with fuzzy matching.
To save the current file, use Ctrl+S or Cmd+S; to save all modified files, use Ctrl+Alt+S or Cmd+Option+S. (You can also use the corresponding commands in the File menu.) Bixby Studio can be set to automatically save as you work, compiling modified files in your capsule in the background; for this feature, select Enable Autosave in the editor's settings.
When you quit Bixby Studio, it saves its current state. When you restart, it will open the same capsules and editor tabs.
Bixby Studio offers multiple methods for navigating between files:
Bixby Studio can display more than one file at a time. You can split the editor view vertically into two columns for a side-by-side display, horizontally into two rows, or into a two-by-two grid to display four files simultaneously.
To choose a different layout, use the View > Layout command to select one of the four available splits: single (the default), rows, columns, or grid.
When the view is split, choose which area to open a file in by clicking on that area to select it. You can move opened files between areas by dragging the file tab from one area to another.
Bixby Studio supports searching for and replacing text references and symbols (such as model names) both within a currently open file and in files across all open capsules.
You can also quickly rename symbols by right-clicking on a symbol and selecting Rename… from the context menu. This will open the search and replace pane in Bixby Studio with the symbol pre-selected; enter the new name into the Replace field.
For more information about searching across capsules, read the Search Within Capsules section.
Bixby Studio can reformat the current file you're working on, or reformat all the *.bxb files in your capsule or a subdirectory of your capsule.
When a warning or error is found in your code, Bixby Studio will highlight it with a squiggly underline. Hovering your mouse pointer over the highlighted text will show an explanation of the problem and, depending on the error or warning, a link to more information.
For certain errors, Bixby Studio can offer to actually fix the error for you. Fixes that Bixby Studio can apply include but are not limited to the following:
Problems that Bixby Studio knows how to fix are highlighted in the editor's gutter with a lightbulb icon, and the hover explanation will include options to apply a fix.
Click on Preview Fix… to see the change that Bixby Studio is suggesting, or Quick Fix… to apply the change without previewing it first. The preview will show up as a diff, highlighting lines to remove and add.
Click Accept to apply Bixby Studio's suggestions one by one, Accept All to accept all of the proposed changes if there are more than one and the changes do not have conflicts, or Cancel to abort.
You can also click the lightbulb icon in the gutter to apply a Quick Fix.
Clicking the Settings icon at the bottom of the activity bar (or using the Preferences… menu command or Ctrl+, or Cmd+, keyboard shortcut) will open Bixby Studio's settings in a new tab in the editor. This lets you configure the following options:
https://bixbydevelopers.com
. Most of the default keyboard shortcuts in Bixby Studio can be customized in the keyboard shortcut editor.
Shortcuts are categorized by window:
To change the shortcut for any function, click on the shortcut in the window to bring up the key combination pop-up.
Type the new keyboard combination you wish to assign as a shortcut. Click the circled X to delete the current combination and the counter-clockwise arrow to restore it to its default. Bixby Studio will warn you if you try to re-assign a shortcut that is already in use; if you go ahead and save the shortcut, it will be removed from its previous function.
You can search for a function in one of two ways:
You can restore all shortcuts to their defaults by clicking the double-headed counter-clockwise arrow () at the top of the shortcut editing window.
In addition to editing, Bixby Studio has tools designed to help you test your capsule. Read about them in their own sections:
If you have any issues with capsule development while in Bixby Studio, you can check the FAQ section of the Bixby Developers Support website.
If your issue is not addressed with one of the FAQ articles, you can send a diagnostics report and file an issue with our support team:
Once the report is sent, a new Zendesk ticket will be created, and an email will be sent to the address you inputted.
If possible, you should send a report while the issue is occurring!
If you've filed the report and are still seeing issues, you can try some of the troubleshooting steps below. We highly encourage that you send a report before trying these steps.