Makes all neovim plugins available in nix (Auto updated)
All vim plugins, ready to go
This repo auto generates nix packages for vim/neovim plugins. Packages are automatically updated twice per week using a GitHub Actions. Plugins are fetched from the manifest.yaml and [awesome-neovim][0] repo.
This is a fork of this repo; however, we fetch all additions from the original repo, so we will never have less plugins. Further, the original deletes plugins that are available in the nixpkgs. We, instead, try to assemble a list of all available plugins. Therefore, to access plugins you will never have to search in two places.
Available plugins
The plugins.md contains an auto-generated list of all available plugins.
Usage
- Sometimes, a new plugin has the same name as an existing one. In this case, we rename the new plugin to
<plugin-name>-<owner>.
pkgs.vimExtraPlugins.
First, add this repo to your inputs:
inputs.nixneovimplugins.url = github:NixNeovim/NixNeovimPlugins
Next, apply the provided overlay:
nixpkgs.overlays = [
inputs.nixneovimplugins.overlays.default
];
Finally, you can add the packages to your vim/neovim config. For example you can use NixNeovim or you can add the plugins directly:
programs.neovim = {
plugins = [
pkgs.vimExtraPlugins.nvim-colorizer-lua
];
}
More info on using neovim with nix can be found here: NixOS Neovim
[0]: https://github.com/rockerBOO/awesome-neovim [1]: https://nixos.org/manual/nix/stable/release-notes/rl-2.4.html?highlight=builtins.getFlake#other-features [2]: https://nur.nix-community.org/ [3]: https://nur.nix-community.org/repos/m15a/
Contribution
How to add a new plugin
1. Add the plugin to manifest.yaml:
The new yaml format has the following format
- owner: nvim-telescope
repo: telescope.nvim
# the following keys are optional
branch: ... # explicitly select branch
custom_name: ... # set custom name, used to fix name clashes
license: ... # specify license
commit: ... # specify commit to use, can be used when newest version is broken
warning: ... # add a waning that will be displayed when using the plugin, will also be visible in plugins.md
Supported are Github (default), SourceHut, and GitLab.
2. Create a Pull Request
- Create a pull request with the changed manifest.yaml (and blocklist.yaml if neccessary).
- A GitHub action will check your contribution and generate all neccessary nix code for your new plugin. It will also take care of sorting and cleaning the manifest.yaml
- After all checks have passed, I will merge your change.
How to remove a new plugin
this contains old information. Just open an issue for now
Copy the entry from manifest.yaml to blocklist.yaml and create a PR. The GitHub Actions will do the rest, including removing the entry from manifest.yaml
Credits
This is originally based on work by m15a