# Getting started

Install Rip, open a folder, and learn the parts of the window.


Rip is a code editor for people who review more code than they write. This page takes you from the download to your first open folder.

## Install

### macOS

1. Download Rip from [ripeditor.com](/#download). Pick Apple Silicon or Intel.
2. Open the disk image and drag Rip into Applications.
3. Open Rip from Applications.

Rip needs macOS 13 or later. Apple has notarized the app, so macOS opens it without a warning.

### Linux

Rip ships as a package for Debian, Ubuntu, Fedora and Arch Linux, and as a tarball for other distributions. The [Linux download page](/download/linux/) has one command for each. The package is `rip-editor`; the command it installs is `rip`.

## Open a folder

Rip shows one folder per window.

- Press <kbd>secondary-o</kbd> and pick a folder.
- On Linux, run `rip path/to/folder` in a terminal.
- Open a file the same way. Rip opens the file and uses its folder as the project.

## The window

- **Sidebar.** The file tree of the open folder. <kbd>secondary-b</kbd> hides and shows it. A file that changed on disk while you looked elsewhere gets a dot.
- **Tabs and panes.** Each file opens in a tab. <kbd>secondary-\</kbd> splits the editor into two panes.
- **Status bar.** The branch and worktree, with buttons for the change review, pull requests, worktrees and file history. On the right: the cursor position, the indentation, and the language.
- **Title bar.** The folder and the current file.

## First keys

| Keys | What happens |
| --- | --- |
| <kbd>secondary-p</kbd> | Find a file by name. |
| <kbd>secondary-shift-p</kbd> | Run any command by name. |
| <kbd>secondary-shift-f</kbd> | Search the folder. |
| <kbd>secondary-,</kbd> | Open the config file. Rip creates it with every option documented. |
| <kbd>secondary-k secondary-t</kbd> | Preview and pick a theme. |
| <kbd>secondary-alt-g</kbd> | Review the changes in the working tree. |

## Next

- [Configuration](/docs/configuration.md) lists every setting.
- [Keyboard shortcuts](/docs/keyboard-shortcuts.md) lists every binding and shows how to change one.
