/atom

:atom: The hackable text editor
  1. JavaScript 92.6%
  2. CoffeeScript 6.2%
  3. CSS 0.9%
  4. Shell 0.2%
  5. Batchfile 0.1%
  6. HTML 0.0%
JavaScript CoffeeScript CSS Shell Batchfile HTML
Switch branches/tags
v1.29.0-beta2 v1.29.0-beta1 v1.29.0-beta0 v1.28.2 v1.28.1 v1.28.0 v1.28.0-beta3 v1.28.0-beta2 v1.28.0-beta1 v1.28.0-beta0 v1.27.2 v1.27.1 v1.27.0 v1.27.0-beta1 v1.27.0-beta0 v1.26.1 v1.26.0 v1.26.0-beta2 v1.26.0-beta1 v1.26.0-beta0 v1.25.1 v1.25.0 v1.25.0-beta3 v1.25.0-beta2 v1.25.0-beta1 v1.25.0-beta0 v1.24.1 v1.24.0 v1.24.0-beta3 v1.24.0-beta2 v1.24.0-beta1 v1.24.0-beta0 v1.23.3 v1.23.2 v1.23.1 v1.23.0 v1.23.0-beta1 v1.23.0-beta0 v1.22.1 v1.22.0 v1.22.0-beta2 v1.22.0-beta1 v1.22.0-beta0 v1.21.2 v1.21.1 v1.21.0 v1.21.0-beta2 v1.21.0-beta1 v1.21.0-beta0 v1.20.1 v1.20.0 v1.20.0-beta7 v1.20.0-beta6 v1.20.0-beta5 v1.20.0-beta4 v1.20.0-beta3 v1.20.0-beta2 v1.20.0-beta1 v1.20.0-beta0 v1.19.7 v1.19.6 v1.19.5 v1.19.4 v1.19.3 v1.19.2 v1.19.1 v1.19.0 v1.19.0-beta7 v1.19.0-beta6 v1.19.0-beta5 v1.19.0-beta4 v1.19.0-beta3 v1.19.0-beta2 v1.19.0-beta1 v1.19.0-beta0 v1.18.0 v1.18.0-beta3 v1.18.0-beta2 v1.18.0-beta1 v1.18.0-beta0 v1.17.2 v1.17.1 v1.17.0 v1.17.0-beta5 v1.17.0-beta4 v1.17.0-beta3 v1.17.0-beta2 v1.17.0-beta1 v1.17.0-beta0 v1.16.0 v1.16.0-beta0 v1.15.0 v1.15.0-beta4 v1.15.0-beta3 v1.15.0-beta2 v1.15.0-beta1 v1.15.0-beta0 v1.14.4 v1.14.3 v1.14.2
Nothing to show
Find file
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Download ZIP

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching Xcode...

If nothing happens, download Xcode and try again.

Launching Visual Studio...

If nothing happens, download the GitHub extension for Visual Studio and try again.

Pull request Compare This branch is 19 commits ahead, 6464 commits behind master.
@as-cii
as-cii Create selections just-in-time before querying `TextEditor`
Latest commit f475afe May 4, 2016
Permalink
Failed to load latest commit information.
apm ⬆️ apm@1.10.0 May 2, 2016
build Merge branch 'master' into ns-switch-to-display-layers Apr 30, 2016
docs Win32 build now installs to localappdata. Admin elevation now smart. Apr 22, 2016
dot-atom 📝 Update CSON documentation link in snippets.cson Apr 22, 2016
exports Merge branch 'master' into dh-async-repo Nov 30, 2015
keymaps Add Ctrl+F4 keybinding for Linux Apr 21, 2016
menus Copy active item when splitting from TextEditor context menu Apr 16, 2016
resources Ensure atom.cmd with --wait returns exit code of 0 for git commit usage Apr 25, 2016
script 🐧 Add "mktar" gulp task to create an Linux binary archive Apr 5, 2016
spec Stop using deprecated APIs in text-editor-component-spec.js May 5, 2016
src Create selections just-in-time before querying `TextEditor` May 5, 2016
static Fixed positioning for overlay Apr 10, 2016
vendor Allow elements to be passed to toContain matcher Sep 19, 2015
.coffeelintignore Remove mentions of benchmarks from the build, command palette Sep 19, 2015
.gitattributes Add paths that work on Git 1.7 Jun 11, 2014
.gitignore add out/ to gitignore Mar 1, 2016
.npmrc Try just setting the target? Dec 28, 2015
.pairs Add Daniel to pairs file Jun 26, 2014
.python-version use nodejs v0.10.33 and python 2.7.6 Dec 8, 2014
.travis.yml Cache other node_modules folders on Travis Feb 5, 2016
CHANGELOG.md 🔥 CHANGELOG.md Jan 11, 2016
CODE_OF_CONDUCT.md add CODE_OF_CONDUCT.md with atom@github.com email address Dec 2, 2015
CONTRIBUTING.md 📝 Fix dead atom.io/docs links Apr 8, 2016
Dockerfile Only log install errors Mar 26, 2015
ISSUE_TEMPLATE.md Correctly link the debugging guide Apr 11, 2016
LICENSE.md Update license year to 2016 Jan 16, 2016
README.md Add Linux archive installation and build instructions Apr 5, 2016
appveyor.yml Add name for artifact Feb 4, 2016
atom.sh Make cli atom --wait work on Cygwin Mar 7, 2016
circle.yml build only my experimental branch on circle Feb 26, 2016
coffeelint.json 🔥 Remove newlines_after_classes rule May 23, 2015
package.json ⬆️ language-xml@0.34.6 May 5, 2016

README.md

Atom

Build Status Build status Dependency Status Join the Atom Community on Slack

Atom is a hackable text editor for the 21st century, built on Electron, and based on everything we love about our favorite editors. We designed it to be deeply customizable, but still approachable using the default configuration.

Visit atom.io to learn more or visit the Atom forum.

Follow @AtomEditor on Twitter for important announcements.

This project adheres to the Contributor Covenant code of conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to atom@github.com.

Documentation

If you want to read about using Atom or developing packages in Atom, the Atom Flight Manual is free and available online, along with ePub, PDF and mobi versions. You can find the source to the manual in atom/docs.

The API reference for developing packages is also documented on Atom.io.

Installing

Prerequisites

OS X

Download the latest Atom release.

Atom will automatically update when a new release is available.

Windows

Download the latest AtomSetup.exe installer.

Atom will automatically update when a new release is available.

You can also download an atom-windows.zip file from the releases page. The .zip version will not automatically update.

Using chocolatey? Run cinst Atom to install the latest version of Atom.

Debian Linux (Ubuntu)

Currently only a 64-bit version is available.

  1. Download atom-amd64.deb from the Atom releases page.
  2. Run sudo dpkg --install atom-amd64.deb on the downloaded package.
  3. Launch Atom using the installed atom command.

The Linux version does not currently automatically update so you will need to repeat these steps to upgrade to future releases.

Red Hat Linux (Fedora 21 and under, CentOS, Red Hat)

Currently only a 64-bit version is available.

  1. Download atom.x86_64.rpm from the Atom releases page.
  2. Run sudo yum localinstall atom.x86_64.rpm on the downloaded package.
  3. Launch Atom using the installed atom command.

The Linux version does not currently automatically update so you will need to repeat these steps to upgrade to future releases.

Fedora 22+

Currently only a 64-bit version is available.

  1. Download atom.x86_64.rpm from the Atom releases page.
  2. Run sudo dnf install ./atom.x86_64.rpm on the downloaded package.
  3. Launch Atom using the installed atom command.

The Linux version does not currently automatically update so you will need to repeat these steps to upgrade to future releases.

Archive extraction

An archive is available for people who don't want to install atom as root.

This version enables you to install multiple Atom versions in parallel. It has been built on Ubuntu 64-bit, but should be compatible with other Linux distributions.

  1. Install dependencies (on Ubuntu): sudo apt install git gconf2 gconf-service libgtk2.0-0 libudev1 libgcrypt20 libnotify4 libxtst6 libnss3 python gvfs-bin xdg-utils libcap2
  2. Download atom-amd64.tar.gz from the Atom releases page.
  3. Run tar xf atom-amd64.tar.gz in the directory where you want to extract the Atom folder.
  4. Launch Atom using the installed atom command from the newly extracted directory.

The Linux version does not currently automatically update so you will need to repeat these steps to upgrade to future releases.

Building