Discontinued: I still like that app, but I gave up in the face of the dependency hell. Electron and React should not be used on base on a boiler plate template...
- shows pictures (jpg) in directories or playlists (txt, m3u)
- digital photo frame mode
- selects randomly folders and shows a handful pictures (so not like the standard digital photo frame, who jumps immediatly to the next folder => minimizes headache caused by context jumping...)
- filter directories by name snippets (white- and blacklists)
- filter images by rating or tags (xmp; white- and blacklists)
- favors images by rating
- integrated Exiftool
- show image details (date, rating, camera + lens models, gps location)
- open image location in browser (if any; predefined is openstreetmap)
- supports ICC color profiles
- fullscreen modus available
- transitions (at moment only crossfades)
- configuration via file (ini style) and some command line options
- runs on Linux and Windows
- screensaver mode: exits at the first mouse move or key press (see tools/screensaver.sh)
- able to block the system power saving for some time
- drag&drop images or directories (you can also drop several dirs at once => temporary playlist)
Download binaries from the release pages.
npm package manager is required.
$ git clone --depth=1 https://github.com/rosenloecher-it/roloviewer
# install prerequisites
$ npm install
# start development version
$ npm run dev
# start production version
$ npm start
# create linux binary
$ npm run package-linux
# create windows binary
$ npm run package-win
Most functionality is self explanatory - see menu or the hot key list (F1).
Some of the configuration has to be written into a file (e.g. filtering by tags and rating, blacklisting).
There are some commandline switches which overwrite the settings from config file.
Location:
- Linux: $HOME/.config/RoloViewer/roloviewer.ini
- Windows: %APPDATA%\RoloViewer\roloviewer.ini
- or see in menu help / about
[crawler]
# source folders (when choosing folder via menu, both entries are overwritten)
sourceFolders[]=/home/data/pictures/folder1
sourceFolders[]=/home/data/pictures/folder2
# shows picture ratings (whitelist)
showRatings[]=0
showRatings[]=3
showRatings[]=4
showRatings[]=5
# tag filter (whitelist), shows only pictures with containing these tags , (be careful!)
showTags[]=holiday
showTags[]=nice
# don't show pictures from thes folder (blacklist)
blacklistFolders[]=/home/data/pictures/office1
blacklistFolders[]=/home/data/pictures/exgirlfriends
# don't show pricture from folder, if the folder name contains one of these text snippets
blacklistFolderSnippets[]=office
blacklistFolderSnippets[]=exgirlfriends
# skip pictures, if the contain the folowing tags
blacklistTags[]=privat1
blacklistTags[]=privat2
# number of picture delivered from one folder at once
batchCount=10
# after x minutes the directories scann agein
updateDirsAfterMinutes=1440
[slideshow]
# text in details overlay (dialog) will be shorten to this length
detailsShortenText=50
# autoplay timer to go further (in milliseconds)
timer=7000
# transition time when auto playing (in milliseconds)
transitionTimeAutoPlay=3000
# transistion time when manually trigger next images (in milliseconds)
transitionTimeManual=600
[system]
# log level: error, warn, info, debug, silly
logLevel=debug
# disable system power saving for x minutes (restored on app exit too)
powerSaveBlockMinutes=30
# url template used for open image gps location in browser
# existing template tokens: $LATI_ABS$, $LATI_NUM$, $LATI_REF$, $LATI_REL$, $LONG_ABS$, $LONG_NUM$, $LONG_REF$, $LONG_REL$
mapUrlFormat="http://www.openstreetmap.org/?mlat=$LATI_NUM$>&mlon=$LONG_NUM$&zoom=15&layers=M"
Items are case sensitive!
- --autoselect / -a: Auto-select images (config source in config file)
- --configfile -c : Explicit config file ${defaultConfigInfo}
- --configreadonly: Do not wite changes to config file
- --fullscreen -f: Show fullscreen
- --help -h: show help message and exits
- --open -o: Open playlist or directory (default: using crawler)
- --play -p: Auto play items
- --random -r: random order (implicit in screensaver mode)
- --screensaver -s: Screensaver mode - quit at most user actions (mouse move + click, space)
-
Linux / AppImage - suppress questions for integrating into your system:
$ mkdir -p $HOME/.local/share/appimagekit/ $ touch $HOME/.local/share/appimagekit/no_desktopintegration
- Electron
- chentsulin/electron-react-boilerplate
- React
- Exiftool
- nedb
GPLv3 © Raul Rosenlöcher
The code is available at GitHub.