https://github.com/atom/atom
:atom: The hackable text editor
https://github.com/atom/atom
atom editor electron javascript linux macos windows
Last synced: 30 days ago
JSON representation
:atom: The hackable text editor
- Host: GitHub
- URL: https://github.com/atom/atom
- Owner: atom
- License: mit
- Archived: true
- Created: 2012-01-20T18:18:21.000Z (almost 14 years ago)
- Default Branch: master
- Last Pushed: 2023-01-03T10:49:48.000Z (almost 3 years ago)
- Last Synced: 2024-09-30T20:21:37.812Z (about 1 year ago)
- Topics: atom, editor, electron, javascript, linux, macos, windows
- Language: JavaScript
- Homepage: https://atom.io
- Size: 315 MB
- Stars: 60,164
- Watchers: 2,630
- Forks: 17,394
- Open Issues: 994
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-text-editors - Atom - 06-08-sunsetting-atom/))\ (Graphical-based editors)
- awesome-nodejs-projects - Atom - Fully hackable text editor using Chrome. (Developers)
- -awesome-nodejs-projects - Atom - Fully hackable text editor using Chrome. (Developers)
- awesome - atom/atom - :atom: The hackable text editor (JavaScript)
- awesome-nodejs-projects - Atom - Fully hackable text editor using Chrome. (Developers)
- FOSS-for-Dev - Atom - Opensource,fully-featured,hackable text editor for coding. (IDE)
- Awesome - Atom - Atom is a hackable text editor for the 21st century, built on Electron. (Development / Code Editors / IDE)
- fullstack-awesome - **Atom**
- open-source-mac-os-apps - Atom - The hackable text editor. ![javascript_icon] (Applications / IDE)
- awesome-mac-privacy - Atom - is an open-source code editor developed by GitHub. It is highly customizable and designed for software development, with features like a package manager and Git integration. Atom is known for its user-friendly interface and a large library of community-contributed packages, making it a popular choice for developers seeking a versatile and extensible code editing environment. (Map of the content / Development)
- awesome-starred - atom - :atom: The hackable text editor (JavaScript)
- awesome-github-star - atom
- awesome-robotic-tooling - atom - Hackable text editor for the 21st century. (Development Environment / Code and Run)
- awesome-robotic-tooling - atom - Hackable text editor for the 21st century (Development Environment / Code and Run)
- awesome-list - Atom - The hackable text editor. (Cross-Platform / JavaScript)
- awesome-puppet - Atom - The hackable editor by GitHub (Integrated Development Enviroments)
- awesome-open-source-systems - Atom - :atom: The hackable text editor. (IDEs / Text Editors / Follow me)
- Awesome-BSD-Ports-Programs-And-Projects -  (Apps / IDE)
- awesome-nodejs-projects - Atom - Fully hackable text editor using Chrome. (Developers)
- awesome - atom - :atom: The hackable text editor (JavaScript)
- jimsghstars - atom/atom - :atom: The hackable text editor (JavaScript)
- StarryDivineSky - atom/atom
- awesomeelectron - Atom - Code editor. (Apps / Open Source)
- stars - atom/atom - :atom: The hackable text editor (JavaScript)
- stars - atom/atom - :atom: The hackable text editor (JavaScript)
README
# Atom
[](https://dev.azure.com/github/Atom/_build/latest?definitionId=32&branchName=master)
> Atom and all repositories under Atom will be archived on December 15, 2022. Learn more in our [official announcement](https://github.blog/2022-06-08-sunsetting-atom/)
Atom is a hackable text editor for the 21st century, built on [Electron](https://github.com/electron/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](https://atom.io) to learn more or visit the [Atom forum](https://github.com/atom/atom/discussions).
Follow [@AtomEditor](https://twitter.com/atomeditor) on Twitter for important
announcements.
This project adheres to the Contributor Covenant [code of conduct](CODE_OF_CONDUCT.md).
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](https://flight-manual.atom.io) is free and available online. You can find the source to the manual in [atom/flight-manual.atom.io](https://github.com/atom/flight-manual.atom.io).
The [API reference](https://atom.io/docs/api) for developing packages is also documented on Atom.io.
## Installing
### Prerequisites
- [Git](https://git-scm.com)
### macOS
Download the latest [Atom release](https://github.com/atom/atom/releases/latest).
Atom will automatically update when a new release is available.
### Windows
Download the latest [Atom installer](https://github.com/atom/atom/releases/latest). `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](https://github.com/atom/atom/releases/latest).
The `.zip` version will not automatically update.
Using [Chocolatey](https://chocolatey.org)? 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](https://flight-manual.atom.io/getting-started/sections/installing-atom/#platform-linux) 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.
1. Install dependencies (on Ubuntu):
```sh
sudo apt install git libasound2 libcurl4 libgbm1 libgcrypt20 libgtk-3-0 libnotify4 libnss3 libglib2.0-bin xdg-utils libx11-xcb1 libxcb-dri3-0 libxss1 libxtst6 libxkbfile1
```
2. Download `atom-amd64.tar.gz` from the [Atom releases page](https://github.com/atom/atom/releases/latest).
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
* [Linux](https://flight-manual.atom.io/hacking-atom/sections/hacking-on-atom-core/#platform-linux)
* [macOS](https://flight-manual.atom.io/hacking-atom/sections/hacking-on-atom-core/#platform-mac)
* [Windows](https://flight-manual.atom.io/hacking-atom/sections/hacking-on-atom-core/#platform-windows)
## Discussion
* Discuss Atom on [GitHub Discussions](https://github.com/atom/atom/discussions)
## License
[MIT](https://github.com/atom/atom/blob/master/LICENSE.md)
When using the Atom or other GitHub logos, be sure to follow the [GitHub logo guidelines](https://github.com/logos).