Project Alias is an open-source parasite to hack smart home devices. Train custom wake-up names and commands for your devices while disturbing their built-in microphone with noise. Introduce false labelling to their algorithm by changing gender or nationality. Read more about the project here
This repository has been updated to 2.0. Find the old version under the branches
For the complete step-by-step guide and 3D files see our Instructables
The Alias software can be flashed onto a micro SD card, for a fast and easy setup. Make sure the respeaker hat is attached to the Raspberry Pi.
We recommend to use the Easy Setup but if you wish to install the project from scratch use the Manual Install instructions.
Configure your Alias by connecting to its local wifi from your phone.
ssid: Project Alias psw: cordyceps.
Open a browser and enter the url: alias.local to interface with Alias.
From the interface you can now add new wake-up word / commands or edit existing ones. Save any changes by clicking the Update Alias button. We recommend to experiment with different words and sensitivity levels to find what works best for you.
To configure the settings, click the icon in the upper right corner. Here you can adjust and customize the noise, language, gender, volume and delay. Tip: If you write the full command into alias you can create shortcuts and new functions. E.g. By calling 'Funky Time' you could have Alias whisper 'Ok Google, play some funky music on Spotify'.
|Noise||This will turn on/off the looping noise||
|Gender||Choose what gender the assistant should perceive when Alias whispers commands. By changing to the opposite gender you will able to introduce false labelling into the assistants algorithm. This confusion might lead to interesting interactions and answers. Note, this only changes the voice of Alias itself, and will therefore only have an effect with long commands.||
|Language||Change the language Alias uses to speak to your assistant. This is to introduce another layer of noise that makes the system label you with a different nationality. To use this feature the command for the assistant has to be written in the same language.||
|Volume||Change the volume of the speakers. This needs to be loud enough for the noise to block the assistant, but low enough not to be audible. Settings can vary by acoustics and ambient inferences.||
|Noise Delay||This increase the delay after the wake-up word has been activated to restart the noise again. This is used as a noise free window, when asking the assistant a question. It should be set to match the appropriate time interval needed for the maximum length of a conversation.||
|Sensitivity||This setting changes the sensitivity of the wake-up word detection. This setting is found on the front page for each command. The lower the number the less sensitive.||
If you wish to build this project manually, you can follow the guide below. We do recommend using the pre installed image linked in the Easy Setup.
How to prepare and setup a Raspberry Pi for this project:
Copy the ssh and wpa_supplicant.conf files from the setup folder to the SD card (boot)
Edit the wpa_supplicant.conf in a text editor to match your wifi settings. Insert the card to the raspberry pi
In terminal ssh into the pi:
sudo ssh [email protected]
Default password is 'raspberry'. To change password use the 'passwd' command
Update the pi:
sudo apt-get update && sudo apt-get upgrade
Note: Some dependencies might very for differen versions. This guide has last been tested and validated on Raspbian Stretch version 9.
On the Rapsberry Pi: Enable interface SPI in raspi-config
Make sure you have python3 and git installed for the next steps:
sudo apt-get install python3-dev python3-pip git libatlas-base-dev
Clone and install the sound driver for the ReSpeaker hat:
cd && git clone https://github.com/respeaker/seeed-voicecard.git cd seeed-voicecard && sudo ./install.sh
Disable default sound card by following this guide
Install pocketsphinx and dependencies
sudo pip3 install spidev sudo apt-get install -y python python-dev python-pip build-essential swig git libpulse-dev sudo apt-get install libasound2-dev sudo apt-get install pulseaudio pulseaudio-utils libpulse-dev libpulse-java libpulse0 sudo pip3 install --upgrade pocketsphinx
sudo apt-get install espeak
Install flask server
sudo pip3 install flask flask_socketio
sudo apt-get install python3-pygame
To install a private network you can follow this guide
Finally clone the Alias project:
git clone https://github.com/bjoernkarmann/project_alias.git
If you are using Google Home or an Amazon Alexa the way you change the wake up word is simply by writing it in the responds field in the Alias web-app
This project is licensed under the GPL License - see the LICENSE.GPL file in the root folder