Skip to content

Latest commit

 

History

History
58 lines (38 loc) · 2.37 KB

README.md

File metadata and controls

58 lines (38 loc) · 2.37 KB

fontpreview-ueberzug is a POSIX shell script to preview all fonts installed on system in fzf with ueberzug. It is inspired by fontpreview project while most of the code are completely rewritten here.

Dependencies

Install

Manual

Simply run the script, or put the script in your $PATH, or with provided makefile.

AUR

For Arch based users, fontpreview-ueberzug-git is available in AUR, thanks to @pabloariasal!

Usage

Usage: fontpreview-ueberzug [-h] [-a TEXT_ALIGN] [-s FONT_SIZE] [-b BG_COLOR] [-f FG_COLOR] [-t PREVIEW_TEXT]

Options:
    -a     alignment of preview text, you can use center, top/bottom/left/right or
           north/south/west/east, or combinations like topleft, default is center
    -s     preview font size, default is 72, note the actual size depends on the preview area
    -b, -f background and foreground color, default is #ffffff and #000000
    -t     preview text, you can add '\n' to split into lines

The arguments are passed directly to 'convert' command, you can check the ImageMagick documentation to find acceptable formats for them.

Tips

  • To merge the preview image into the terminal, set background color the same as that of the terminal emulator, this is not by default.

  • To show ligatures, you can use the following or any other text which contains ligature combination:

FONTPREVIEW_PREVIEW_TEXT="ABCDEFGHIJKLM\nNOPQRSTUVWXYZ\nabcdefghijklm\nnopqrstuvwxyz\n1234567890\n<!-- != == ->\n-| #[ |> <$> ~@" fontpreview-ueberzug

Configure

This script makes use of some of the environment variables as follows, these are the same in fontpreview so you can use the same settings with fontpreview-ueberzug:

  • FONTPREVIEW_FONT_SIZE
  • FONTPREVIEW_BG_COLOR
  • FONTPREVIEW_FG_COLOR
  • FONTPREVIEW_PREVIEW_TEXT
  • FONTPREVIEW_TEXT_ALIGN

Difference from fontpreview

  • Does not need two windows (terminal and sxiv) to display. Use ueberzug to display the preview image in terminal instead.
  • Preview updates as you scroll without having to press enter also going back to the first font in list.