Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Lauschkiste

Lauschkiste

An open-source RFID audio player for kids. Put a card on the box and music or an audiobook starts. Made for the Raspberry Pi (from the Zero up), runs on any Linux computer, managed from any browser. Alpha software.

Lauschkiste is German: lauschen means to listen closely, die Kiste is the box.

Features

  • RFID/NFC cards start albums, audiobooks, podcasts, radio stations or actions (volume, timers, shutdown, ...)
  • Audiobooks also from an Audiobookshelf server (with downloads for offline use); podcast and radio search
  • Quiet hours and a daily listening time
  • Web app for the library, cards, settings and playback
  • Built-in player, no extra audio daemon needed
  • Plugins for RFID readers, Raspberry Pi hardware (buttons, encoders, LEDs, battery) and more
  • Setup steps you can re-run safely, updates from the command line

Installation

On a Raspberry Pi with Raspberry Pi OS (Lite) or another Debian, the installer sets up everything (system packages, the service, the Samba share and more, asking before each step):

curl -fsSL https://raw.githubusercontent.com/ladidadida/lauschkiste/main/install.sh | bash

Only the Python package (Python 3.11 or newer, Linux, PortAudio for the sound output). While there are only pre-releases, pip needs --pre:

uv tool install lauschkiste                      # or: pipx install --pip-args=--pre lauschkiste
lauschkiste                                      # start the server, the web app is on http://localhost:5556

This package installs the server (lauschkiste) and the management command lauschctl:

lauschctl setup --check    # what is set up on this machine
lauschctl plugin list      # installed plugins
lauschctl update           # newer version

Packages

Package Contents
lauschkiste this package: the commands
lauschkiste-core the player, library, cards, volume, timers, web API and web app
lauschkiste-plugin-board-raspberry-pi Raspberry Pi board support (pins, boot configuration, power)
lauschkiste-plugin-devices GPIO buttons, rotary encoders, LEDs, battery monitor, power button, pHAT BEAT
lauschkiste-plugin-rfid-readers RFID reader drivers
lauschkiste-plugin-samba share the library on the network
lauschkiste-plugin-audiobookshelf audiobooks from an Audiobookshelf server
lauschkiste-plugin-directories find podcasts and radio stations (Apple, fyyd, Podcast Index, radio-browser)

Plugins are installed next to this package and switched on in the web app or with lauschctl plugin enable <name>.

Documentation

Origin and license

Lauschkiste grew out of Phoniebox, the RFID jukebox started by Micz Flor, and keeps its history. It is not a drop-in replacement: settings and card files of Phoniebox are not compatible. MIT license.

Metadata

Release files for lauschkiste 0.1.0a6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lauschkiste 0.1.0a6
File Size Uploaded
lauschkiste-0.1.0a6.tar.gz 30.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for lauschkiste 0.1.0a6
File Interpreter ABI Platform
lauschkiste-0.1.0a6-py3-none-any.whl Python 3 none any Details

Total release size: 71.5 kB

Release files / lauschkiste-0.1.0a6.tar.gz

Download URL lauschkiste-0.1.0a6.tar.gz
Size 30.7 kB
Tags Source
SHA-256 checksum
How to use checksums
f3467b6d5eb844460b2798638eb74cf0a859cc7aac65fa08d4a4cc9a76e8a653
BLAKE2b-256 checksum
How to use checksums
7c5a223a411c8b2098419b4e808ed5498a626cf30c6242343f5bdbdafd21b744
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.

Transparency log

Release files / lauschkiste-0.1.0a6-py3-none-any.whl

Download URL lauschkiste-0.1.0a6-py3-none-any.whl
Size 40.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
96b2cc3b4a0012ba36715852e6bb2feae1b8fdfea0be1b111540f9e3fc91f9be
BLAKE2b-256 checksum
How to use checksums
cdc6b15aaf7f6aa409ab80aa29d29ad7691cd8d1ddac517383ddc51578b5dfe0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.

Transparency log
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page