IntelliJ Platform plugin that automatically switches tool window layouts based on your active display context.
- Automatic layout switching based on display context
- Window-aware behavior when laptop + external displays are connected (moving IntelliJ between screens can trigger a different layout)
- Named layout support (saved IntelliJ layouts)
- Action fallback support for IntelliJ layout-related actions
- Notification controls including a global toggle and
Don't show againfrom popup notifications
The plugin checks display context at your configured polling interval and applies the mapped layout/action when context changes.
Supported contexts:
IDE on laptop displayIDE on external (single)IDE on external (multi)
| Dependency | Requirement |
|---|---|
| IntelliJ Platform IDE | 2025.1+ |
| Java | JDK 21+ runtime compatibility |
| OS | macOS / Windows / Linux (display detection is heuristic-based) |
- Download the latest zip from Releases
- IntelliJ IDEA →
Settings→Plugins→ gear icon → Install Plugin from Disk... - Select the zip and restart the IDE
git clone https://github.com/aodesser/autolayout-switcher-intellij-plugin.git
cd autolayout-switcher-intellij-plugin
./gradlew buildPluginOutput:
build/distributions/intellij-layout-plugin-<version>.zip
./gradlew runIde- Save your preferred IntelliJ layouts (for example: one for laptop, one for external screen)
- Open
Settings→Tools→AutoLayout Switcher - Enable automatic switching and map each context to a layout/action
- Move IntelliJ between displays (or connect/disconnect displays) and let the plugin apply the mapped layout
Path: Settings → Tools → AutoLayout Switcher
| Option | Description |
|---|---|
| Automatically switch layout | Enables/disables monitoring and auto-apply |
| Show notifications | Enables/disables popup notifications |
| Polling interval (seconds) | Display/context check interval (2-60) |
| IDE on laptop display | Layout/action applied when IDE is on laptop screen |
| IDE on external (single) | Layout/action applied when IDE is on one external screen |
| IDE on external (multi) | Layout/action applied when IDE is on external setup with multiple displays |
Useful commands:
./gradlew build
./gradlew runIde
./gradlew buildPluginIssues and pull requests are welcome.
Before opening a PR:
- Run
./gradlew build - Update docs for behavior changes
- Keep changes focused and testable
MIT — see LICENSE.