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. For 64-bit systems, download AtomSetup-x64.exe.

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

Discussion

Discuss Atom on our forums
Chat about Atom on our Slack team -- instructions for joining

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	Create Feature_request.md	May 22, 2018
apm	Remove package lock files	Jul 5, 2018
benchmarks	Make assignLanguageMode take a language id instead of a language name	Nov 28, 2017
docs	Set RFC 003 status to Accepted	Jul 19, 2018
dot-atom	Fixed links in keymap.cson	Aug 7, 2017
exports	Replace import and export keywords with `require` and `module.exports`	Jan 19, 2018
keymaps	Merge pull request #16342 from davidrsfalcao/master	Jul 25, 2018
menus	Add `Paste without reformatting` command	Oct 23, 2017
resources	Replace app icons	Jun 22, 2018
script	Use computed version when cleaning up nupkg files in Windows build	Jul 20, 2018
spec	Fix repository tests that fail when run in fork of atom/atom	Jul 27, 2018
src	Merge pull request #17744 from atom/fix-17535	Jul 26, 2018
static	Fix white I-beam cursor	Apr 24, 2018
vendor	Teach waitsFor to display filename + line number on timeout	May 17, 2018
.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
.python-version	Revert "⬆️ python@2.7.14"	Sep 28, 2017
.travis.yml	Use Node 8.9.3 in Atom CI builds	Jul 12, 2018
CHANGELOG.md	🔥 CHANGELOG.md	Jan 11, 2016
CODE_OF_CONDUCT.md	Docs: Update HTTP -> HTTPS	Dec 26, 2017
CONTRIBUTING.md	📝 `[ci skip]` must be in the title for Appveyor	Jan 18, 2018
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	Remove FreeBSD build instructions since they don't work	Apr 18, 2018
SUPPORT.md	Change HTTP Links to HTTPS in SUPPORT.md	Nov 13, 2017
appveyor.yml	Use Node 8.9.3 in Atom CI builds	Jul 12, 2018
atom.sh	Use correct executable name for Atom Dev.app in atom.sh	Jul 19, 2018
circle.yml	Use Node 8.9.3 in Atom CI builds	Jul 12, 2018
coffeelint.json	🔥 Remove newlines_after_classes rule	May 23, 2015
package.json	1.31.0-dev	Jul 27, 2018
stylelint.config.js	Fix lint error	Apr 24, 2018

atom/atom

Join GitHub today

Clone with HTTPS

Launching GitHub Desktop...