Package: termvisage
TermVisageBrowse and view images in the terminal📖Manual║ 
   🖼GalleryContentsInstallationFeaturesDemoQuick StartUsageContributionPlanned FeaturesKnown IssuesFAQsCreditsSponsor This ProjectInstallationRequirementsOperating System: Unix / Linux / Mac OS X / Windows (limited support, see theFAQs)Python>= 3.7A terminal emulator withanyof the following:support for theKitty graphics protocol.support for theiTerm2 inline image protocol.full Unicode support and ANSI 24-bit color supportPlans to support a wider variety of terminal emulators are in motion(see thelibrary's planned features).StepsThe latest version can be installed fromPyPIusingpipxwith:pipxinstalltermvisageand upgraded with:pipxupgradetermvisageNOTE:pipcan also be used butpipxis recommended.FeaturesAlmost everything theterm-imagelibrary supportsDisplay individual imagesBrowse multiple images and directories (recursively)Adjustable image gridsContext-based controlsCustomizable controls and configuration optionsSmooth and performant experienceShell completion for command-line argumentsand more... 😁DemoMultiple Render Stylesblockiterm2kittyHigh-Resolution ImagesVideo DemoDemo VideoGalleryCheck out theGalleryfor more.Quick StartWith a file path:termvisagepath/to/image.pngWith a URL:termvisagehttps://www.example.com/image.pngWith a directory, recursively (not currently supported on Windows):termvisage-rpath/to/dir/If a single source is given and it's animated (GIF, APNG, Animated WebP), the animation is infinitely looped bydefaultand can be stopped withCtrl-C(SIGINT).Bydefault, if multiple sources or at least one directory source is given, the TUI (Terminal User Interface) is launched to navigate through the images and/or directories.UsageCLI (Command-Line Interface)Runtermvisage --helpto see the basic help message ortermvisage --long-helpfor the full help message.See theCLI manual.TUI (Terminal User Interface)The controls arecontext-basedand always displayed at the bottom of the screen.
Pressing theF1key (in most contexts) brings up ahelpmenu describing the available controls (calledactions) in that context.The TUI can be configured using a config file. See theConfigurationsection of the docs.Hereis a config file with Vim-style key-bindings (majorly navigation).See theTUI manual.ContributionIf you've found any bug or want to suggest a new feature, please open a newissuewith proper description, after browsing/searching through the existing issues and making sure you won't create a duplicate.For code contributions, please read through theguidelines.Also, check out thePlanned Featuressection below.
If you wish to work on any of the listed tasks, please click on the linked issue or go through theissuestab and join in on an ongoing discussion about the task or create a new issue if one hasn't been created yet, so that the implementation can be discussed.Hint: You can filter issues bylabelor simplysearchusing the task's name or description.For anything other than the above (such as questions or anything that would fit under the term "discussion"), please open a newdiscussioninstead.Thanks! 💓Planned FeaturesSeehere.Known IssuesSeehere.FAQsSee theFAQssection of the docs.CreditsThe following projects have been (and are still) crucial to the development of this project:term-imageby@AnonymouX47PillowbyFredrik Lundh, Jeffrey A. Clark (Alex) and contributorsUrwidbyIan Ward et alargcompletebyAndrey KislyukThe logo was composed using resource(s) from the following source(s):Gallery icons created by Andrean Prabowo - FlaticonThanks to@digitallyservicedfor the project name and logo concept.Sponsor This ProjectAny amount will go a long way in aiding the progress and development of this project.
Thank you! 💓