/atom

:atom: The hackable text editor
  1. JavaScript 89.0%
  2. CoffeeScript 9.9%
  3. Other 1.1%
JavaScript CoffeeScript Other
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Download ZIP
Find file
Switch branches/tags
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 v1.14.1 v1.14.0 v1.14.0-beta4 v1.14.0-beta3 v1.14.0-beta2 v1.14.0-beta1 v1.14.0-beta0 v1.13.1 v1.13.0 v1.13.0-beta10 v1.13.0-beta9 v1.13.0-beta8 v1.13.0-beta7 v1.13.0-beta6 v1.13.0-beta5 v1.13.0-beta4 v1.13.0-beta3 v1.13.0-beta2 v1.13.0-beta1 v1.13.0-beta0 v1.12.9 v1.12.8 v1.12.7 v1.12.6 v1.12.5 v1.12.4 v1.12.3 v1.12.2
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
apm â¬†ï¸ apm Nov 9, 2016
docs Merge pull request #13421 from philwyett-hemi/rpm_dev Dec 21, 2016
dot-atom Replace OS X and Mac OS with macOS Jun 18, 2016
exports Start exporting `TextEditor` constructor again Oct 7, 2016
keymaps Move emacs alt-*/editor bindings to darwin to avoid menu conflicts on… Oct 6, 2016
menus Always copy item when splitting from the context menu Aug 30, 2016
resources Merge pull request #13421 from philwyett-hemi/rpm_dev Dec 21, 2016
script Switch 1.13 over to new signing key Jan 3, 2017
spec Add precondition test Dec 8, 2016
src Activate packages immediately if hook had already been triggered Dec 8, 2016
static Merge pull request #13288 from atom/as-fix-profile-startup Nov 22, 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 Optimize bash Windows, force LF line endings May 16, 2016
.gitignore Rename cachePath to electronDownloadPath Aug 11, 2016
.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 Merge pull request #12985 from atom/ns-fix-keymap-ctrl-issue Oct 25, 2016
CHANGELOG.md 🔥 CHANGELOG.md Jan 11, 2016
CODE_OF_CONDUCT.md 📠Update to v1.4 of Contributor Covenent Code of Conduct May 5, 2016
CONTRIBUTING.md Fix a typo and grammar error in CONTRIBUTING.md Oct 4, 2016
Dockerfile Revert "Revert "Use apm@1.12.2 with Node v4 and npm v3 \o/"" Jul 26, 2016
ISSUE_TEMPLATE.md Correctly link the safe mode section Jul 21, 2016
LICENSE.md
README.md Merge pull request #13421 from philwyett-hemi/rpm_dev Dec 21, 2016
appveyor.yml Run main process tests on Windows Sep 9, 2016
atom.sh ATOM_SUPPRESS_ENV_PATCHING > ATOM_DISABLE_SHELLING_OUT_FOR_ENVIRONMENT Sep 8, 2016
circle.yml On Circle, clear screensaver right before running tests Sep 29, 2016
coffeelint.json 🔥 Remove newlines_after_classes rule May 23, 2015
package.json 1.12.8 Dec 21, 2016

README.md

Atom

macOS Build Status Linux Build Status Windows 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. You can find the source to the manual in atom/flight-manual.atom.io.

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

Installing

Prerequisites

macOS

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)

Atom is only available for 64-bit Linux systems.

  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 Enterprise Linux (RHEL) / CentOS

Atom is only available for 64-bit Linux systems.

  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

Atom is only available for 64-bit Linux systems.

  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