Metadata-Version: 1.0
Name: imgdisplay
Version: 2016.12.24
Summary: UNKNOWN
Home-page: https://github.com/ericmjl/imgdisplay
Author: Eric J. Ma
Author-email: ericmajinglong@gmail.com
License: UNKNOWN
Description: # imgdisplay
        
        A simple Python app to display images in a standalone window.
        
        ## purpose
        
        I created this command-line app to enable anybody to display images in a random order when run from a given directory. It does nothing but this. Feel free to hack it to do something else!
        
        ## intended use cases
        
        - Raspberry Pi photo display.
        
        ## philosophy
        
        We should be hacking our own solutions where possible. Reduce dependency on closed-source tools.
        
        ## features
        
        The app effectively keeps monitoring the folder it was run from for new images. This means that if you dump in a new folder, it'll be automatically be added to the list of images that can be displayed. Likewise, if you remove it from the folder, it'll automatically be removed from the list of images that can be displayed. Empty folders also won't cause problems, it'll just display a note "No images in directory.", and continue refreshing every 5 seconds until you put in new images there.
        
        # installation
        
        Via `pip`:
        
        ```bash
        $ pip install imgdisplay
        ```
        
        Via `conda`:
        ```bash
        $ conda install imgdisplay
        ```
        
        # usage
        
        To run:
        
        ```bash
        $ cd /path/to/images/
        $ imgdisplay
        ```
        
        To view help & options:
        
        ```bash
        $ imgdisplay --help
         ```
        
        To close/exit: close the terminal window, or close the app window. Both will do just fine.
        
        # roadmap & future improvements
        
        - add ability to control time between refresh.
        
Platform: UNKNOWN
