> ## Documentation Index
> Fetch the complete documentation index at: https://openidea.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrate from another IDE

> Pick a familiar keymap, bring over settings, themes and run configurations, and map concepts from IntelliJ IDEA, VS Code and Eclipse.

OpenIDEA follows IntelliJ IDEA's model: a folder is a project, features live in tool windows, and almost everything is reachable from Search Everywhere or Find Action. This page covers what you can bring with you and where familiar things live.

## Choose a keymap

OpenIDEA ships six keymaps:

| Keymap | Based on |
| - | - |
| **macOS** | IntelliJ IDEA's macOS keymap. The default on macOS. |
| **Windows** | IntelliJ IDEA's Windows keymap. The default on Windows and Linux. |
| **VS Code (macOS)**, **VS Code (Windows)** | Visual Studio Code's default shortcuts. Actions VS Code has no shortcut for are left unbound. |
| **Eclipse (macOS)**, **Eclipse** | IntelliJ IDEA's Eclipse keymaps. |

Switch keymaps in any of these places:

* Welcome screen › **Customize** › **Keymap**
* **Settings › Keymap**
* **View › Quick Switch Scheme…** (`` ⌃` `` / `` Ctrl+` ``) › **Keymap**

You can change single shortcuts on top of any keymap, or duplicate one into your own. See [Keymaps](https://openidea.sh/en/guide/keymap.md).

## From IntelliJ IDEA and other JetBrains IDEs

The defaults already match IDEA: the keymap, tool window numbers (`⌘1` / `Alt+1` for Project, `⌘9` / `Alt+9` for Git), `⇧⇧` / `Shift Shift` for Search Everywhere and `⌥↵` / `Alt+Enter` for context actions.

### Import settings

Use **File › Manage IDE Settings › Import Settings from JetBrains IDE…** and pick one of the JetBrains IDEs found on this computer. To use a `settings.zip` exported from a JetBrains IDE instead, choose **File › Manage IDE Settings › Import Settings…** and select the zip.

A confirmation lists what will be imported before anything changes:

* Color schemes (the `.icls` files) and the color scheme in use
* Editor font: family, size, line spacing (as line height) and ligatures
* Trailing-space stripping, final newline on save, sticky lines, whitespace display, soft wraps
* **Confirm before exiting the IDE**

Keymaps, code styles, live templates, inspection profiles and plugins are not imported; the confirmation lists the ones it skipped. Imported values go to the global settings.

### Import a theme

With a project open, go to **Settings › Plugins**, open the gear menu and choose:

* **Import Theme from JetBrains IDE…** to pick a theme plugin installed in your JetBrains IDEs, or
* **Import IntelliJ Theme from File…** for a theme plugin `.jar`, a Marketplace `.zip`, a plugin folder or a `.theme.json` file.

The theme is converted into an OpenIDEA theme plugin and installed. Select it in **Settings › Appearance & Behavior › Appearance › Theme**. See [Themes and fonts](https://openidea.sh/en/guide/themes.md).

### Import run configurations

Run **Import Run Configurations from JetBrains (.run, .idea)** from Find Action, or use the import link in **Run › Edit Configurations…**. OpenIDEA reads the project's `.run` and `.idea` run configurations it can map; a notification says how many came in and why others were left out.

### IdeaVim

Vim mode reads `~/.ideavimrc` (or `~/.openideavimrc`). Turn it on with **Tools › Vim**. See [Vim mode](https://openidea.sh/en/guide/vim.md).

## From VS Code

Pick **VS Code (macOS)** or **VS Code (Windows)** as the keymap; then `⇧⌘P` / `Ctrl+Shift+P` opens Find Action and `⌘P` / `Ctrl+P` opens Go to File as you expect.

| In VS Code | In OpenIDEA |
| - | - |
| Command Palette | **Find Action** (`⇧⌘A` / `Ctrl+Shift+A` in the default keymap) |
| Quick Open | **Go to File** (`⇧⌘O` / `Ctrl+Shift+N`), or **Search Everywhere** (`⇧⇧` / `Shift Shift`) |
| Explorer | **Project** tool window (`⌘1` / `Alt+1`) |
| Problems panel | **Problems** tool window (`⌘6` / `Alt+6`) |
| Integrated terminal | **Terminal** tool window (`⌥F12` / `Alt+F12`) |
| Source Control | **Commit** tool window (`⌘0` / `Alt+0`) and **Git** tool window (`⌘9` / `Alt+9`) |
| Extensions | **Settings › Plugins** |
| `settings.json` | **Settings** (`⌘,` / `Ctrl+Alt+S`), stored in `settings.toml`; per-project values in `.openidea/settings.toml` |
| `launch.json` | Run configurations: **Import Run Configurations from .vscode/launch.json** |
| Multi-root workspace | **File › New Workspace…** and **Attach Project…** |

`.editorconfig` files are applied. VS Code settings and extensions are not imported.

## From Eclipse

Pick **Eclipse (macOS)** or **Eclipse** as the keymap.

* **Formatter.** To keep using an Eclipse formatter profile for Java, open **Settings › Editor › Code Style › Java**, set **Formatting profile** to **Custom Eclipse formatter XML** and choose the exported XML file.
* **Workspaces and projects.** Eclipse opens many projects in one workspace. OpenIDEA opens one project per window; to work on several folders together, create a workspace with **File › New Workspace…** or add folders with **Attach Project…**.
* **Perspectives.** OpenIDEA has no perspectives. Arrange tool windows the way you like and save the arrangement with **Window › Tool Window Layouts › Save Current Layout as…**.

## Concepts at a glance

| Concept | In OpenIDEA |
| - | - |
| Project | A folder you open. Project settings and shared run configurations live in its `.openidea/` folder. |
| Tool window | A panel at the window edge: Project, Git, Run, Debug, Terminal and others. Toggle with its number shortcut. |
| Action | Every command has an action you can run from **Find Action** and bind in **Settings › Keymap**. |
| Run configuration | What to run or debug and how; see [Run configurations](https://openidea.sh/en/guide/run.md). |
| Language server | The process that provides code insight for a language; see [Languages](https://openidea.sh/en/languages/index.md). |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.