Skip to content

A cross-platform, simple and minimum, yet configurable photo viewer/slideshow/digital signage app for Windows, Linux, and Mac.

License

Notifications You must be signed in to change notification settings

quadroid/image-viewer

 
 

Repository files navigation

Image viewer/slideshow (Windows/Linux/Mac)

Simple, minimum, yet configurable photo viewer/slideshow/digital signage software for Windows, Linux, and macOS. Inspired by "feh" https://feh.finalrewind.org/

Download:

Windows version is available at the Microsoft Store. 

Feature:

  • Multiple viewing styles: 1. Normal window view, 2. "Windowless" view with slideshow, and 3. Fullscreen view with slideshow.
  • Full keyboard and mouse playback control.
  • Configurable options with command line parameters and popup menus.
  • Supports multiple moniters.

Usage:

Image Viewer can be launched by (1) double clicking the executable and selecting image files or (2) selecting image files or folders and using "send to" feature in Windows explorer (create "shortcut" file and place it to "shell:sendto" folder) or (3) command-line.

Command-line options:

Image Viewer can be launched via command-line, and applications or scripts can also launch Image Viewer with following options.

  • Slideshow interval in seconds (default 4 seconds):
    -i 4 or --interval=4

  • Slideshow random (default on):
    -r on or --random=on
    -r off or --random=off

  • Slideshow repeat (default on):
    -e on or --repeat=on
    -e off or --repeat=off

  • Slideshow start fullscreen (default off):
    -f on or --fullscreen=on
    -f off or --fullscreen=off

  • Slideshow transitional effect (default on):
    -t on or --effect=on
    -t off or --effect=off

  • Picture stretch In (fit to window/screen when the size is bigger than window/screen. default on):
    -n on or --stretchIn=on
    -n off or --stretchIn=off

  • Picture stretch Out (fit to window/screen when the size is smaller than window/screen. default off):
    -o on or --stretchOut=on
    -o off or --stretchOut=off

  • Load pictures in the sub folders as well when manually open a picture (default on):
    -u on or --includSubFolders=on
    -u off or --includSubFolders=off

  • Specify a moniter to show fullscreen slideshow (default 0 is the main moniter):
    -m 1 or --moniter=1

  • Specify window should stay on top (default off):
    -y on or --stayOnTop=on
    -y off or --stayOnTop=off

  • Help shows About dialog.
    -h or --help

Command-line Useage example:

$ ImageViewer -i 2 -f on -o on -e off C:\Users\<USER>\Pictures\Wallpapers\

Build instruction:

You can download the Lazarus IDE and FPC(compiler) from here. https://www.lazarus-ide.org/index.php?page=downloads

Or sudo apt install lazarus on Ubuntu.

Once you download and install the IDE, just open the project file "ImageViewer.lpr". When the project is opened, just hit F9 and run.

Compiled and tested on:

  • Windows 11: Lazarus 2.2.2 FPC 3.2.2 x86_64-win64-win32/win64
  • Windows 10: Lazarus 1.8.0 FPC 3.0.4 x86_64-win64-win32/win64
  • Ubuntu 22.04.1 LTS: Lazarus 2.2.0 FPC 3.2.2 x86_64-linux-gtk2
  • Ubuntu 17.10 (64bit): Lazarus 1.8.0 FPC 3.0.2 x86_64-linux-gtk2
  • Ubuntu 16.04 LTS (64bit): Lazarus 1.9.0 trunk, FPC 3.0.4
  • macOS 10.13.3 (64bit) High Sierra: Lazarus 1.8.0 rexported FPC 3.0.4 i386-darwin-carbon
  • macOS 10.11.6 (64bit) El Capitan: Lazarus 1.9.0 carbon trunk, FPC 3.0.4

Contributers

Russian translation (Nemo08) https://github.com/Nemo08

About

A cross-platform, simple and minimum, yet configurable photo viewer/slideshow/digital signage app for Windows, Linux, and Mac.

Resources

License

Stars

Watchers

Forks

Languages

  • Pascal 100.0%