2014-05-05 02:42:45 +04:00
![Atom ](https://cloud.githubusercontent.com/assets/72919/2874231/3af1db48-d3dd-11e3-98dc-6066f8bc766f.png )
2012-08-31 21:43:21 +04:00
2015-01-29 05:17:29 +03:00
Atom is a hackable text editor for the 21st century, built on [atom-shell ](https://github.com/atom/atom-shell ), and based on everything we love about our favorite editors. We designed it to be deeply customizable, but still approachable using the default configuration.
2014-05-06 00:04:22 +04:00
2014-12-07 05:30:18 +03:00
Visit [atom.io ](https://atom.io ) to learn more or visit the [Atom forum ](https://discuss.atom.io ).
2012-08-31 21:43:21 +04:00
2014-10-22 23:59:57 +04:00
Visit [issue #3684 ](https://github.com/atom/atom/issues/3684 ) to learn more
about the Atom 1.0 roadmap.
2013-06-10 20:00:08 +04:00
## Installing
2014-07-09 22:14:21 +04:00
### Mac OS X
2013-11-27 22:59:11 +04:00
Download the latest [Atom release ](https://github.com/atom/atom/releases/latest ).
2013-06-10 20:00:08 +04:00
2013-11-27 22:59:11 +04:00
Atom will automatically update when a new release is available.
2013-06-10 20:00:08 +04:00
2014-07-09 22:14:21 +04:00
### Windows
2014-12-10 03:34:16 +03:00
Download the latest [AtomSetup.exe installer ](https://github.com/atom/atom/releases/latest ).
2014-07-09 22:14:21 +04:00
2014-12-10 03:34:16 +03:00
Atom will automatically update when a new release is available.
You can also download an `atom-windows.zip` file from the [releases page ](https://github.com/atom/atom/releases/latest ).
The `.zip` version will not automatically update.
2014-07-14 04:56:50 +04:00
2014-12-10 03:37:54 +03:00
#### Uninstalling Chocolatey Version
The recommended installation of Atom on Windows used to be using [Chocolatey ](https://chocolatey.org/packages/Atom/ ).
This is no longer recommended now that the Atom Windows installer & auto-updater
exists.
To switch from Chocolatey to the new installer:
2014-12-10 03:40:53 +03:00
* Upgrade to Atom 0.155 or above by running `cup Atom`
2014-12-10 03:37:54 +03:00
* Run `cuninst Atom` to uninstall the Chocolatey version of Atom
2014-12-10 04:43:01 +03:00
* This will not delete any of your installed packages or Atom config files.
2014-12-10 03:37:54 +03:00
* Download the latest [AtomSetup.exe installer ](https://github.com/atom/atom/releases/latest ).
* Double-click the downloaded file to install Atom
2014-09-19 20:36:05 +04:00
### Debian Linux (Ubuntu)
Currently only a 64-bit version is available.
1. Download `atom-amd64.deb` from the [Atom releases page ](https://github.com/atom/atom/releases/latest ).
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.
2014-10-28 02:08:21 +03:00
### Red Hat Linux (Fedora, CentOS, Red Hat)
Currently only a 64-bit version is available.
1. Download `atom.x86_64.rpm` from the [Atom releases page ](https://github.com/atom/atom/releases/latest ).
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.
2013-06-10 20:00:08 +04:00
## Building
2012-09-25 20:24:50 +04:00
2014-05-09 03:31:10 +04:00
* [Linux ](docs/build-instructions/linux.md )
* [OS X ](docs/build-instructions/os-x.md )
2014-05-09 11:28:50 +04:00
* [FreeBSD ](docs/build-instructions/freebsd.md )
2014-05-09 03:31:10 +04:00
* [Windows ](docs/build-instructions/windows.md )
2013-11-08 03:08:39 +04:00
2014-04-29 01:42:31 +04:00
## Developing
2014-07-09 22:14:21 +04:00
2014-05-06 19:29:37 +04:00
Check out the [guides ](https://atom.io/docs/latest ) and the [API reference ](https://atom.io/docs/api ).