Wunderkiste

Wunderkiste

A portable music player for children

Wunderkiste is a portable music player for young children. It's designed to be very easy to use so that even a 2 year-old child can quickly understand how it works. The whole projects is entirely open source so that YOU can build and modify it easily.

• Music is selected by placing a card / tag / figurine / cuddly toy on the top surface of Wunderkiste.
• Speakers are integreated, but headphones can be used, too.
• The integrated battery lasts multiple days of heavy use and can simply be charged with a USB phone charger.
• Music is stored as *.mp3 files on an SD card. Wunderkiste can hold a very large library of music.
• New music can easily be added without any special tools or software.
• The build uses mostly through-hole components and should be doable by anyone with basic knowledge of soldering and a handfull of tools.
• The firmware can be updated easily.

Building and using Wunderkiste

We collected a lot of information in the Wiki tab of this repository. Here are some links to get started:

• Download the latest release
• View the user manual (Work in progress)
• View the build guide (Work in progress)
• Report issues and bugs
• Any contribution to the project is highly appreciated!

Project structure

This software repository is the place where we collect everything needed to build, use, improve and customize your Wunderkiste.

The repository contains

• The source code for the firmware in the firmware directory.
• The hardware design files for the printed circuit boards in the hardware directory.
• Documentation and guides in the docs directory.
• The sources for the Wiki in the docs/wiki directory. They are automatically copied to the project wiki when pull requests are merged.
• CI actions in the .github directory (automated tests, release artifacts generation, etc.)

In addition to that, the github page contains

• The Wiki tab where you'll find a lot of resources
• The Releases tab where you'll find all releases and the corresponding firmware images and other documents.

How to contribute

Wunderkiste is open to use and modify by everyone. When we work together on this project, we can truely make something unique and wonderful. Please don't be shy to help improve this project!

• If you find something that you feel needs an improvement, feel free to open an issue on the issues tab and let us know.
• Browse the issues tab to see what's to do and where help is needed.
• Fork this repo and make some changes, then open a pull request. We'll review your changes and merge them into this repository.