open-story-teller/docs/intro-getting-started.md
Anthony Rabine 47b3060de5 Update docs
2023-05-02 18:17:03 +02:00

1.9 KiB

Getting started

This documentation will guide you to make your own story teller. You can choose between a purely software version (for desktop or mobile), or a hardware version with electronics boards, wires and mechanical enclosure.

Where to start

Before building your own hardware, make sure you have a minimal knowledge of basic electronics. You may have to solder some wires, but nothing's complicated.

The general procedure is:

  1. Choose your hardware bundle and buy parts
  2. Follow the guidelines to assemble your device
  3. Flash the last firmware binary available for your bundle
  4. Use the StoryEditor to create your first story
  5. Copy the story pack onto the SD-Card memory
  6. Enjoy

How much does it cost?

Without the enclosure, you can expect something between 30 € and 50 € depending on your hardware choices. Try to reuse a maximum of spare parts to lower the price (resistors, buttons...).

What tools do I need?

It is not exhaustive but here is a minimal list:

  • Soldering station
  • Solder
  • Resistors
  • USB cables
  • Jumper cables
  • Headers
  • Prototype boards

What about the software player?

The software player is free and open source, you can rebuild it from the source code or download prebuild releases. See dedicated section.

Informations

The Github project is https://github.com/arabine/open-story-teller. Feel free to use it for any project related topics:

  • Report bugs
  • Download the lastest firmware builds
  • Download the software player
  • Download the StoryEditor
  • Propose patches

Mechanical enclosure

Not yet, waiting for the availability of the first complete kit to determine the form factor.

Planned ideas

  • ESP32 target (low cost and high availability)
  • Add a microphone
  • Mobile version with text-to-speach and voice recognition
  • Propose to buy a PCB for I/O connections (buttons, rotary, LED...)

License

MIT License

Copyright (c) 2023 Anthony Rabine