Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/powerman/wcwidth-icons
Support fonts with double-width icons in xterm/rxvt-unicode/zsh/vim/…
https://github.com/powerman/wcwidth-icons
font-icons ld-preload patch urxvt vim xterm zsh
Last synced: 3 days ago
JSON representation
Support fonts with double-width icons in xterm/rxvt-unicode/zsh/vim/…
- Host: GitHub
- URL: https://github.com/powerman/wcwidth-icons
- Owner: powerman
- License: lgpl-2.1
- Created: 2017-04-14T07:17:01.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-07-10T15:00:57.000Z (4 months ago)
- Last Synced: 2024-11-07T10:41:11.858Z (5 days ago)
- Topics: font-icons, ld-preload, patch, urxvt, vim, xterm, zsh
- Language: C
- Size: 31.3 KB
- Stars: 42
- Watchers: 5
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - powerman/wcwidth-icons - Support fonts with double-width icons in xterm/rxvt-unicode/zsh/vim/… (C)
README
# wcwidth-icons
Support fonts with double-width icons in xterm/rxvt-unicode/zsh/vim/…
If fonts with icons like [Nerd Fonts](https://github.com/ryanoasis/nerd-fonts/)
are used with some terminals like rxvt-unicode then icons must have
single-width (Nerd Fonts calls this "Mono" font, generated by Nerd Fonts
Font Patcher with option `--use-single-width-glyphs`) to work correctly.
**This makes icons too small (about ¼ of normal size for most icons).**
To fix this for most applications (like xterm/rxvt-unicode/zsh/…) which
use libc function (like `wcwidth(3)` or `wcswidth(3)`) to get symbol width
you can use provided library in `LD_PRELOAD` environment variable.
Some other applications may need extra configuration or a patch (see below).
With these fixes you should use Nerd Fonts with "Propo" font name suffix
instead of "Mono".
## Install
```sh
# Build libwcwidth-icons.so and copy it to /usr/lib/ by default.
sudo make install
```
### Gentoo Linux
```
sudo layman -a powerman
sudo emerge wcwidth-icons
# Patch Vim
sudo mkdir -p /etc/portage/patches/app-editors/vim{,-core}/
sudo wget https://github.com/powerman/wcwidth-icons/raw/master/patches/vim/wcwidth-icons.patch \
-O /etc/portage/patches/app-editors/vim/wcwidth-icons.patch
sudo cp /etc/portage/patches/app-editors/vim{,-core}/wcwidth-icons.patch
sudo emerge -1 vim vim-core
```
## Usage
```sh
export LD_PRELOAD=/usr/lib/libwcwidth-icons.so
```
Then run urxvt/xterm/zsh/… using font with double-width icons.
## Other applications
### Less
```sh
export LESSUTFCHARDEF="23fb-23fe:w,2665:w,2b58:w,e000-e00a:w,e0a0-e0a3:p,e0b0-e0bf:p,e0c0-e0c8:w,e0ca:w,e0cc-e0d7:w,e200-e2a9:w,e300-e3e3:w,e5fa-e6b5:w,e700-e7c5:w,ea60-ec1e:w,ed00-efce:w,f000-f2ff:w,f300-f375:w,f400-f533:w,f0001-f1af0:w"
```
### Vim
Add this to your Vim configuration:
```vim
" Fix icon width for Nerd Fonts v3.2.1.
call setcellwidths([
\ [ 0x23fb, 0x23fe, 2 ],
\ [ 0x2665, 0x2665, 2 ],
\ [ 0x2b58, 0x2b58, 2 ],
\ [ 0xe000, 0xe00a, 2 ],
\ [ 0xe0c0, 0xe0c8, 2 ],
\ [ 0xe0ca, 0xe0ca, 2 ],
\ [ 0xe0cc, 0xe0d7, 2 ],
\ [ 0xe200, 0xe2a9, 2 ],
\ [ 0xe300, 0xe3e3, 2 ],
\ [ 0xe5fa, 0xe6b5, 2 ],
\ [ 0xe700, 0xe7c5, 2 ],
\ [ 0xea60, 0xec1e, 2 ],
\ [ 0xed00, 0xefce, 2 ],
\ [ 0xf000, 0xf2ff, 2 ],
\ [ 0xf300, 0xf375, 2 ],
\ [ 0xf400, 0xf533, 2 ],
\ [ 0xf0001, 0xf1af0, 2 ],
\ ])
```
### Neovim
Add this to your Neovim configuration:
```lua
-- Fix icon width for Nerd Fonts v3.2.1.
vim.fn.setcellwidths({
{ 0x23fb, 0x23fe, 2 }, -- IEC Power Symbols
{ 0x2665, 0x2665, 2 }, -- Octicons
{ 0x2b58, 0x2b58, 2 }, -- IEC Power Symbols
{ 0xe000, 0xe00a, 2 }, -- Pomicons
{ 0xe0c0, 0xe0c8, 2 }, -- Powerline Extra
{ 0xe0ca, 0xe0ca, 2 }, -- Powerline Extra
{ 0xe0cc, 0xe0d7, 2 }, -- Powerline Extra
{ 0xe200, 0xe2a9, 2 }, -- Font Awesome Extension
{ 0xe300, 0xe3e3, 2 }, -- Weather Icons
{ 0xe5fa, 0xe6b5, 2 }, -- Seti-UI + Custom
{ 0xe700, 0xe7c5, 2 }, -- Devicons
{ 0xea60, 0xec1e, 2 }, -- Codicons
{ 0xed00, 0xefce, 2 }, -- Font Awesome
{ 0xf000, 0xf2ff, 2 }, -- Font Awesome
{ 0xf300, 0xf375, 2 }, -- Font Logos
{ 0xf400, 0xf533, 2 }, -- Octicons
{ 0xf0001, 0xf1af0, 2 }, -- Material Design
})
```