A Community-led Hyper-Hackable Text Editor
Go to file
2016-07-14 11:03:45 -07:00
apm ⬆️ apm@1.10.0 2016-05-01 22:16:36 -07:00
build Merge pull request #12037 from atom/publish-win32-assets-from-appveyor 2016-07-03 07:58:18 -07:00
docs update nodejs installation instructions link for Fedora/Centos/RHEL 2016-07-04 10:47:31 +02:00
dot-atom Replace OS X and Mac OS with macOS 2016-06-18 15:33:08 +02:00
exports Remove GitRepositoryAsync 2016-07-13 14:03:29 -07:00
keymaps Add Ctrl+F4 keybinding for Linux 2016-04-21 13:36:50 -07:00
menus Copy active item when splitting from TextEditor context menu 2016-04-16 11:00:46 -07:00
resources Ensure Cygwin + Msys compatibility on Windows 2016-05-24 11:14:24 -07:00
script Fix quoting in clean script caused by accidental undo 2016-06-08 21:08:11 -07:00
spec Remove GitRepositoryAsync 2016-07-13 14:03:29 -07:00
src Remove usage of repository.async in Workspace 2016-07-13 15:41:10 -07:00
static Introduce @use-custom-controls variable 2016-07-12 15:36:50 +09: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 add out/ to gitignore 2016-03-01 15:06:33 -08:00
.npmrc Try just setting the target? 2015-12-28 16:50:00 -05: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 Cache other node_modules folders on Travis 2016-02-04 16:35:49 -08:00
appveyor.yml Add MSI output for AppVeyor artifact list 2016-05-19 14:49:38 -07:00
atom.sh Make cli atom --wait work on Cygwin 2016-03-07 14:01:05 -08:00
CHANGELOG.md 🔥 CHANGELOG.md 2016-01-11 12:17:08 -05:00
circle.yml build only my experimental branch on circle 2016-02-26 14:11:45 -08: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 OSX -> macOS 2016-06-20 11:29:10 +02:00
Dockerfile Only log install errors 2015-03-26 10:38:58 -07:00
ISSUE_TEMPLATE.md Correctly link the debugging guide 2016-04-11 16:03:11 -04:00
LICENSE.md Update license year to 2016 2016-01-16 13:21:11 +05:30
package.json Upgrade to minor releases of packages 2016-07-14 11:03:45 -07:00
README.md mac-os -> macos 2016-06-18 16:41:35 +02:00

Atom

macOS 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)

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