Skip to content

Jozott00/AdaptiveCaretScroll

Repository files navigation

Plugin Icon

Adaptive Caret Scroll

an Intellij IDEA Plugin

Overview

Adaptive Caret Scroll is an IntelliJ IDEA plugin that enhances the editor's scrolling behavior by maintaining a user-defined distance from the caret to the top and bottom edges of the editor. The plugin aims to improve code readability and the overall coding experience by optimizing the visible area around the caret. This project is implemented in Kotlin and uses the IntelliJ SDK.

Features

  • Auto-scrolling that adjusts the editor's visible area based on the caret's position
  • Configurable top and bottom padding settings
  • Enable centered scroll mode to let caret always stay at the center of the editor
  • Immediate integration with any newly-opened or existing editor instances within the IDE

Roadmap

  • Always centered feature
  • Relative paddings
  • Disable checkbox setting

Installation

  1. Download the .zip file from the GitHub releases.
  2. Open IntelliJ IDEA, go to File > Settings > Plugins.
  3. Click Install Plugin from Disk and select the downloaded .zip file.

Or install it directly from IntelliJ's Plugin Marketplace.

Configuration

  1. Go to File > Settings > Adaptive Caret Scroll.
  2. Configure the distance from the top and bottom edges that you prefer.
  3. Click Apply.

How to Use

Once installed and configured, the plugin will automatically adjust the editor's scrolling behavior based on the configured settings and the caret's current position.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Acknowledgments

This plugin is inspired by the Vim set so=15 setting, which serves a similar function in the Vim editor.


This README provides all essential details about the project, allowing both users and potential contributors to understand its functionality and architecture.