ahodesuka / ahoviewer

A GTK image viewer, manga reader, and booru browser
MIT License
479 stars 30 forks source link
animated-gif booru-browser c-plus-plus image-viewer mangareader webm

ahoviewer

A GTK image viewer, manga reader, and booru browser.

Building

Dependencies

meson build
cd build
ninja
sudo ninja install

If you don't want to compile with debug symbols replace the first command with:

meson build --buildtype=release

Usage

ahoviewer

or

ahoviewer file[.zip|.rar|.webm|.(supported gdk-pixbuf file)]

Screenshot

Booru Browser

Plugins

Some example and usable plugins can be found at ahodesuka/ahoviewer-plugins

Plugins should be installed into $XDG_DATA_HOME/ahoviewer/plugins, $XDG_DATA_HOME is ~/.local/share by default. This is %LOCALAPPDATA%\ahoviewer\plugins on Windows. The .typelib file that is compiled must be installed via ninja install, or you will need to set the GI_TYPELIB_PATH environment variable to the directory where it is located after compilation.

FAQ

  1. My password/API key is not saved after restarting ahoviewer
  2. I get No results found on Danbooru
    • Danbooru only allows normal users to use 2 tags, if you have Maximum post rating set to anything other than Explicit it will count as one tag.
  3. I wish to use a proxy with ahoviewer
    • This can be done by setting the http_proxy and https_proxy environment variables respectively, this works on both GNU/Linux and Windows. See my comment in issue #61 for details.

Default Keybindings

Function Key
Open File Control+o
Open Preferences p
Close local image list or booru tab Control+w
Quit Control+q
Fullscreen f
Toggle Manga Mode g
Set Auto Fit Mode a
Set Fit Width Mode w
Set Fit Height Mode h
Set Manual Zoom Mode m
Zoom In Control+=
Zoom Out Control+-
Reset Zoom Control+0
Toggle Menubar Control+m
Toggle Statusbar Control+b
Toggle Scrollbars Control+l
Toggle Thumbnail bar (local image list) t
Toggle Booru Browser b
Hide all (hides the above widgets) i
Next Image Page Down
Previous Image Page Up
First Image Home
Last Image End
Toggle Slideshow s
New Booru Browser Tab Control+t
Save Booru Browser Tab Control+Shift+s
Save Image Shift+s
Save Image As Control+s
Delete Image Shift+Delete
Open Booru Post in Web Browser Control+Shift+o
Copy Booru Post URL to Clipboard Control+y
Copy Booru Image URL to Clipboard y
Copy Booru Image Data to Clipboard Control+Shift+y