anonymoux47 / termvisage

Browse and view images in the terminal (mostly a front-end to https://github.com/AnonymouX47/term-image)

Hi there 👋

I'm a software engineer, linux user, hubby gamer...

I spend most of my time buried in terminals - learning and solving problems.

"No matter how much you know, there's always more you don't know than you know"

- Nobody

Github Stats

I’m currently working on ...

• term-image
• termvisage

Contact

• Discord: @anonymoux47
• LinkedIn
• Email: somewhere on this page

---

Note

I prefer to go by my username anywhere, anytime, with the exception of official situations.

Thanks!

termvisage's Issues

[Feature Reuqest] Customize the open action

Currently, this tool can provide the ability to view images on the terminal, but it does not support the follow-up action after finding the desired image.

For example, if I find this image, I want to open it with some other tool, delete it, set it as a wallpaper, etc.

It is not necessary for the tool to do these specific actions, but if a key is pressed after selecting an image to exit the current tui and output the path of the selected image, then other tools can read the path and do subsequent things.

Enquiry for supporting vscode terminal

Is your feature request related to a problem? Please describe.
Most of cases I use vscode tunnel to access remote server for convenience. Without proxy, ssh access within normal simluater (e.g. iTerm2) is impossible.

Describe the solution you'd like
It would be great if termvisage can support vscode internal terminal simulater.

Describe alternatives you've considered
Of course, I can use proxy to use ssh in iTerm2. Also, if tmux will supported soon, it should be a great alternative, since I'm able to run tmux inside vscode directly.

Additional context
Add any other context or screenshots about the feature request here.

Displaying high-res images in the TUI

Description

some picture can show in termvisage but can't show in termvisage -r

To Reproduce
Steps to reproduce the behavior:

1. cd ~/Images
2. termvisage yh.jpg
3. termvisage -r

Expected behavior

can't show the same picturn in termvisage -r

Screenshots

Desktop (please complete the following information, if applicable):

• OS: arch
• Kernel version 6.5.7-arch1-1

Package info:

• Python version: Python 3.11.5
• Package version: 0.1.0
• Installation method:pipx

Terminal Emulator:

• Name:konsole
• Version:23.08.4

Additional context
Add any other context about the problem here.

adding file properties information displayed

@AnonymouX47
I like it :)

Great! 👍

Maybe future request: adding filesize into the border

I looked into a couple of image viewers with grid views and this is not typical or even rare. I'm not saying it's bad or I don't want something different from the norm (this whole project already is 😁), it just feels a little odd. Also, I don't think file size is that much a crucial property of an image to given such an highlight (just a personal opinion).

Or print this and more information (picture pixel measurements at the bottom frame)

I think I can work with this as it's much closer to the typical and gives room for way more information 🤔... I'll appreciate it if you can open a new issue requesting this feature so we can track things over there.

Side note: I also have plans for an info/properties panel or pop-up (prefer the later) that'll contain these details along with other available metadata.

Thanks so much. 😃

E.g. when using termvisage as a file picker it would be handy if somewhere the size of the selected pictures is displayed (e.g. selecting files for E-Mail attachment it's crucial to not exceed the attachment limit size).

Pixelated image instead of high resolution with iTerm2.

Hi. Thank you for the amazing work. I am trying to print some images to the iTerm2 terminal. However, by using the default settings, I only get pixelated images instead of high-resolution ones. #7 might be related to this problem but I did not use tmux. I am wondering if any one could help! Thanks!

Description
Cannot display high resolution image. #7 might be related.

To Reproduce

pipx install termvisage
wget https://user-images.githubusercontent.com/61663146/235449392-b464ff19-82ac-4c55-9244-e718bc999e98.png
termvisage 235449392-b464ff19-82ac-4c55-9244-e718bc999e98.png

Expected behavior
Expect to see a high resolution image instead of pixelated image.

Screenshots

Desktop (please complete the following information, if applicable):

• OS: Ubuntu
• Version 22.04

Package info:

• Python version: 3.9.17
• Package version: 0.1.0
• Installation method: PyPI

Terminal Emulator:

• Name: iTerm2
• Version: 3.4.23

term-image to respect XDG Base Directories Specification

Is your feature request related to a problem? Please describe.
Currently term-image stores and writes configuration files to $HOME/.term_image/

Describe the solution you'd like
If the system has XDG_CONFIG_HOME set, please place configurations there (there may be other considerations, see XDG Base Directories Specification)

Describe alternatives you've considered
Thought about a symlink, but that still leaves another line of output when listing the home directory

Image grid crashes the TUI

Description

termvisage --tui -r ~/Pictures -v
Using 'kitty' render style
Processing sources...
Checking '/home/t/Pictures'
... Done!
Session not ended successfully: (urwid.widget.widget.WidgetError) Widget <LineSquare selectable box widget <Image selectable box widget>> rendered (30 x 15) canvas when passed size (30, 1)!

termvisage --tui .
 File "/home/t/.local/pipx/venvs/termvisage/lib/python3.11/site-packages/urwid/widget/widget.py", line 92, in validate_size
    raise WidgetError(
urwid.widget.widget.WidgetError: Widget <LineSquare selectable box widget <Image selectable box widget>> rendered (30 x 15) canvas when passed size (30, 1)!
(797887) (2024-03-29 14:07:14,435) [CRITICAL] termvisage: Session not ended successfully: (urwid.widget.widget.WidgetError) Widget <LineSquare selectable box widge

Desktop (please complete the following information, if applicable):

• OS: Ubuntu 23.10

• Kernel version 6.5.0-26-generic

• Python version: Python 3.11.6

• Installation method: pipx install termvisage

termvisage --version 0.1.0

Terminal Emulator:

kitty 0.33.1

same Error on

• konsole
• gnome-terminal
• wezterm

Image organization tools - tagging/albums/scratch

Is your feature suggestion related to a problem? Please describe.
Yes, the problem is I hate GUI's and want to use this TUI app instead of gthumb/pix for tagging/albums/collecting/finding/organizing images im using.

Describe the solution you'd like
Because I want to ask a lot, I want to be able to do EVERYTHING like gthumb/pix does.

• multiple image selection
• ability to "tag" them with embedded or external metadata
• view specific "tags" within a whole folder structure
• maybe an "album/collection" view with all items that were assigned, using some external/app created metadata/cache referencing the paths
• collections/albums/tags maybe pinned in left pane? or as tabs across the top/bottom
• scratch "selections" ability to navigate via keyboard and use keyboard shortcut to assign individual images to a "scratch" selection. where i can select images all over the place individually and press alt+1,2,3 and assign it to a "numbered scratch selection" that is lost on exit, but while in-app, i can recall/selectall of the ones i added to the scratch. so instead of individually selecting images and tagging, i can add them to the scratch selection, then recall the selection of all those images and tag them at once?
• slideshow view / contact sheet / X-up views of the collections/albums/tags

Describe alternatives you've considered
There is no alternative, these must be done now.

Additional context
i like turtles

i have jokes

Pixelated image instead of high resolution im age displayed by default settings

Description
Cannot display high resolution image.

To Reproduce
Steps to reproduce the behavior:

1. pipx install termvisage
2. wget https://user-images.githubusercontent.com/61663146/235449392-b464ff19-82ac-4c55-9244-e718bc999e98.png
3. termvisage 235449392-b464ff19-82ac-4c55-9244-e718bc999e98.png

Expected behavior
Expect to see a high resolution image instead of pixelated image.

Screenshots

Desktop (please complete the following information, if applicable):

• OS: Ubuntu
• Version: 23.04
• Kernel version (if applicable): 6.2.0

Smartphone (please complete the following information, if applicable):

• Device: [e.g. Samsumg S20]
• OS: [e.g. Android]
• Version [e.g. 9 (Pie)]

Package info:

• Python version: 3.11.2
• Package version: 0.1.0 (note there is no -V arg)
• Installation method: pipx

Terminal Emulator:

• Name: Gnome Terminal, Kitty
• Version: 3.48.0, 0.26.5

Additional context
Add any other context about the problem here.

better color contrast for disabled menu options

I have big trouble to see the disabled parts because of the current coloring (grey text + blue bg).

Maybe change it to something with better contrast.