Skip to main content

A hackspaces entertainment system

Project description

nichtparasoup

PyPI PyPI - Python Version
Test Status Sonar Quality Gate Codecov


nichtparasoup is a hackspaces entertainment system. It randomly displays images from instagram, pr0gramm and reddit.
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 an independent plugin :-)

logo


At our hackspace k4cg 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

and even better, on a video projector in your local hackspace! hackspace

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/ to try it!

Install, Usage, Config, etc

see the docs.

ImageCrawler (plugin) development

see the docs.

License

MIT - see the LICENSE file for details.

Credits

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nichtparasoup-2.5.0.tar.gz (2.8 MB view details)

Uploaded Source

Built Distribution

nichtparasoup-2.5.0-py3-none-any.whl (58.1 kB view details)

Uploaded Python 3

File details

Details for the file nichtparasoup-2.5.0.tar.gz.

File metadata

  • Download URL: nichtparasoup-2.5.0.tar.gz
  • Upload date:
  • Size: 2.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/54.1.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.8.8

File hashes

Hashes for nichtparasoup-2.5.0.tar.gz
Algorithm Hash digest
SHA256 7514ad9d61dbf5cb611a10ea17fbade85b8715da95f0cfe097d1ad0a86b4bf1a
MD5 40f77c69aa15fa11447d6711b2752a85
BLAKE2b-256 5570a788a349ab5527ab0e0af0e361f0b293b5f99d13f1e5e3830f22f8f4f100

See more details on using hashes here.

File details

Details for the file nichtparasoup-2.5.0-py3-none-any.whl.

File metadata

  • Download URL: nichtparasoup-2.5.0-py3-none-any.whl
  • Upload date:
  • Size: 58.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/54.1.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.8.8

File hashes

Hashes for nichtparasoup-2.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 22ea69e1b54ad0f7274879f5601bfb3addf1b56fa0d022cc3bb1db3a52224c6d
MD5 2b3fe9b91932e31d07628198e5eadacf
BLAKE2b-256 c8f5823806b5439d2ebae25e08ccd67c06512595ce34e494c5217039318e82a2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page