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	Add `Paste without reformatting` command	Oct 23, 2017
menus	Add `Paste without reformatting` command	Oct 23, 2017
resources	🍎 Fix faded app icons on macOS 10.13	Sep 27, 2017
script	Don't snapshot lodash.isequal because it builds an ArrayBuffer on eval	Dec 21, 2017
spec	Merge pull request #16282 from atom/io-electron-1.7	Jan 3, 2018
src	Merge pull request #16282 from atom/io-electron-1.7	Jan 3, 2018
static	Increase dock hover affordance	Dec 20, 2017
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	Repair Links to Pull Requests in CONTRIBUTING.md	Nov 18, 2017
Dockerfile	Update builds to include libsecret	Apr 20, 2017
ISSUE_TEMPLATE.md	Docs: Update HTTP -> HTTPS	Dec 26, 2017
LICENSE.md	Updated date range to include 2017	Jan 2, 2017
PULL_REQUEST_TEMPLATE.md	📝 Update issue and PR templates	Dec 26, 2016
README.md	Docs: Update HTTP -> HTTPS	Dec 26, 2017
SUPPORT.md	Change HTTP Links to HTTPS in SUPPORT.md	Nov 13, 2017
appveyor.yml	Exclude x86/TEST from build matrix on appveyor for speed	Aug 17, 2017
atom.sh	Don't enable electron logging by default	Aug 3, 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-csharp	Jan 4, 2018

atom/atom

Join GitHub today

Clone with HTTPS

README.md