viewd

An image viewer server and client for viewing images on a remote box (presumably with monitor connected). It uses sdl2 for image display and TCP for network communication. All connections are encrypted and mutually authorized through TLS. Network protocol borrows heavily from tokio's mini-redis project.

Only tested on linux.

features

• fast startup on large image collections
• pageant mode (automatically advance through image collection)
• TLS mutual authentication

usage

The server requires --path parameter to declare filesystem location from which application will load images. Be aware that some setup is required for network security. See setup section below.

on the display box:

cargo run --bin viewd-server -- --path ~/dir/photos/

on the client:

cargo run --bin viewd-tui

Please see --help for information about additional configuration and options.

commands

Currently supported commands are

• -> (arrow right) next image
• <- (arrow left) previous image
• f fullscreen
• r rotate
• p pageant mode (automatically scroll through the images)
• q quit (the client)

pageant make the image advance automatically every second. The rest should be self explanitory.

setup

Networking is setup to use TLS by default, so you will first need to configure certificates. I made the myca utility to assist with this. There are also online scripts that do the same. Then make sure your configuration files point to the correct keys and certificates. Useful defaults and examples have been supplied, pass --help option to each command for more information. For a connection to succeed, host name of server in end entity cert must match host client is making request to. So an update to your favorite name service is required. An easy option is to assign the server a name in the client's /etc/hosts.

viewd-cli

In a addition to the TUI, there is also a cli. You can get its usage by passing the --help option.

cargo run --bin viewd-cli -- --help

Todo

• lots of stuff
• ???

system dependencies

You need sdl libraries on your OS. Mileage may vary depending on system, but on debian-like apt can obtain them for you:

sudo apt-get install libsdl2-image-2.0-0

display

You may need to export your display. :1 may or may not be correct depending on your system.

export DISPLAY=:1

development

You will need development libraries for builds to complete.

sudo apt-get install libsdl2-image-dev