Awesome Open Source
Awesome Open Source


Picroft - 2018-3-14 "Pi Day" release!

The Picroft project is an enclosure for a stock Raspberry Pi connected to a speaker and basic USB microphone. This is built around a Raspbian Jessie Lite installation. The entire project is available as a pre-built micro-SD image ready to be burned and placed into a Raspberry Pi. You can download the pre-built image here:

Download img Picroft 2018-3-14 image

SHA256 checksum for the image: 32864c5da8e5d84d91554a6b0e9240271fbc1af147b44ac7ac7e77e57c7614ea


  • Raspberry Pi 3 (Older versions do not have sufficient processing power, and if they work they will be very slow)
  • MicroSD Card (8 GB or larger)
  • Any analog speaker
  • USB Microphone. Tested with CM108-based microphones.


Official Raspberry Pi Image Installation Instuctions

Etcher Cross-Platform GUI SD card creator for RPi

Advanced Installation


Upon boot, Picroft will search for an Ethernet connection. If none is found, the Wifi Setup process will begin to get the device connected to any available network.

Once connected, you must pair the device at using the code spoken by the device. You can also read the code on the screen.

After that, you can simply speak to Picroft as you would to any Mycroft implementation. For example:

"Hey Mycroft, what time is it?" "Mycroft, how tall was Abraham Lincoln?"

Old Versions

  • 2018-03-14
    • Corrected typo, -ne instead of -eq was preventing script updates
    • Turned off “wait for network” in raspi-config
    • Updated to mycroft-core 18.2.2
    • SHA256: 32864c5da8e5d84d91554a6b0e9240271fbc1af147b44ac7ac7e77e57c7614ea
  • 0.9.1
    • Preloaded with mycroft-core 0.9.14
    • better pairing
    • launch CLI after boot
    • SHA256: d3041e41e7b6f1ca4f4b9ad3b4a665702b9dc32b285884d9bfdad8aefb9b788d
  • 0.9
    • Preloaded with 17.08a
    • auto-upgrading from this repo
  • 0.8
    • Switch to Home backend
  • 0.5.1
    • Fixed several audio issues with 0.5 image
  • 0.5
    • Original image
    • Connected to Cerberus backend

Help and more info

Check out the project wiki here.
There's also the general Documentation.

There are two scripts run on startup

  • configures your specific audio setup.
  • is a stub meant to initialize any other IoT devices or services you might need like a DLNA server or syslog for example.

Using USB Audio as Output

Typically the USB audio should be connected to hwplug:1,0 but to verify run the following:

aplay -L

Find the hwplug output for the device you want to use, take this and update the /etc/mycroft/mycroft.conf file accordingly:

"play_wav_cmdline": "aplay -Dhw:0,0 %1" this line now becomes "play_wav_cmdline": "aplay -Dplughw:1,0 %1"

You can now run ./ to start the program back up and test and ensure the output comes through the USB speakers.

There is an active Picroft community within the Mycroft's Mattermost which are welcome to join!

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Shell (230,362
Machine Learning (29,906
Hacktoberfest (22,499
Raspberry Pi (7,199
Open Source (7,131
Open Source (7,131
Artificial Intelligence (5,388
Raspberry Pi 3 (924
Rpi (437
Raspbian (415
Related Projects