colorful-winsep.nvim

https://github.com/user-attachments/assets/6ea56aa3-b5fc-485b-bd62-2cfd162a7f78

configurable window separtor

Motivation

Currently in Neovim, we can not make the active window distinguishable via the window separator. This plugin will color the border of active window, like what tmux does for its different panes.

Requirements

• Neovim 0.11.3+
• Nerd Fonts

Install

Using a plugin manager

Using vim-plug:

Plug 'nvim-zh/colorful-winsep.nvim'

Using Packer.nvim:

use {
    "nvim-zh/colorful-winsep.nvim",
    config = function ()
        require('colorful-winsep').setup()
    end
}

Using lazy.nvim

{
  "nvim-zh/colorful-winsep.nvim",
  config = true,
  event = { "WinLeave" },
}

Configuration

The following is the default configuration (read the comments carefully if you want to change it):

require("colorful-winsep").setup({
    -- choose between "signle", "rounded", "bold" and "double".
    -- Or pass a tbale like this: { "─", "│", "┌", "┐", "└", "┘" },
    border = "bold",
    excluded_ft = { "packer", "TelescopePrompt", "mason" },
    highlight = { fg = "#957CC6", bg = vim.api.nvim_get_hl(0, { name = "Normal" }).bg },
    animate = {
        enabled = false, -- choose a option below (e.g. "shift") and set option for it if needed
        shift = {
            delta_time = 0.1,
            smooth_speed = 1,
            delay = 3,
        },
        progressive = {
            -- animation's speed for different direction
            vertical_delay = 20,
            horizontal_delay = 2,
        },
    },
    indicator_for_2wins = {
        -- only work when the total of windows is two
        position = nil, -- nil to disable or choose between "center", "start", "end" and "both"
        symbols = {
            -- the meaning of left, down ,up, right is the position of separator
            start_left = "󱞬",
            end_left = "󱞪",
            start_down = "󱞾",
            end_down = "󱟀",
            start_up = "󱞢",
            end_up = "󱞤",
            start_right = "󱞨",
            end_right = "󱞦",
        },
    },
})

animate

By default, all animates are disabled to improve the perfomance and relax our eyes. You should enable it manually if needed.

shift

Have a look at the top of this README

progressive

https://github.com/user-attachments/assets/4cc29832-ed46-44ec-80db-0f1da350deeb

indicator_for_2wins

When using the plugin with two windows only, it becomes difficult to discern which window is currently active. With this feature we can identify the active window more easily. To enable it, set the indicator_for_2wins.position to a available option (center is recommended). Here come the showcases:

Commands

The user command of the plugin is Winsep, and here comes the subcommands of it:

subcommand	function
enable	enable the plugin
disable	disable the plugin
toggle	toggle the plugin

Highlights

The highlight's name is ColorfulWinSep. You can change it using nvim's builtin function or changing the plugin's configuration

TODO

• add marquee

License

This plugin is released under the MIT License.