{"id":27184184,"url":"https://github.com/felipefacundes/fontpreview","last_synced_at":"2026-04-13T13:01:40.121Z","repository":{"id":286903873,"uuid":"962937951","full_name":"felipefacundes/fontpreview","owner":"felipefacundes","description":"A lightning-fast, terminal-based font previewer with Sixel graphics support, designed for designers and developers who work with fonts in Linux/Unix environments.","archived":false,"fork":false,"pushed_at":"2025-04-08T23:43:53.000Z","size":3078,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-10-11T08:17:27.585Z","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":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/felipefacundes.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":"2025-04-08T22:53:28.000Z","updated_at":"2025-10-11T01:19:35.000Z","dependencies_parsed_at":"2025-04-10T05:16:10.993Z","dependency_job_id":"66bd6d51-d8c6-4d81-bb9c-793e4a4c5476","html_url":"https://github.com/felipefacundes/fontpreview","commit_stats":null,"previous_names":["felipefacundes/fontpreview"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/felipefacundes/fontpreview","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipefacundes%2Ffontpreview","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipefacundes%2Ffontpreview/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipefacundes%2Ffontpreview/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipefacundes%2Ffontpreview/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/felipefacundes","download_url":"https://codeload.github.com/felipefacundes/fontpreview/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipefacundes%2Ffontpreview/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31753551,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T09:16:15.125Z","status":"ssl_error","status_checked_at":"2026-04-13T09:16:05.023Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":"2025-04-09T16:38:15.256Z","updated_at":"2026-04-13T13:01:40.098Z","avatar_url":"https://github.com/felipefacundes.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Font Preview ✨\n\n[![License: GPLv3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n[![Version](https://img.shields.io/badge/Version-1.0-green)](https://github.com/felipefacundes/fontpreview)\n[![Shell](https://img.shields.io/badge/Shell-Bash-lightgrey)](https://www.gnu.org/software/bash/)\n\nA lightning-fast, terminal-based font previewer with Sixel graphics support, designed for designers and developers who work with fonts in Linux/Unix environments.\n\nThis script is part of the **[shell_utils](https://github.com/felipefacundes/shell_utils)** framework, one of the largest collections of scripts and utilities aimed at simplifying and enhancing user experience in the terminal.\n![Demo Animation](FontPreview.gif)\n\n## Features 🌟\n\n- 🖼️ **Interactive previews** with real-time rendering\n- 🎨 **Fully customizable** colors, sizes, and sample text\n- 📋 **Automatic clipboard** integration (supports X11, Wayland, Termux)\n- 🔍 **Fuzzy search** through all available system fonts\n- 🖌️ **Image export** capability for documentation\n- 📱 **Termux/Android** compatible\n- 🎚️ **Environment variable** configuration\n- 🌈 **Sixel graphics** support for modern terminals\n\n## Installation 📦\n\n### Prerequisites\n```bash\n# Debian/Ubuntu\nsudo apt install imagemagick fzf\n\n# Arch Linux\nsudo pacman -S imagemagick fzf\n\n# Fedora\nsudo dnf install ImageMagick fzf\n\n# macOS (via Homebrew)\nbrew install imagemagick fzf\n```\n\n### Install Script\n```bash\nwget https://raw.githubusercontent.com/felipefacundes/fontpreview/main/fontpreview -O ~/.local/bin/fontpreview\nchmod +x ~/.local/bin/fontpreview\n```\n\n## Usage 🚀\n\n### Basic Interactive Mode\n```bash\nfontpreview\n```\n\n### Custom Preview Settings\n```bash\nfontpreview --margin-height 90 --size \"1200x800\" --font-size 36 --bg-color \"#290a04\" --fg-color \"#f5e0c9\"\n```\n\n### Export to Image\n```bash\nfontpreview -i \"FiraCode.otf\" -o \"fira_preview.png\"\n```\n\n### Show Help\n```bash\nfontpreview --help\n```\n\n## Configuration ⚙️\n\nCustomize defaults through environment variables (add to your `.bashrc`/`.zshrc`):\n\n```bash\nexport FONT_SIZE=36\nexport SIZE=\"1200x800\"\nexport BG_COLOR=\"#290a04\"\nexport FG_COLOR=\"#f5e0c9\"\nexport PREVIEW_TEXT=\"Custom Preview Text\\n1234567890\\nABCDEFGHIJKLMNOPQRSTUVWXYZ\"\nexport FZF_MARGIN_R=70  # Right margin percentage\nexport FZF_MARGIN_H=90  # Height percentage\n```\n\n## Keybindings ⌨️\n\nWhile in interactive mode:\n- `↑`/`↓` - Navigate font list\n- `Enter` - Select font (copies to clipboard)\n- `Esc`/`Ctrl+C` - Exit\n\n## Supported Terminals 🖥️\n\nFor best experience, use a Sixel-compatible terminal:\n- [WezTerm](https://wezfurlong.org/wezterm/)\n- [Contour](https://github.com/contour-terminal/contour)\n- [XTerm with VT340 emulation](https://invisible-island.net/xterm/)\n- [Alacritty with Sixel patch](https://github.com/microo8/alacritty-sixel)\n\n## Troubleshooting 🔧\n\n**Problem:** Preview not displaying  \n**Solution:** Ensure your terminal supports Sixel graphics or install `feh` as fallback:\n```bash\nsudo pacman -S feh  # ArchLinux\nsudo apt install feh  # Debian/Ubuntu\n```\n\n**Problem:** Missing fonts  \n**Solution:** Specify exact path with `-i` flag  \n**Install:** To install additional fonts, use the `--install` flag and provide the font file exact path with `-i`  \n\n## Contributing 🤝\n\nPull requests are welcome! For major changes, please open an issue first to discuss proposed changes.\n\n## License 📜\n\nThis project is licensed under the GPLv3 License - see the [LICENSE](LICENSE) file for details.\n\n---\n\nCrafted with ❤️ by [Felipe Facundes]","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelipefacundes%2Ffontpreview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffelipefacundes%2Ffontpreview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelipefacundes%2Ffontpreview/lists"}