alacritty | ||
alfred | ||
autoload | ||
colors | ||
corpus | ||
estilo | ||
exa | ||
iterm2 | ||
kitty | ||
plugin | ||
prism | ||
ranger | ||
support | ||
taskwarrior | ||
timewarrior | ||
tmux | ||
.githelpers | ||
.gitignore | ||
estilo.yml | ||
LICENSE | ||
README.md | ||
TODO.md |
Falcon
If you want a few less colours, a bit more gray, a super dark blue background and only a smattering of green, you want Falcon.
Furthermore, by design, Falcon doesn't include any magenta (replaced with orange in the terminal) so by using it super sparingly it will cut through the noise where appropriate. Try it for the prompt (see the screenshots below for an example)!
Coverage
- Vim / Neovim
- Plugins:
- airline
- Ale
- fugitive
- fzf
- lightline
- nerdtree
- startify
- tagbar
- ultisnips
- vim-gitgutter
- vim-signature
- vimwiki
- Tweaked syntax highlighting:
- C/C++
- CSS
- Gitconfig
- Go
- GraphQL
- Vim help
- HTML
- Javascript
- JSON
- Jsx
- Lua
- Markdown
- PHP
- Python
- Ruby
- Shell script
- Sshconfig
- Tmux
- Twig
- VimL
- Yaml
- XML
- Zsh
- Terminal emulator (Neovim)
- Plugins:
- Terminals:
- Tools:
Vim colour scheme built with estilo. Kudos!
Installation
Prerequisites
This colour scheme assumes that you have a working terminal (see iTerm2, Kitty and alacritty below) with true colour (24bit rgb), bold and italic working. For Vim / Neovim and Tmux a similar assumption is made. How to do this is outside the scope of this README but I wish you well in your searching to get it working. Struggling with these small things (yet irksome) is part of the fun, amirite?!
To get going, either install this repo using a Vim / Neovim plugin manager or clone / download the repo to a folder of your choosing.
Vim / Neovim
Install manually or use a package manager.
e.g.
" vim-plug
Plug 'fenetikm/falcon'
If you put this repo somewhere else first, e.g. in ~/Documents
it would simply be:
" vim-plug
Plug '~/Documents/falcon'
Once installed set the colour scheme:
colorscheme falcon
You also need 24-bit colour enabled with:
set termguicolors
To enable lightline support it is:
let g:falcon_lightline = 1
let g:lightline.colorscheme = 'falcon'
To enable airline support it is:
let g:falcon_airline = 1
let g:airline_theme = 'falcon'
(Thanks to boweevil for adding this in!)
iTerm2
To use in iTerm2 go to: Preferences > Profiles > (Profile Name in left pane) > Colors > Color Presets... > Import...
and then select the falcon.itermcolors
file in the iterm2
directory.
Kitty
To use in kitty, copy and paste the values in the kitty/kitty.conf
file into the bottom of your kitty.conf
file (usually in ~/Library/Preferences/kitty/kitty.conf
).
Protip: if you are on macOS and using an external monitor, you may like my fork of kitty which alters the font rendering to beef it up a tad.
alacritty
To use in alacritty, put the color configuration from alacritty.yml
into your alacritty.yml
file (usually in ~/Library/Preferences/alacritty/alacritty.yml
or ~/.config/alacritty/alacritty.yml
).
(Thanks to timvisee for that one!)
Tmux
A tmux configuration file is included in the tmux
directory. It depends on the colours in your terminal being set to the Falcon colour scheme (e.g. iTerm2, Kitty or alacritty). To include into your tmux setup put something like the following in your .tmux.conf
:
source-file /path/to/falcon/tmux/falcon.conf
Obviously this is an opinionated tmux layout but copy pasta as you see fit.
exa
Custom colours for exa are included in the exa/EXA_COLORS
file. To use them simply include the following in your shell config. e.g. for ZSH:
source /path/to/falcon/exa/EXA_COLORS
git
To get the output of your git log
commands looking on point, included is an example .githelpers
file which is a tweaked version of Gary Bernhardt's but with that Falcon flair.
One way of using this is by putting the following (thanks again Gary!) in your .gitconfig
:
[alias]
r = !GIT_NO_PAGER=1 git l -30
l = "!. ~/.githelpers && pretty_git_log"
To then use it you would just do git r
for a short git log listing or git l
for a long log listing.
Optionally you could additionally put the following in your .gitconfig
:
[color]
ui = auto
[color "branch"]
current = yellow
local = 241
remote = green
[color "diff"]
meta = yellow
frag = magenta
old = red
new = green
[color "status"]
added = green
changed = yellow
untracked = magenta
PrismJS
Included in this repo are some PrismJS css and JS files to add in the Falcon colour scheme to your website for code syntax highlighting.
Once you have PrismJS working on your website, simply include these files after the corresponding PrismJS inclusions, e.g.:
<link href="css/prism.css" rel="stylesheet" />
<link href="css/prism-falcon.css" rel="stylesheet" />
and:
<script src="js/prism.js"></script>
<script src="js/prism-falcon.php.js"></script>
Currently only PHP has some extra love, will add in more as I need them.
Taskwarrior and timewarrior
Simply include the taskwarrior/falcon.theme
file in your .taskrc
e.g.
include ~/Documents/falcon/taskwarrior/falcon.theme
Also included is a timewarrior theme, simply include it in your .timewarrior/timewarrior.cfg
e.g.
import /Users/me/Documents/falcon/timewarrior/falcon.theme
Note that the full path seems to be required.
Alfred
To give your alfred search bar a coat of Falcon paint, open up the Alfred Preferences pane and then double click on the falcon.alfredappearance
file in the alfred
directory.
Palette
Screenshots
PHP
VimL
CSS
JS
JSON
Twig
Exa
Git
Alfred
Screenshots taken on macOS running iTerm2, tmux and Neovim (where applicable). Font is FiraCode with ligatures enabled. In daily use I use kitty for it's sheer speed but iTerm2 makes perty piccies.
Note: Some syntax colour highlighting choices will depend on which syntax highlighting plugins you use. The above was created using the polyglot syntax vim plugin (except for Yaml).
List of terminal colours by name
In lieu of updating the palette image which I have realised is not super helpful for when you want to know what the default terminal colours are by name, here is a list:
-
colour 0: black
-
colour 1: red
-
colour 2: green
-
colour 3: yellow
-
colour 4: blue
-
colour 5: orange (usually magenta)
-
colour 6: cyan
-
colour 7: light gray
-
colour 8: bright black / bg colour
-
colour 9: bright red
-
colour 10: bright green
-
colour 11: bright yellow
-
colour 12: bright blue / blue gray
-
colour 13: bright orange (usually magenta)
-
colour 14: bright cyan
-
colour 15: white
Similar default terminal colours
Sometimes you want to use a colour from the main Falcon palette in the terminal. Sadly that isn't always easy and so what is easy, is to use a close match from the ANSI 256 palette.
(Refer to estilo/palettes/falcon.yml
file for what matches up to what)
- red: 202
- orange: 208
- yellow: 220
- green: 107
- blue_gray: 110
- br_yellow: 230
- br_green: 193
- br_blue: 195
- white: 231
- normal_gray: 253
- light_gray: 249
- mid_gray: 245
- mid_dark_gray: 241
- dark_gray: 237
- darker_gray: 235
- black: 0
- bg: 232
Troubleshooting
-
The colours look a bit off, especially inside of Neovim when also inside of tmux
Have you got
truecolor
support working? Have youset termguicolors
? See the Neovim FAQ for starters. -
In NeoVim, the background colour of the active window is lighter that the inactive window
The active window will take its colour from the terminal which is meant to be darker than the inactive window - check that your terminal colour is the Falcon background colour e.g. load the iTerm2 colours that are included.
-
Can you please support
insert name of other editing program
This project is predominantly based around Vim / Neovim support followed secondarily by terminal support and then lastly by terminal tools. Although I am not opposed to other editors (well, only vehemently!) MRs are welcome :)
-
Can you please support
insert name of terminal program
Possibly - most of the additional support I have been adding in is for tools that I have discovered and I continue to use. Please let me know!
-
The background colours are messing up with the
ap/vim-css-color
plugin when I have a split or twoI also got that problem so I switched to colorizer which seems to work fine and dandy.
Roadmap
Falcon is currently evoloving - to see what is coming up have a look at the Todo
Big Thanks
- Estilo for making colour scheme management sane
- Inspiration: gruvbox for not being quite right to my tastes and thus being the seed of this project
- Everyone who Vims!
License
Falcon is released under the MIT license.