🔊 reverb.nvim

reverb.nvim is a Neovim plugin that adds sound effects to specific autocmd events. With this plugin, you can enhance your Neovim experience by associating various sounds with different actions, providing an auditory dimension to your coding environment.

github.mp4

⭐ Turn sound on

Any suggestions or help is welcome and appreciated 😄

Dependencies

Sound files cam be played with paplay, pw-play or mpv. Check with your local package manager if you're not sure.

Installation

To get started, configure the plugin's options in your Neovim configuration. Here's an example of customizing the sounds using Lazy:

{
  "whleucka/reverb.nvim",
  event = "BufReadPre",
  opts = {
    player = "paplay", -- options: paplay (default), pw-play, mpv
    max_sounds = 20, -- Limit the amount of sounds that can play at the same time
    sounds = {
      -- Add custom sound paths or lists of sounds for other events here
      -- For example, BufRead can play a random sound from a list
      BufRead = { path = { sound_dir .. "start1.ogg", sound_dir .. "start2.ogg" }, volume = 0-100 },
      CursorMovedI = { path = sound_dir .. "click.ogg", volume = 0-100 },
      InsertLeave = { path = sound_dir .. "toggle.ogg", volume = 0-100 },
      ExitPre = { path = sound_dir .. "exit.ogg", volume = 0-100 },
      BufWrite = { path = sound_dir .. "save.ogg", volume = 0-100 },
    },
  },
}

You can manage the sound settings in reverb.nvim with the following commands:

• :ReverbToggle to switch sounds on or off.
• :ReverbEnable to turn sounds on.
• :ReverbDisable to turn sounds off.

Sound Effects

• Note: reverb.nvim does not include any sound files.
• You can find free (CC0) interface sounds at https://www.kenney.nl/assets/interface-sounds

License

This project is licensed under the MIT License.