A Community-led Hyper-Hackable Text Editor
Go to file
2016-05-19 14:49:38 -07:00
apm ⬆️ apm@1.10.0 2016-05-01 22:16:36 -07:00
build Enable Windows codesigning via Squirrel for MSI 2016-05-19 14:49:16 -07:00
docs Win32 build now installs to localappdata. Admin elevation now smart. 2016-04-22 12:07:19 -07:00
dot-atom 📝 Update CSON documentation link in snippets.cson 2016-04-22 09:30:45 -05:00
exports Merge branch 'master' into dh-async-repo 2015-11-30 11:44:20 -05: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 Handle spaces in relative path to atom.sh on bash/win, fixes #11732 2016-05-10 16:32:13 -07:00
script 🐧 Add "mktar" gulp task to create an Linux binary archive 2016-04-05 16:33:47 +02:00
spec Merge pull request #11765 from atom/as-fix-presenter-uncaught-exception 2016-05-16 14:21:43 +02:00
src Merge pull request #11758 from stanfieldr/master 2016-05-16 13:07:51 -07:00
static Fixed positioning for overlay 2016-04-09 18:42:18 -07: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 Add paths that work on Git 1.7 2014-06-11 13:24:54 -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 Update link text to match URL 2016-05-15 13:08:27 +01: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 ⬆️ settings-view@0.237.0 2016-05-16 11:36:35 -07:00
README.md Add Linux archive installation and build instructions 2016-04-05 16:34:57 +02:00

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