HTTPS clone URL
Subversion checkout URL
- [archives] Health report data aug 2015
- [archives] Health report data jul 2015
- API Cleanup Ideas
- Areas of Expertise
- Brackets 5 15 2012 Hackathon Notes
- Brackets CodeMirror v4 Migration Guide
- Brackets Coding Conventions
- Brackets Committer Policy
- Brackets Communication Channels
- Brackets Community Testing
- Brackets Developers Guide
- Brackets Development How Tos
- Brackets Extensions
- Brackets in Browser
- Brackets JSDocs Guidelines
- Brackets Node Process: Overview for Developers
- Brackets Screenshots
- Brackets Server Smoke Tests
- Brackets shell command line arguments (proposal)
- Brackets Shortcuts
- Brackets Smoke Tests
- Building Brackets Releases
- Building CEF and Chromium
- Cache Folder
- CEF Debugging
- CEF3 vs. Chromium Content Shell
- Code Hinting API Investigation
- Code Hinting Functional Specifications
- CodeMirror v4 Integration
- Collecting End of Sprint Stats
- Command Line Arguments
- Commands, Menus and Shortcuts Implementation
- Contributing to Brackets
- Crash Logs
- Creating and Posting Brackets Hotfix Releases
- Creating Themes
- CSS Context API implementation spec
- CSSUtils, HTMLUtils
- Customize Your Code Font
- Debugging Brackets
- Debugging Test Windows in Unit Tests
- Dependency Analysis
- Extension API Research
- Extension Dependencies
- Extension Experiments
- Extension Icon Guidelines
- Extension Locations
- Extension Manager Workflows
- Extension package format
- Extension Package Manager Research
- Extension Registry Architecture
- Extension Registry Help
- Extension Repository Server API
- Extension Robustness
- Extension Testing Recommendations for SplitView
- Extension UI Guidelines
- Extension Unit Tests
- File System
- File System API Migration
- File System Implementations
- File system watcher requirements
- Generating Brackets API Docs
- Google Summer of Code 2013 Project Ideas
- Grunt Setup
- Health Data
- Health Report Data
- How to Hack on Brackets
- How to Report an Issue
- How to Use Brackets
- How to write extensions
- Inline Color Editor
- Issue Clusters 1.0 Milestone
- Keyboard Shortcuts
- Language Support
- Language Support Changes
- Large Projects
- Linux Development for Contributors
- Linux Version
- Live Development: lifecycle research and future directions
- Live Preview API
- Live Preview Multibrowser
- Live Preview Overview
- Live Preview URL Mapping
- Localization Tests
- Migrating or Syncing Brackets Configuration
- New Code Hinting API Proposal
- Notes on CodeMirror
- Performance Profiling
- Performance Testing
- Performance Tests Procedure
- Preferences Code Hints for Developers
- Preferences Overview
- Preferences System
- Preview Images Research old drafts
- Preview Images Spec
- Programmatically Opening Files in Brackets
- Pull Request Checklist
- Pull Request Process
- Pull Request Review Checklist
- Related Documents
- Release Notes
- Release Notes: 0.40
- Release Notes: 0.41
- Release Notes: 0.42
- Release Notes: 0.43
- Release Notes: 0.44
- Release Notes: 1.0
- Release Notes: 1.1
- Release Notes: 1.2
- Release Notes: 1.3
- Release Notes: 1.4
- Release Notes: 1.5
- Release notes: sprint 10
- Release notes: Sprint 11
- Release notes: Sprint 12
- Release notes: Sprint 13
- Release notes: Sprint 14
- Release Notes: Sprint 15
- Release Notes: Sprint 16
- Release Notes: Sprint 17
- Release Notes: Sprint 18
- Release Notes: Sprint 19
- Release Notes: Sprint 20
- Release Notes: Sprint 21
- Release Notes: Sprint 22
- Release notes: sprint 23
- Release Notes: Sprint 24
- Release Notes: Sprint 25
- Release Notes: Sprint 26
- Release Notes: Sprint 27
- Release Notes: Sprint 28
- Release Notes: Sprint 29
- Release Notes: Sprint 30
- Release Notes: Sprint 31
- Release Notes: Sprint 32
- Release Notes: Sprint 33
- Release Notes: Sprint 34
- Release Notes: Sprint 34.1
- Release Notes: Sprint 35
- Release Notes: Sprint 36
- Release Notes: Sprint 37
- Release Notes: Sprint 38
- Release Notes: Sprint 39
- Release Notes: Sprint 7
- Release Notes: Sprint 8
- Release notes: sprint 9
- Research: CodeMirror document linking
- Research: Design Alternatives for Split View
- Research: Drag and Drop from Finder
- Research: Extension Management
- Research: Find Replace
- Research: HTML DOM Data Structure
- Research: jQuery 2.0 Upgrade
- Research: Multiple cursors and selections
- Research: Node.JS Integration
- RESEARCH: Preference Format
- Research: Simplified LESS Support
- Research: Topcoat
- Running Brackets Unit Tests
- Running Jasmine tests from the command line for Linux
- Simple "Hello World" extension
- Spec: Native Installers
- SplitView Architecture Notes
- SplitView Architecture Tasking
- SplitView Extension Migration Guide
- SplitView Proposed Architecture
- Suggest a Feature
- Tech Summit Product Fair Brackets
- Testing Brackets
- Testing Pritam's Linux build
- Translations community assistance
- Typing Speed Mini Spec
- Upgrading CodeMirror from Upstream
- User Key Bindings
- Using File Filters
- Working with fsevents_win.node
- Working with Multiple Selections
- ZZZ (OBSOLETE) CodeMirror v3 integration
- افزونه ها در براکتس به چه معناست؟
- براکتس چیست؟
Clone this wiki locally
Brackets not working for you? Maybe the following will help:
- Having trouble installing Brackets?
- Brackets not launching?
- Having trouble with Live Preview?
- Is Brackets running slowly?
- Having trouble installing extensions?
- Other: Brackets Is Acting Weird
Other information that may help you:
- Mac OSX 10.6.8 or newer
- Windows Vista, 7, or 8/8.1 (x32 and x64) (installer requires administrator access)
- Linux Ubuntu 12.04 or newer (x32 and x64)
- Debian Linux 8 or newer (for Debian 7 compatibility see issue #4816)
- At least 2 GB of RAM for Live Development
Some Windows Vista computers will block installers downloaded from the Internet, so nothing at all happens when you try to run the installer. To work around this: right-click the installer file, choose Properties, and click the Unblock button.
This can happen on some Windows machines. To work around this, try executing the installer from an elevated command prompt:
- Open an elevated command prompt using one of the techniques on this page: http://www.sevenforums.com/tutorials/783-elevated-command-prompt.html
cdto the folder containing the installer.
- Run the installer using msiexec, e.g.:
msiexec /i "brackets-sprint-xx-WIN.msi"(where "xx" is the sprint number)
There may be a long delay at the start of the installation process as Windows checks, prepares, and displays the UAC prompt. During this delay, you will see the "Installing Brackets" - "Please wait while Brackets is installed" page of the installer but with 0% progress. The length of this delay may vary, depending on your individual system.
If you had previously used Brackets, your cache may have information that is conflicting with the most recent version. Find your cache folder and delete the cache. Warning: this will reset all of your Brackets preferences.
If Brackets won't launch, check the permissions of the main executable files (e.g. using
ls -l). On Mac:
To fix permissions, use a command like
chmod +x bin/mac/Brackets.app/Contents/MacOS/Brackets.
Next, try running Brackets from the command line. Open up a Terminal (or Command Prompt in Windows), navigate to the executable, and run Brackets. (On Mac, type
open bin/mac/Brackets.app.). Did an error appear? If so, file an issue or find us on IRC or the mailing list and we'll try to figure it out.
This may happen when trying to run 32-bit Brackets on 64-bit Linux. Please verify that you've downloaded the correct build.
This occurs when trying to run Brackets on Debian 7 (Wheezy). Brackets currently requires Debian 8 (Jessie). (But for some potential workarounds, see issue #4816).
Currently, Live Development works differently for different types of files:
- For CSS, all changes are applied in the browser immediately as you type, without reloading the page.
- CSS preprocessors are not currently supported - they are treated as "other file types" below
- For HTML, most changes are applied in the browser immediately as you type. Updating pauses when the page is syntactically invalid (e.g. after you type '<' for a new tag but before you type the closing '>'). The line number and Live Preview icon turn red, and the tooltip says "not updating due to syntax error". Brackets will resume pushing changes to the browser when syntax becomes valid again.
- HTML live updating is disabled if you've specified a custom server URL in Project Settings.
See How to Use Brackets for more details.
You can use
File > Open to open any file on your computer, but Brackets' definition of a project are the files in the folder opened using
File > Open Folder.... Some (but not all) Live Development features require a node server, which means being in the current project, so make sure the files that you want to use with Live Development are in the current project.
There is a known issue (which is fixed in release 0.43) that if HTML file is in project tree (i.e. not in Working Set), then element highlighting stops working after switching to a CSS (or other?) file and then back to the HTML file. The workaround is to double-click HTML file so it's added to the Working Set.
Updating CSS in Live Preview does not seem to work if <link> has type="text/css", so try removing it.
- Bug #7935: Live CSS does not update if page contains an iframe (including injected iframes such as ads or social media buttons).
If you are using your own local server, HTML will not update live (see documentation).
Brackets pauses sending updates to browser when it detects an HTML Syntax Error. In this case, it should color the line number in red (but this can be scrolled out of view) so scroll through entire page to verify that there are no highlighted line numbers.
The Live Preview lightning bolt icon should be also colored red and have a tooltip of "Live Preview (not updating due to syntax error)" in this case, but there's a known bug being tracked as issue #7126 where this sometimes doesn't happen. See issue #7126 for an illustrated description including the line number and icon coloring.
Other known issues:
- Bug #5338: Live Preview can never update if initially launched with syntax error - after fixing a syntax error, try stopping and restarting Live Preview.
- If you specified a "Base URL," make sure your local server is already running - Brackets will not start it for you.
- Make sure you are not running firewall, network security, or antivirus software that is blocking the connection (try disabling it temporarily to check)
- Make sure you haven't modified your hosts file to remap localhost or 127.0.0.1
- Try shutting down background apps in Chrome. In Chrome, go to Settings > Advanced Settings and then uncheck the "Continue running background apps when Google Chrome is closed" setting.
To use a local server, you need to specify a Base URL in the
File > Project Settings... dialog (see How to Use Brackets for details).
If you're using a local server and are seeing these messages such as "Oops! Google Chrome could not connect to localhost:[port]" (in Chrome) or "Unable to load Live Development page" (in Brackets), verify that your local server has been started.
As noted above, live HTML updating is disabled when using your own custom local server.
Brackets is verified with the current stable Chrome. If chrome is not configured to automatically update to the latest version, then be sure to check for updates. It usually works with current beta, dev, or canary versions of Chrome, but if you are having a problem switch back to stable Chrome before opening an issue.
If you get the error
An error occurred when launching the browser. (error 2) when doing Live Development, installing Chrome for multiple user accounts may solve the issue.
If Brackets cannot launch the Chrome browser on your Windows system, check the Registry setting here:
- HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\chrome.exe
This is the file path that Brackets uses to launch Chrome. If this is not correct, then try reinstalling the Chrome browser at this location.
When uninstalling Google Chrome on Windows, some users have reported problems with Registry settings that are not removed. If uninstalling and reinstalling Chrome still does not fix problem, try deleting Registry settings in the following locations before re-installling:
Warning: Editing the Windows Registry can easily cause problems with your system, so edit it manually at your own risk. Another option is to use a tool such as Revo Uninstaller to uninstall Chrome.
Try leaving an extra blank tab open in the instance of Chrome that is launched by Live Preview. This prevents Chrome from shutting down and restarting between each file, so Live Preview will launch faster; this may reduce some intermittent errors.
If you keep getting errors when trying to launch Chrome, or if you keep getting prompted to restart Chrome, try rebooting your machine. Rebooting has resolved many odd issues with Live Development.
On Windows, you may run into issues starting Live Preview if you installed Chrome after installing Brackets. In that case, re-installing Brackets should fix the problem.
This section describes known issues and work-arounds specific to Multi-Browser Live Preview.
In order to make it work with Internet Explorer 11, disable all the options that IE uses to include sites in the local intranet (unchecked all the items at
Internet Options > Security > Local Intranet > Sites). This will allow Live Preview to establish connection to the editor.
Debug > Reload Without Extensions to quickly see if the problem is being caused by an extension.
Choose Help > Show Extensions Folder, go up one level to the parent folder, and remove the 'live-dev-profile' folder. This will not affect any Brackets settings, but may clear up Live Preview problems.
This section discusses some of the features that can affect performance and possible solutions.
On Mac OS 10.9 (Mavericks), Activity Monitor will say the Brackets Helper process is "Not Responding" even when it is working normally (bug #5794). You can safely ignore this unless Brackets is actually failing to respond when you click or type text.
Most Brackets extensions don't impact performance, but some may slow down Brackets (for example Show Whitespace can cause slow typing performance). Try
Debug > Reload Without Extensions to quickly check if the problem is being caused by an extension.
Using "Find in Files" and "JS Code Hinting" can be slow because of the number of files that are searched. You can try installing the experimental Exclude Folders extension to limit the number of folders that are searched.
This feature can negatively impact scrolling performance, so try turning it off with: View > Highlight Active Line
If your computer needs to use a proxy to get to the web, you'll need to configure Brackets to use it. Use Debug > Open Preferences File and then add a
"proxy" property to the JSON file. The value should be the URL of your proxy server. Read more about configuring Preferences.
You can also install extensions manually:
- Find the extension in the online Extension Registry
- Click the name of the extension to download it as a zip file
- In Brackets, open Extension Manager
- Drag the zip file onto the "Drag .zip here" zone in the lower left of the window
Make sure your
localhost address resolves correctly, normally it should resolve to
127.0.0.1. You can do it by executing
ping localhost from the command line. If it fails, add the following entry to your
hosts file is
/etc/hosts on Mac and Linux. On Windows it's located in
Your preferences may have become corrupt. Follow these instructions to delete your preferences and cache folder: https://github.com/adobe/brackets/wiki/Cache-Folder#resetting-cache--preferences.
Debug > Reload Without Extensions to quickly check whether the problem is being caused by an extension. To re-enable your extensions, just quit and relaunch Brackets, or choose
Debug > Reload With Extensions.
If this fixes the problem, you can identify the problematic extension by re-enabling extensions one-by-one:
- Start with all extensions disabled: Choose Help > Show Extensions Folder and move all extensions from the "user" folder into the "disabled" folder (this is similar to what Debug > Reload Without Extensions does).
- Move one extension back into the "user" folder, then quit and re-launch Brackets.
- Check if the problem has come back. If not, repeat step 2.
Binary Reduction: The previous method tests one extension at a time. This works for a small number of extensions but is slow if you have a lot of extensions. Instead, you can test half of your remaining extensions at a time. You're done when you only have 1 extension being tested. As above, you have to quit and re-launch Brackets between each test.
Note: to make it easier to manage which extensions you have tested, create a third folder named "disabled-verified" for extensions which have been verified to not cause the problem.
- (same as above)
- Move half (doesn't need to be exact) of your extensions from the "disabled" folder to the "user" folder.
- If you do not see the problem, move all of the extensions in the "user" folder to the "disabled-verified" folder. Repeat step 2.
- Otherwise you do see problem, so move all extensions from "disabled" folder to "disabled-verified" folder. Then move half of your extensions from "user" folder back to "disabled" folder. Repeat step 3.
Once you have identified the problematic extension, move all extensions from "disabled-verified" folder back to "user" folder.
Alternative: Select Debug > Show Developer Tools and look at the console. If an error message is present, it may have a link to the code that is failing, which in turn may point out a specific extension.
Debug > Show Developer Tools to open an instance of the Developer Tools for Brackets. If you've used the Developer Tools in Chrome this will look familiar. Check the Console tab for errors.
There's a known issue with the Webroot Identity Shield software blocking Paste in Brackets. If you're running Webroot, try the workarounds on their support page. (Fully up-to-date Webroot should no longer treat Brackets as "unknown"; try reinstalling to update your copy).
Let's say you want ".inc" files to be treated like ".php" files. To do this, open an ".inc" file and click the dropdown in the lower-right (for unrecognized files it will say "Text"). Choose the desired file type (e.g. "PHP"), then open the dropdown again and choose "Set as Default for .inc Files."
You can also edit the
language.fileExtensions preference directly.
In Brackets release 37, there's a known issue in which an empty preferences file could cause Brackets to display an error message on startup. If you see this error, Brackets will still start and will open the (empty) preferences file into the editor. Follow these steps, and you'll be all set:
- Type this into the editor:
- Quit and restart Brackets
Starting with Brackets 36, we've added a bunch of preferences that let you tailor how Brackets works for you. Read more on the How To Use Brackets page.
The bug described here is fixed in Brackets 38.