https://github.com/killitar/obscure.nvim
A dark Neovim theme written in Lua, with support for LSP, Tree-sitter and lots of plugins.
https://github.com/killitar/obscure.nvim
colorscheme neovim neovim-colorscheme neovim-lua neovim-lua-plugin neovim-plugin neovim-theme neovim-theme-dark vim vim-colorscheme
Last synced: 2 months ago
JSON representation
A dark Neovim theme written in Lua, with support for LSP, Tree-sitter and lots of plugins.
- Host: GitHub
- URL: https://github.com/killitar/obscure.nvim
- Owner: killitar
- License: apache-2.0
- Created: 2024-07-21T11:56:28.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-02-28T19:44:37.000Z (4 months ago)
- Last Synced: 2025-05-08T21:17:43.115Z (2 months ago)
- Topics: colorscheme, neovim, neovim-colorscheme, neovim-lua, neovim-lua-plugin, neovim-plugin, neovim-theme, neovim-theme-dark, vim, vim-colorscheme
- Language: Lua
- Homepage:
- Size: 921 KB
- Stars: 65
- Watchers: 1
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-neovim-sorted - killitar/obscure.nvim - sitter and lots of plugins. | (Colorscheme)
- awesome-neovim-sorted - killitar/obscure.nvim - sitter and lots of plugins. | (Colorscheme)
- awesome-neovim - killitar/obscure.nvim - A pastel dark colorscheme inspired by the palette Mellow. Support Tree-sitter, LSP _(including semantic tokens)_ and lots of plugins. (Colorscheme / Tree-sitter Supported Colorscheme)
README
# Obscure
A dark [Neovim](https://github.com/neovim/neovim) theme written in [Lua](https://www.lua.org), inspired by the pastel palette [mellow.nvim](https://github.com/mellow-theme/mellow.nvim) that I used for a long time.
## 🔍 Gallery
### Lua
### TypeScript
### Astro
### Markdown
## ✨ Features
- Supports the latest [Neovim](https://github.com/neovim/neovim) [0.9.0](https://github.com/neovim/neovim/releases/tag/v0.9.0) features.
- Terminal colors
- Supports all major plugins
## 📦 Requirements
- [Neovim](https://github.com/neovim/neovim) >= [0.9.0](https://github.com/neovim/neovim/releases/tag/v0.9.0)
## ⚡️ Installation
Install the theme using your preferred package manager, e.g. [lazy](https://github.com/folke/lazy.nvim):
```lua
{
"killitar/obscure.nvim",
lazy = false,
priority = 1000,
opts = {}
}
```
## 🚀 Usage
### Vim Script
```vim
colorscheme obscure
```
### Lua
```lua
vim.cmd[[colorscheme obscure]]
```
## ⚙️ Configuration
> [!IMPORTANT]
> Set the configuration **BEFORE** loading the color scheme with `colorscheme obscure`.
Default Options
```lua
{
transparent = false,
terminal_colors = true,
dim_inactive = true,
styles = {
keywords = { italic = true },
identifiers = {},
functions = {},
variables = {},
booleans = {},
comments = { italic = true },
},
--- You can override specific highlights to use other groups or a hex color
--- function will be called with a Highlights and ColorScheme table
on_highlights = function(highlights, colors) end,
plugins = {
-- enable all plugins when not using lazy.nvim
-- set to false to manually enable/disable plugins
all = package.loaded.lazy == nil,
-- uses your plugin manager to automatically enable needed plugins
-- currently only lazy.nvim is supported
auto = true,
-- add any plugins here that you want to enable
-- for all possible plugins, see:
-- * https://github.com/killitar/obscure.nvim/tree/main/lua/obscure/groups
-- flash = true,
},
}
```
## 🪓 Overriding Colors & Highlight Groups
To configure a setting, you should pass that setting with the changed value following the structure of the default configuration.
```lua
require("obscure").setup({
styles = {
booleans = { italic = true, bold = true },
},
on_highlights = function(hl,c)
hl.Comment = { fg = "#ffffff" }
-- Or
hl.Comment = { fg = c.orange }
end
})
```
## 🧵 Extra
You can easily use the color palette for other plugins inside your [Neovim](https://github.com/neovim/neovim) configuration:
```lua
local colors = require("obscure.palettes").get_palette("obscure") -- pass in any of the config options as explained above
plugin.bg = colors.yellow
```
## 👏 Acknowledgements
- [Tokyo Night](https://github.com/folke/tokyonight.nvim)
- [Mellow](https://github.com/mellow-theme/mellow.nvim)