A Community-led Hyper-Hackable Text Editor
Go to file
Nathan Sobo f1f600dbab ⬆️ status-bar
2016-10-10 16:24:55 -06:00
apm Remove .npmrc files 2016-08-02 12:58:25 +02:00
docs Use svgs instead of pngs 2016-10-06 10:41:30 -04:00
dot-atom Replace OS X and Mac OS with macOS 2016-06-18 15:33:08 +02:00
exports Start exporting TextEditor constructor again 2016-10-07 18:17:28 +02:00
keymaps Move emacs alt-*/editor bindings to darwin to avoid menu conflicts on Win/Linux. Addresses some of #4057 2016-10-05 17:38:49 -07:00
menus Always copy item when splitting from the context menu 2016-08-29 17:18:56 -07:00
resources optimize png images using zopflipng 2016-10-08 19:58:16 +08:00
script 🐛 support variable terminal widths 2016-09-27 14:25:45 -04:00
spec Eliminate selector option in tooltip manager API 2016-10-10 14:08:51 -06:00
src Eliminate selector option in tooltip manager API 2016-10-10 14:08:51 -06:00
static 🔥 Remove window load time console output 2016-09-11 17:07:43 +02:00
vendor Allow elements to be passed to toContain matcher 2015-09-18 20:48:52 -06:00
.coffeelintignore Remove mentions of benchmarks from the build, command palette 2015-09-18 20:48:50 -06:00
.gitattributes Optimize bash Windows, force LF line endings 2016-05-16 13:01:10 -07:00
.gitignore Rename cachePath to electronDownloadPath 2016-08-11 12:18:33 +02:00
.pairs Add Daniel to pairs file 2014-06-26 14:25:40 -07:00
.python-version use nodejs v0.10.33 and python 2.7.6 2014-12-08 21:40:31 +02:00
.travis.yml Run main process tests on Linux 2016-09-09 17:58:23 +02:00
appveyor.yml Run main process tests on Windows 2016-09-09 17:58:23 +02:00
atom.sh ATOM_SUPPRESS_ENV_PATCHING > ATOM_DISABLE_SHELLING_OUT_FOR_ENVIRONMENT 2016-09-08 12:24:33 -06:00
CHANGELOG.md 🔥 CHANGELOG.md 2016-01-11 12:17:08 -05:00
circle.yml On Circle, clear screensaver right before running tests 2016-09-29 13:39:51 -07:00
CODE_OF_CONDUCT.md 📝 Update to v1.4 of Contributor Covenent Code of Conduct 2016-05-05 13:37:10 -07:00
coffeelint.json 🔥 Remove newlines_after_classes rule 2015-05-22 20:08:29 -04:00
CONTRIBUTING.md Fix a typo and grammar error in CONTRIBUTING.md 2016-10-04 01:26:26 -07:00
Dockerfile Revert "Revert "Use apm@1.12.2 with Node v4 and npm v3 \o/"" 2016-07-26 10:29:25 -06:00
ISSUE_TEMPLATE.md Correctly link the safe mode section 2016-07-21 14:49:16 +03:00
LICENSE.md Use year of first publication 2016-09-24 13:46:00 -04:00
package.json ⬆️ status-bar 2016-10-10 16:24:55 -06:00
README.md Clarify 64-bit is the only option on Linux 2016-09-29 12:51:48 -07:00

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 Linux (Fedora 21 and under, CentOS, Red Hat)

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 22+

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