{"id":13419839,"url":"https://github.com/sdushantha/fontpreview","last_synced_at":"2025-05-16T11:02:25.793Z","repository":{"id":39573165,"uuid":"239129983","full_name":"sdushantha/fontpreview","owner":"sdushantha","description":"Highly customizable and minimal font previewer written in bash","archived":false,"fork":false,"pushed_at":"2024-06-29T13:03:07.000Z","size":6357,"stargazers_count":943,"open_issues_count":19,"forks_count":40,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-04-09T05:04:27.007Z","etag":null,"topics":["bash","cli","commandline","font-size","fontpreview","fonts","fontviewer","fuzzy-search","linux"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sdushantha.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-02-08T12:37:10.000Z","updated_at":"2025-04-08T13:51:51.000Z","dependencies_parsed_at":"2024-11-13T14:40:14.217Z","dependency_job_id":"f5b5b03c-390a-4ec0-bf7a-4a43f66bcb49","html_url":"https://github.com/sdushantha/fontpreview","commit_stats":{"total_commits":55,"total_committers":13,"mean_commits":4.230769230769231,"dds":0.5636363636363637,"last_synced_commit":"82533a6d76310737fcecf4694067ff5df5a5fc58"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdushantha%2Ffontpreview","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdushantha%2Ffontpreview/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdushantha%2Ffontpreview/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdushantha%2Ffontpreview/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sdushantha","download_url":"https://codeload.github.com/sdushantha/fontpreview/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254518383,"owners_count":22084374,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","cli","commandline","font-size","fontpreview","fonts","fontviewer","fuzzy-search","linux"],"created_at":"2024-07-30T22:01:21.711Z","updated_at":"2025-05-16T11:02:25.743Z","avatar_url":"https://github.com/sdushantha.png","language":"Shell","readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"extra/logo.png\"\u003e\u003cbr\u003e\u003csub\u003e✨ Very customizable and minimal font previewer written in bash ✨\u003c/sub\u003e\u003c/p\u003e\n\n`fontpreview` is a commandline tool that lets you **quickly search** for fonts\nthat are installed on your machine and preview them. The **fuzzy search** feature\nis provided by `fzf` and the preview is generated with `imagemagick` and then\ndisplayed using `nsxiv`. This tool is **highly customizable**, almost all of the\nvariables in this tool can be changed using the commandline flags or you can\nconfigure them using environment variables.\n\n![](extra/demo.gif)\n\n## Dependencies\n\n- `xdotool`\n- `fzf`\n- `imagemagick`\n- `nsxiv`\n\n## Installation\n### Install using `make`\n```bash\n# Clone the repo\n$ git clone https://github.com/sdushantha/fontpreview\n\n# Change your current directory to fontpreview\n$ cd fontpreview\n\n# Install it\n$ sudo make install\n```\n\n### Install it locally\n```bash\n# Download the fontpreview source code, save as fontpreview\n# and make it executeable\n$ curl -L https://git.io/raw_fontpreview \u003e fontpreview \u0026\u0026 chmod +x fontpreview\n\n# Then move fontpreview to somewhere in your $PATH\n# Here is an example\n$ mv fontpreview ~/scripts/\n```\n\n## Usage\n```\n$ fontpreview --help\nusage: fontpreview [-h] [--size \"px\"] [--position \"+x+y\"] [--search-prompt SEARCH_PROMPT]\n                   [--font-size \"FONT_SIZE\"] [--bg-color \"BG_COLOR\"] [--fg-color \"FG_COLOR\"]\n                   [--preview-text \"PREVIEW_TEXT\"] [-i font.otf] [-o preview.png] [--version]\n\n┌─┐┌─┐┌┐┌┌┬┐┌─┐┬─┐┌─┐┬  ┬┬┌─┐┬ ┬\n├┤ │ ││││ │ ├─┘├┬┘├┤ └┐┌┘│├┤ │││\n└  └─┘┘└┘ ┴ ┴  ┴└─└─┘ └┘ ┴└─┘└┴┘\nVery customizable and minimal font previewer written in bash\n\noptional arguments:\n   -h, --help            show this help message and exit\n   -i, --input           filename of the input font (.otf, .ttf, .woff are supported)\n   -o, --output          filename of the output preview image (input.png if not set)\n   --size                size of the font preview window\n   --position            the position where the font preview window should be displayed\n   --search-prompt       input prompt of fuzzy searcher\n   --font-size           font size\n   --bg-color            background color of the font preview window\n   --fg-color            foreground color of the font preview window\n   --preview-text        preview text that should be displayed in the font preview window\n   --version             show the version of fontpreview you are using\n```\n\nIf you want to generate a preview image for a **single** font file\n(.otf, .ttf, and .woff are supported), use the `-i` and `-o` option\nto indicate the filename of the input font and the output preview\nimage.\n\n```\n$ fontpreview -i font.otf -o preview.png\n```\n\nThis can be used with [überzug](https://github.com/seebye/ueberzug)\nto implement font preview within terminal file managers such as\n[vifm](https://vifm.info/).\n\n![](extra/vifm.png)\n\nA detailed setup instructions can be found [here](https://krasjet.com/scribbles/font-preview.html)\n\n\n## Configure\nYou can configure `fontpreview` through environment variables.\n\nThis can be in your `.bashrc`, `.zshrc`, etc\n\n```bash\n# Input prompt of fuzzy searcher\nexport FONTPREVIEW_SEARCH_PROMPT=\"❯ \"\n\n# Size of the font preview window\nexport FONTPREVIEW_SIZE=532x365\n\n# The position where the font preview window should be displayed\nexport FONTPREVIEW_POSITION=\"+0+0\"\n\n# Font size\nexport FONTPREVIEW_FONT_SIZE=38\n\n# Background color of the font preview window\nexport FONTPREVIEW_BG_COLOR=\"#ffffff\"\n\n# Foreground color of the font preview window\nexport FONTPREVIEW_FG_COLOR=\"#000000\"\n\n# Preview text that should be displayed in the font preview window\nexport FONTPREVIEW_PREVIEW_TEXT=\"ABCDEFGHIJKLM\\nNOPQRSTUVWXYZ\\nabcdefghijklm\\nnopqrstuvwxyz\\n1234567890\\n!@$\\%(){}[]\"\n```\n","funding_links":[],"categories":["Shell"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsdushantha%2Ffontpreview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsdushantha%2Ffontpreview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsdushantha%2Ffontpreview/lists"}