https://github.com/xlucn/fontpreview-ueberzug

preview fonts in fzf
https://github.com/xlucn/fontpreview-ueberzug

font fzf preview shell ueberzug

Last synced: about 2 months ago
JSON representation

preview fonts in fzf

• Host: GitHub
• URL: https://github.com/xlucn/fontpreview-ueberzug
• Owner: xlucn
• License: mit
• Created: 2020-08-07T08:23:13.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2024-01-30T09:16:50.000Z (8 months ago)
• Last Synced: 2024-07-10T23:26:16.552Z (2 months ago)
• Topics: font, fzf, preview, shell, ueberzug
• Language: Shell
• Homepage:
• Size: 613 KB
• Stars: 161
• Watchers: 5
• Forks: 11
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
`fontpreview-ueberzug` is a POSIX shell script to preview all fonts installed on system in `fzf` with `ueberzug`. It is inspired by [fontpreview](https://github.com/sdushantha/fontpreview) project while most of the code are completely rewritten here.

![](./demo.gif)

## Dependencies

- [`fzf`](https://github.com/junegunn/fzf)

- [`ueberzug`](https://github.com/seebye/ueberzug)

- `imagemagick`

## 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](https://aur.archlinux.org/packages/fontpreview-ueberzug-git), 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