Metadata-Version: 2.1
Name: nichtparasoup
Version: 2.2.2
Summary: A hackspaces entertainment system
Home-page: https://github.com/k4cg/nichtparasoup/
Author: K4CG
Author-email: info@k4cg.org
License: MIT
Project-URL: Source, https://github.com/k4cg/nichtparasoup/
Project-URL: Documentation, https://github.com/k4cg/nichtparasoup/tree/master/docs
Description: 
        # nichtparasoup
        
        [![PyPI](https://img.shields.io/pypi/v/nichtparasoup)](https://pypi.org/project/nichtparasoup/)
        ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/nichtparasoup)  
        ![Test Status](https://img.shields.io/github/workflow/status/k4cg/nichtparasoup/Test)
        [![Sonar Quality Gate](https://img.shields.io/sonar/quality_gate/nichtparasoup?server=https%3A%2F%2Fsonarcloud.io)](https://sonarcloud.io/dashboard?id=nichtparasoup)
        [![Codecov](https://img.shields.io/codecov/c/github/k4cg/nichtparasoup)](https://codecov.io/gh/k4cg/nichtparasoup/branch/master)  
        
        
        ----
        
        
        _nichtparasoup_ is a hackspaces entertainment system.
        It randomly displays images from
        [instagram](https://instagram.com) and
        [reddit](https://reddit.com).  
        Other crawlers are currently removed, but will be back soon.
        
        If you find an ImageCrawler for your favourite ImageBoard missing, feel free to write an own ImageCrawler therefore.  
        Contribute it to the _nichtparasoup_ project or write it as a independent plugin :-)
        
        
        ![logo](https://raw.githubusercontent.com/k4cg/nichtparasoup/master/images/logo.png)
        
        
        ---
        
        
        At our hackspace [k4cg](https://k4cg.org) we use it since years now.  
        It turns out to be a very non-invasive way of entertaining a crowd of nerds 
        without having the noise and interruptions of videos or other stuff.
        
        Here is what it looks like in your browser
        ![screenshot](https://raw.githubusercontent.com/k4cg/nichtparasoup/master/images/screenshot.png)
        
        and even better, on a video projector in your local hackspace!
        ![hackspace](https://raw.githubusercontent.com/k4cg/nichtparasoup/master/images/hackspace.jpg)
        
        
        ## How it works
        
        Images are crawled from multiple public pre-configured sources.  
        No image is actually downloaded, just the URL to images are gathered. Found images are kept in a list, also it is
        assured that the same URL is never gathered twice.
        
        To display the crawled images, _nichtparasoup_ starts a web-server display a web UI.  
        The web UI fetches a random image URL from the _nichtparasoup_ server one by one. 
        
        The web UI will load new images continuously, unless one of the following events happen:
        * paused manually in the web UI
        * scroll position in web UI is not on top
        * window or tab lost focus
        * web UI is in image theater/zoom mode
        * boss mode is active in web UI
        
        In the web UI the images are downloaded from the original source. Also the original source is linked and marked by
        an icon. Just hover or click the icon in the bottom right of an image.
        
        Every time _nichtparasoup_ serves an image URL it also removes it from its list. This means an image URL is served
        only once - unless the server was reset. (This might change in the future)
        
        
        ## Demo
        
        Visit [nicht.parasoup.de/demo/](http://nicht.parasoup.de/demo/) to try it!
        
        
        ## Install, Usage, Config, etc 
        
        see the [docs](https://github.com/k4cg/nichtparasoup/tree/master/docs).
        
        
        ## ImageCrawler (plugin) development
        
        see the [docs](https://github.com/k4cg/nichtparasoup/tree/master/docs/plugin-development).
        
        
        ## License
        
        MIT - see the [`LICENSE`](https://github.com/k4cg/nichtparasoup/blob/master/LICENSE) file for details.
        
        
        ## Credits
        
        * see the [`AUTHORS`](https://github.com/k4cg/nichtparasoup/blob/master/AUTHORS) file 
           for a list of essential contributors.
        * parts of the logo are taken
           from [Smashicons](https://www.flaticon.com/authors/smashicons)
           on [www.flaticon.com](https://www.flaticon.com/)
           are licensed [CC BY 3.0](https://creativecommons.org/licenses/by/3.0/).
        
Keywords: image-crawler,reddit,instagram
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Typing :: Typed
Requires-Python: >=3.5
Description-Content-Type: text/markdown
Provides-Extra: colors
Provides-Extra: development
Provides-Extra: testing
