GitHub

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

Git

macOS

Download the latest Atom release.

Atom will automatically update when a new release is available.

Windows

Download the latest Atom installer. AtomSetup.exe is 32-bit, AtomSetup-x64.exe for 64-bit systems.

Atom will automatically update when a new release is available.

You can also download atom-windows.zip (32-bit) or atom-x64-windows.zip (64-bit) from the releases page. The .zip version will not automatically update.

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

Linux

Atom is only available for 64-bit Linux systems.

Configure your distribution's package manager to install and update Atom by following the Linux installation instructions in the Flight Manual. You will also find instructions on how to install Atom's official Linux packages without using a package repository, though you will not get automatic updates after installing Atom this way.

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.

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
Download atom-amd64.tar.gz from the Atom releases page.
Run tar xf atom-amd64.tar.gz in the directory where you want to extract the Atom folder.
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

License

MIT

When using the Atom or other GitHub logos, be sure to follow the GitHub logo guidelines.

Failed to load latest commit information.
.github	Add indentation to force YAML to leave certain lines the way they are	Oct 7, 2017
apm	⬆️ apm@1.19.0	Jan 3, 2018
benchmarks	Make assignLanguageMode take a language id instead of a language name	Nov 28, 2017
docs	Update /docs/README.md to direct people to the new locations of the d…	Jan 1, 2018
dot-atom	Fixed links in keymap.cson	Aug 7, 2017
exports	Use module.exports to not break Joanna horribly	Aug 1, 2017
keymaps	Tweak syntax selection key bindings	Dec 27, 2017
menus	Add `Paste without reformatting` command	Oct 23, 2017
resources	🍎 Fix faded app icons on macOS 10.13	Sep 27, 2017
script	Link spec for finding icon dir in install script	Jan 13, 2018
spec	Merge pull request #16546 from atom/as-allow-clicking-scrollbar-with-…	Jan 15, 2018
src	Merge pull request #16546 from atom/as-allow-clicking-scrollbar-with-…	Jan 15, 2018
static	Programmatically detect when mouse approaches the edge of a dock	Jan 12, 2018
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	Revert "⬆️ python@2.7.14"	Sep 28, 2017
.travis.yml	Try alternate way of getting right python	Dec 13, 2017
CHANGELOG.md	🔥 CHANGELOG.md	Jan 11, 2016
CODE_OF_CONDUCT.md	Docs: Update HTTP -> HTTPS	Dec 26, 2017
CONTRIBUTING.md	Typos on #83 #84	Dec 7, 2017
Dockerfile	Update builds to include libsecret	Apr 20, 2017
ISSUE_TEMPLATE.md	Docs: Update HTTP -> HTTPS	Dec 26, 2017
LICENSE.md	Update license year	Dec 31, 2017
PULL_REQUEST_TEMPLATE.md	Add "Verification Process" section to pull request template	Jan 3, 2018
README.md	Docs: Update HTTP -> HTTPS	Dec 26, 2017
SUPPORT.md	Change HTTP Links to HTTPS in SUPPORT.md	Nov 13, 2017
appveyor.yml	Be kind to build queue: Skip installer for non-release/non-master branch	Jan 11, 2018
atom.sh	Add dev channel atom.sh	Aug 30, 2017
circle.yml	Use TEST_JUNIT_XML_ROOT instead of the CircleCI-specific root	Aug 1, 2017
coffeelint.json	🔥 Remove newlines_after_classes rule	May 23, 2015
package.json	⬆️ language-c	Jan 13, 2018

atom/atom

Join GitHub today

Clone with HTTPS

README.md