2021-04-19 19:40:12 +00:00
# 🏙 Tokyo Night
2023-07-01 06:48:31 +00:00
A dark and light [Neovim ](https://github.com/neovim/neovim ) theme written in
[Lua ](https://www.lua.org ) ported from the [Visual Studio Code
TokyoNight](https://github.com/enkia/tokyo-night-vscode-theme) theme. Includes
[extra ](#-extras ) themes for [Kitty ](https://sw.kovidgoyal.net/kitty/conf.html ),
[Alacritty ](https://github.com/alacritty/alacritty ),
[iTerm ](https://iterm2.com/ ) and
[Fish ](https://fishshell.com/docs/current/index.html ).
2021-04-19 19:40:12 +00:00
2021-04-19 19:55:58 +00:00
## Storm
![image ](https://user-images.githubusercontent.com/292349/115295095-3a9e5080-a10e-11eb-9aed-6054488c46ce.png )
## Night
![image ](https://user-images.githubusercontent.com/292349/115295327-7afdce80-a10e-11eb-89b3-2591262bf95a.png )
2022-09-19 04:48:01 +00:00
## Moon
2022-09-19 04:50:35 +00:00
![image ](https://user-images.githubusercontent.com/292349/190951628-10ba28a1-57ff-4479-8eab-47400a402242.png )
2021-04-24 20:24:40 +00:00
## Day
2021-04-25 13:57:39 +00:00
![image ](https://user-images.githubusercontent.com/292349/115996270-78c6c480-a593-11eb-8ed0-7d1400b058f5.png )
2021-04-19 19:40:12 +00:00
## ✨ Features
2023-07-01 06:48:31 +00:00
- Supports the latest [Neovim ](https://github.com/neovim/neovim )
[0.9.0 ](https://github.com/neovim/neovim/releases/tag/v0.9.0 ) features.
- Enhances terminal colors.
- Introduces a darker background option for sidebar-like windows.
- Supports all major plugins.
- Provides [TokyoNight ](https://github.com/folke/tokyonight.nvim )
2023-07-01 06:49:54 +00:00
[extras ](#-extras ) for numerous other applications.
2023-04-22 08:30:43 +00:00
### 🍭 Extras
<!-- extras:start -->
2023-04-23 09:05:40 +00:00
- [Alacritty ](https://github.com/alacritty/alacritty ) ([alacritty](extras/alacritty))
- [Delta ](https://github.com/dandavison/delta ) ([delta](extras/delta))
2023-06-17 06:25:13 +00:00
- [Dunst ](https://dunst-project.org/ ) ([dunst](extras/dunst))
2023-04-23 09:05:40 +00:00
- [Fish ](https://fishshell.com/docs/current/index.html ) ([fish](extras/fish))
- [Fish Themes ](https://fishshell.com/docs/current/interactive.html#syntax-highlighting ) ([fish_themes](extras/fish_themes))
- [Foot ](https://codeberg.org/dnkl/foot ) ([foot](extras/foot))
2023-06-21 09:14:34 +00:00
- [GitUI ](https://github.com/extrawurst/gitui ) ([gitui](extras/gitui))
2023-09-25 08:49:41 +00:00
- [Helix ](https://helix-editor.com/ ) ([helix](extras/helix))
2023-04-23 09:05:40 +00:00
- [iTerm ](https://iterm2.com/ ) ([iterm](extras/iterm))
- [Kitty ](https://sw.kovidgoyal.net/kitty/conf.html ) ([kitty](extras/kitty))
- [Lua Table for testing ](https://www.lua.org ) ([lua](extras/lua))
- [Prism ](https://prismjs.com ) ([prism](extras/prism))
- [Sublime Text ](https://www.sublimetext.com/docs/themes ) ([sublime](extras/sublime))
- [Terminator ](https://gnome-terminator.readthedocs.io/en/latest/config.html ) ([terminator](extras/terminator))
- [Tilix ](https://github.com/gnunn1/tilix ) ([tilix](extras/tilix))
- [Tmux ](https://github.com/tmux/tmux/wiki ) ([tmux](extras/tmux))
2023-08-29 16:47:48 +00:00
- [WezTerm ](https://wezfurlong.org/wezterm/config/files.html ) ([wezterm](extras/wezterm))
2023-04-23 09:05:40 +00:00
- [Windows Terminal ](https://aka.ms/terminal-documentation ) ([windows_terminal](extras/windows_terminal))
- [Xfce Terminal ](https://docs.xfce.org/apps/terminal/advanced ) ([xfceterm](extras/xfceterm))
- [Xresources ](https://wiki.archlinux.org/title/X_resources ) ([xresources](extras/xresources))
2023-05-24 08:51:07 +00:00
- [Zathura ](https://pwmt.org/projects/zathura/ ) ([zathura](extras/zathura))
2023-04-22 08:30:43 +00:00
<!-- extras:end -->
2021-04-19 19:40:12 +00:00
2021-04-21 06:05:13 +00:00
## ⚡️ Requirements
2023-07-01 06:48:31 +00:00
- [Neovim ](https://github.com/neovim/neovim ) >=
[0.7.2 ](https://github.com/neovim/neovim/releases/tag/v0.7.2 )
2021-05-17 06:44:17 +00:00
2021-04-19 19:40:12 +00:00
## 📦 Installation
2023-07-01 06:48:31 +00:00
Install the theme with your preferred package manager, such as
[folke/lazy.nvim ](https://github.com/folke/lazy.nvim ):
2021-04-19 19:40:12 +00:00
```lua
2023-05-22 14:19:06 +00:00
{
2023-05-24 17:06:43 +00:00
"folke/tokyonight.nvim",
2023-05-22 14:19:06 +00:00
lazy = false,
priority = 1000,
opts = {},
}
2021-04-19 19:40:12 +00:00
```
## 🚀 Usage
2023-07-01 06:48:31 +00:00
### Vim Script
2021-04-19 19:40:12 +00:00
```vim
colorscheme tokyonight
2022-09-06 13:52:10 +00:00
2023-07-01 06:48:31 +00:00
" There are also colorschemes for the different styles.
2022-09-06 13:52:10 +00:00
colorscheme tokyonight-night
colorscheme tokyonight-storm
colorscheme tokyonight-day
2022-09-19 04:48:01 +00:00
colorscheme tokyonight-moon
2021-04-19 19:40:12 +00:00
```
2023-07-01 06:48:31 +00:00
### [Lua](https://www.lua.org)
2021-04-19 19:40:12 +00:00
```lua
vim.cmd[[colorscheme tokyonight]]
```
2023-07-01 06:48:31 +00:00
#### External Plugins
##### [Barbecue](https://github.com/utilyre/barbecue.nvim)
2022-12-29 21:42:26 +00:00
```lua
2023-07-01 06:48:31 +00:00
-- Lua
2022-12-29 21:42:26 +00:00
require('barbecue').setup {
-- ... your barbecue config
theme = 'tokyonight',
-- ... your barbecue config
}
```
2023-07-01 06:48:31 +00:00
##### [Lualine](https://github.com/nvim-lualine/lualine.nvim)
2021-04-19 19:40:12 +00:00
```lua
2023-07-01 06:48:31 +00:00
-- Lua
2021-04-19 19:40:12 +00:00
require('lualine').setup {
2021-04-20 21:04:05 +00:00
options = {
-- ... your lualine config
theme = 'tokyonight'
-- ... your lualine config
}
2021-04-19 19:40:12 +00:00
}
```
2023-07-01 06:48:31 +00:00
##### [Lightline](https://github.com/itchyny/lightline.vim)
2021-05-17 06:44:17 +00:00
```vim
" Vim Script
let g:lightline = {'colorscheme': 'tokyonight'}
```
2021-04-19 19:40:12 +00:00
## ⚙️ Configuration
2023-07-01 06:49:54 +00:00
> ❗️ Set the configuration **BEFORE** loading the color scheme with `colorscheme tokyonight`.
2021-04-25 10:22:01 +00:00
2023-07-01 06:48:31 +00:00
The theme offers four styles: [storm ](#storm ), [moon ](#moon ), [night ](#night ),
and [day ](#day ).
2021-04-19 19:40:12 +00:00
2023-07-01 06:48:31 +00:00
The [day ](#day ) style is used when `{ style = "day" }` is passed to
`setup(options)` or when `vim.o.background = "light"` .
2021-04-25 13:50:02 +00:00
2023-07-01 06:48:31 +00:00
[TokyoNight ](https://github.com/folke/tokyonight.nvim ) uses the default options,
unless `setup` is explicitly called.
2021-04-20 05:47:36 +00:00
2021-04-20 10:19:20 +00:00
```lua
2022-09-05 19:02:16 +00:00
require("tokyonight").setup({
-- your configuration comes here
-- or leave it empty to use the default settings
2022-09-19 04:48:01 +00:00
style = "storm", -- The theme comes in three styles, `storm` , `moon` , a darker variant `night` and `day`
2022-10-02 16:25:44 +00:00
light_style = "day", -- The theme is used when the background is set to light
2022-09-05 19:02:16 +00:00
transparent = false, -- Enable this to disable setting the background color
2023-07-01 06:48:31 +00:00
terminal_colors = true, -- Configure the colors used when opening a `:terminal` in [Neovim ](https://github.com/neovim/neovim )
2022-09-05 19:02:16 +00:00
styles = {
-- Style to be applied to different syntax groups
2022-09-12 05:51:08 +00:00
-- Value is any valid attr-list value for `:help nvim_set_hl`
comments = { italic = true },
keywords = { italic = true },
functions = {},
variables = {},
2022-09-05 19:02:16 +00:00
-- Background styles. Can be "dark", "transparent" or "normal"
sidebars = "dark", -- style for sidebars, see below
floats = "dark", -- style for floating windows
},
2022-09-06 08:24:33 +00:00
sidebars = { "qf", "help" }, -- Set a darker background on sidebar-like windows. For example: `["qf", "vista_kind", "terminal", "packer"]`
day_brightness = 0.3, -- Adjusts the brightness of the colors of the **Day** style. Number between 0 and 1, from dull to vibrant colors
hide_inactive_statusline = false, -- Enabling this option, will hide inactive statuslines and replace them with a thin border instead. Should work with the standard **StatusLine** and **LuaLine** .
2022-09-05 20:04:01 +00:00
dim_inactive = false, -- dims inactive windows
2022-09-06 08:24:33 +00:00
lualine_bold = false, -- When `true` , section headers in the lualine theme will be bold
2022-09-05 19:02:16 +00:00
2022-09-06 08:24:33 +00:00
--- You can override specific color groups to use other groups or a hex color
2022-09-13 05:21:24 +00:00
--- function will be called with a ColorScheme table
2022-09-05 19:02:16 +00:00
---@param colors ColorScheme
on_colors = function(colors) end,
2022-09-06 08:24:33 +00:00
--- You can override specific highlights to use other groups or a hex color
2022-09-13 05:21:24 +00:00
--- function will be called with a Highlights and ColorScheme table
2022-09-05 19:02:16 +00:00
---@param highlights Highlights
---@param colors ColorScheme
on_highlights = function(highlights, colors) end,
2022-09-06 13:49:55 +00:00
})
2022-09-05 19:02:16 +00:00
```
2021-04-23 18:21:12 +00:00
2022-09-12 07:07:57 +00:00
## 🪓 Overriding Colors & Highlight Groups
How the highlight groups are calculated:
2023-07-01 06:48:31 +00:00
1. `colors` are determined based on your configuration, with the ability to
override them using `config.on_colors(colors)` .
1. These `colors` are utilized to generate the highlight groups.
1. `config.on_highlights(highlights, colors)` can be used to override highlight
groups.
2022-09-12 07:07:57 +00:00
2023-07-01 06:48:31 +00:00
For default values of `colors` and `highlights` , please consult the
[storm ](extras/lua/tokyonight_storm.lua ),
[moon ](extras/lua/tokyonight_moon.lua ),
[night ](extras/lua/tokyonight_night.lua ), and
[day ](extras/lua/tokyonight_day.lua ) themes.
2022-09-12 07:07:57 +00:00
2023-07-01 06:48:31 +00:00
### Settings and color alteration demonstration
2022-09-05 19:40:28 +00:00
2022-09-05 19:02:16 +00:00
```lua
require("tokyonight").setup({
-- use the night style
style = "night",
-- disable italic for functions
styles = {
2022-09-12 07:07:57 +00:00
functions = {}
2022-09-05 19:02:16 +00:00
},
sidebars = { "qf", "vista_kind", "terminal", "packer" },
-- Change the "hint" color to the "orange" color, and make the "error" color bright red
2022-09-07 16:26:55 +00:00
on_colors = function(colors)
2022-09-05 19:02:16 +00:00
colors.hint = colors.orange
colors.error = "#ff0000"
2022-09-07 16:26:55 +00:00
end
2022-09-05 19:02:16 +00:00
})
2022-09-05 19:40:28 +00:00
```
2021-04-25 10:22:01 +00:00
2023-07-01 06:48:31 +00:00
### [Borderless Telescope](https://github.com/nvim-telescope/telescope.nvim/wiki/Gallery#borderless) example
2022-09-05 19:40:28 +00:00
```lua
require("tokyonight").setup({
on_highlights = function(hl, c)
local prompt = "#2d3149"
hl.TelescopeNormal = {
bg = c.bg_dark,
fg = c.fg_dark,
}
hl.TelescopeBorder = {
bg = c.bg_dark,
fg = c.bg_dark,
}
hl.TelescopePromptNormal = {
bg = prompt,
}
hl.TelescopePromptBorder = {
bg = prompt,
fg = prompt,
}
hl.TelescopePromptTitle = {
bg = prompt,
fg = prompt,
}
hl.TelescopePreviewTitle = {
bg = c.bg_dark,
fg = c.bg_dark,
}
hl.TelescopeResultsTitle = {
bg = c.bg_dark,
fg = c.bg_dark,
}
end,
})
2021-04-19 19:40:12 +00:00
```
2021-04-20 05:47:36 +00:00
2023-07-01 06:48:31 +00:00
### Fix `undercurls` in [Tmux](https://github.com/tmux/tmux)
2021-04-30 06:43:16 +00:00
2023-07-01 06:48:31 +00:00
To have undercurls show up and in color, add the following to your
[Tmux ](https://github.com/tmux/tmux ) configuration file:
2021-04-30 06:43:16 +00:00
```sh
# Undercurl
set -g default-terminal "${TERM}"
set -as terminal-overrides ',*:Smulx=\E[4::%p1%dm' # undercurl support
set -as terminal-overrides ',*:Setulc=\E[58::2::%p1%{65536}%/%d::%p1%{256}%/%{255}%&%d::%p1%{255}%&%d%; m' # underscore colours - needs tmux-3.0
```
2021-04-20 11:39:38 +00:00
## 🍭 Extras
2023-07-01 06:48:31 +00:00
Extra color configs for [Kitty ](https://sw.kovidgoyal.net/kitty/conf.html ),
[Alacritty ](https://github.com/alacritty/alacritty ),
2023-10-19 05:53:35 +00:00
[Fish ](https://fishshell.com/docs/current/index.html ), [WezTerm ](https://wezfurlong.org/wezterm/config/files.html ),
2023-07-01 06:48:31 +00:00
[iTerm ](https://iterm2.com/ ) and [foot ](https://codeberg.org/dnkl/foot ) can be
found in [extras ](extras/ ). To use them, refer to their respective
documentation.
2021-04-20 12:26:02 +00:00
![image ](https://user-images.githubusercontent.com/292349/115395546-d8d6f880-a198-11eb-98fb-a1194787701d.png )
2021-06-04 06:26:02 +00:00
2023-07-01 06:48:31 +00:00
You can easily use the color palette for other plugins inside your
[Neovim ](https://github.com/neovim/neovim ) configuration:
2021-08-05 07:48:22 +00:00
```lua
2022-09-05 19:02:16 +00:00
local colors = require("tokyonight.colors").setup() -- pass in any of the config options as explained above
2022-09-02 06:08:52 +00:00
local util = require("tokyonight.util")
2021-08-05 07:48:22 +00:00
aplugin.background = colors.bg_dark
2023-05-07 17:16:42 +00:00
aplugin.my_error = util.lighten(colors.red1, 0.3) -- number between 0 and 1. 0 results in white, 1 results in red1
2021-08-05 07:48:22 +00:00
```
2021-06-04 06:26:02 +00:00
## 🔥 Contributing
2023-07-01 06:48:31 +00:00
Pull requests are welcome.
For the [extras ](#-extras ), we use a simple template system that can be used to
generate themes for the different styles.
2021-06-04 06:26:02 +00:00
How to add a new extra template:
2023-07-01 06:48:31 +00:00
1. Create a file like `lua/tokyonight/extra/cool-app.lua` .
2. Add the name and output file extension to the `extras` table in
`lua/tokyonight/extra/init.lua` .
2023-09-25 08:49:41 +00:00
3. Run the following command to generate new [extra ](#-extras ) themes from the tokyonight plugin directory:
2023-04-22 07:28:50 +00:00
```sh
2023-07-01 06:48:31 +00:00
nvim --headless "+lua require('tokyonight.extra').setup()" +qa
2023-04-22 07:28:50 +00:00
```
2023-07-01 06:48:31 +00:00
4. Check the newly created themes in the `extra/` directory. Please **DO NOT**
commit them, as they are already automatically built by the CI.