{"id":13683488,"url":"https://github.com/thimc/vifmimg","last_synced_at":"2025-07-22T01:02:26.349Z","repository":{"id":34701044,"uuid":"173590885","full_name":"thimc/vifmimg","owner":"thimc","description":"Image previews for Vifm (vi file manager) using Überzug","archived":false,"fork":false,"pushed_at":"2024-01-16T15:48:46.000Z","size":390,"stargazers_count":243,"open_issues_count":7,"forks_count":27,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-05-19T18:11:28.637Z","etag":null,"topics":["filepreview","image","ueberzug","vifm"],"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/thimc.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":"2019-03-03T15:11:59.000Z","updated_at":"2025-05-13T10:24:33.000Z","dependencies_parsed_at":"2024-08-02T13:24:02.951Z","dependency_job_id":"8cc3798c-5bc1-4a14-ae79-8b4f1329122b","html_url":"https://github.com/thimc/vifmimg","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/thimc/vifmimg","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thimc%2Fvifmimg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thimc%2Fvifmimg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thimc%2Fvifmimg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thimc%2Fvifmimg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thimc","download_url":"https://codeload.github.com/thimc/vifmimg/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thimc%2Fvifmimg/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266405361,"owners_count":23923533,"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","status":"online","status_checked_at":"2025-07-21T11:47:31.412Z","response_time":64,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"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":["filepreview","image","ueberzug","vifm"],"created_at":"2024-08-02T13:02:12.962Z","updated_at":"2025-07-22T01:02:26.159Z","avatar_url":"https://github.com/thimc.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# Image previews using Überzug for vifm (vi file manager)\n\n![image](https://raw.githubusercontent.com/cirala/vifmimg/master/screenshot.png)\n\nThis script is used along [vifm](https://github.com/vifm/vifm) to generate image previews for various file types in vifm.\n\n\nIf you want image preview support for [lf](https://github.com/gokcehan/lf) check out [cirala/lfimg](https://github.com/cirala/lfimg).\n\n\nThe script is currently able to handle the following formats:\n* Video\n* Pdf\n* Djvu\n* eBook\n* Images\n* Audio files\n* Fonts\n\nAll previews are cached (except for regular images) and stored in your **~/.cache/vifm/** folder.\n\n\n## Installation\n1. Copy the **vifmimg** and **vifmrun** scripts to a folder that is included in your $PATH\nvariable for easy access to the files.\n\n2. Edit your **~/.config/vifm/vifmrc** file and add fileviewer properties like so:\n```\n    fileviewer *.pdf\n        \\ vifmimg pdf %px %py %pw %ph %c\n        \\ %pc\n        \\ vifmimg clear\n\n    fileviewer *.djvu\n        \\ vifmimg djvu %px %py %pw %ph %c\n        \\ %pc\n        \\ vifmimg clear\n\n    fileviewer *.epub\n        \\ vifmimg epub %px %py %pw %ph %c\n        \\ %pc\n        \\ vifmimg clear\n\n    fileviewer \u003cvideo/*\u003e\n        \\ vifmimg video %px %py %pw %ph %c\n        \\ %pc\n        \\ vifmimg clear\n\n    fileviewer \u003cimage/*\u003e\n        \\ vifmimg draw %px %py %pw %ph %c\n        \\ %pc\n        \\ vifmimg clear\n\n    fileviewer \u003caudio/*\u003e\n        \\ vifmimg audio %px %py %pw %ph %c\n        \\ %pc\n        \\ vifmimg clear\n\n    fileviewer \u003cfont/*\u003e\n        \\ vifmimg font %px %py %pw %ph %c\n        \\ %pc\n        \\ vifmimg clear\n\n```\n\n3. In order to launch vifm with image preview support from now on, you will need to use the supplied **vifmrun** script.\n\nI recommend that you make an alias in your shell that points to vifm.\n\n\n## Prerequisites\n* [Überzug](https://github.com/seebye/ueberzug) and [Vifm](https://github.com/vifm/vifm) (isn't this obvious?)\n* [ffmpegthumbnailer](https://github.com/dirkvdb/ffmpegthumbnailer)\n* ImageMagick\n* pdftoppm (Available in the AUR as `poppler` package.)\n* [ddjvu](http://djvu.sourceforge.net/doc/man/ddjvu.html) (Contains in the Debian/Ubuntu `djvulibre-bin` package.)\n* [epub-thumbnailer](https://github.com/marianosimone/epub-thumbnailer)\n* [fontpreview](https://github.com/sdushantha/fontpreview)\n\n## Credits\n* Seebye for creating [Überzug](https://github.com/seebye/ueberzug) and the initial script\nthat this script is heavily based upon.\n* [Ranger's](https://github.com/ranger/ranger) approach to file previewing as an\ninspiration source.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthimc%2Fvifmimg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthimc%2Fvifmimg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthimc%2Fvifmimg/lists"}