FloatBar.nvim

A modern, toggleable floating terminal for Neovim with persistent buffers, theme support, and transparent windows.
Perfect for users of Kitty, Alacritty, or any true-color terminal.

---

Features

• Toggleable floating terminal with <C-t>
• Persistent buffer after closing
• Transparent and theme-aware (supports TokyoNight and other true-color themes)
• Semi-transparent (winblend) adjustable
• Customizable width, height, and border
• Works in terminal mode as well
• Send commands programmatically with require("floatbar").send("command")

---

Installation

Using Lazy.nvim

{
  "Redooyyy/floatbar-nvim",
  config = function()
    require("floatbar").setup({
      width = 0.8,      -- Floating window width (percentage)
      height = 0.8,     -- Floating window height (percentage)
      winblend = 0,    -- Transparency (0-100)
      border = "rounded" -- Window border style
      -- keymaps = {
      --   toggle = "<C-t>", -- default keymap
      -- },
    })
  end,
}

Using Packer.nvim

use {
  "Redooyyy/floatbar-nvim",
  config = function()
    require("floatbar").setup({
      width = 0.8,
      height = 0.8,
      winblend = 0,
      border = "rounded",
      -- keymaps = {
      --   toggle = "<C-t>", -- default keymap
      -- },
    })
  end
}

Usage

Toggle terminal: > (des: ctrl + T)

Send command programmatically:

require("floatbar").send("ls -la")

Terminal buffer persists after closing

Works in both normal and terminal mode

Configuration

require("floatbar").setup({
    width = 0.7,       -- 70% of screen width
    height = 0.7,      -- 70% of screen height
    winblend = 0,     -- more transparent
    border = "double", -- other options: single, rounded, solid
      -- keymaps = {
      --   toggle = "<C-t>", -- default keymap
      -- },
})

Keymaps

Mode Key Action Normal Toggle floating terminal

Terminal	<C-t>	Toggle floating terminal

Notes

Make sure vim.o.termguicolors = true is enabled in your config.

Transparent floating terminals work best with true-color terminals like Kitty, Alacritty, or iTerm2.

Colors inherit your Neovim theme (tested with TokyoNight).