A super easy way to get started with Magic Cards.
Magic Cards is a fun project that merges the physical world with the digital world. This repo is your one stop shop to getting it set up as easy as possible.
Clone down this repo, edit your configurations, and you'll be up and running with Magic Cards and Sonos immediately.
Read more about Magic Cards in its documentation.
This is expected to run on a Raspberry Pi. You should have git and docker already installed. You will also need to install docker-compose to get everything running easily.
Installing Docker is as easy as a couple of commands:
curl -sSL https://get.docker.com/ | shOnce it's installed, run this command so your pi user can use Docker.
sudo usermod -G docker piLog out of your Pi and back in so your user has permissions to use Docker.
You'll need to use the pip3 python package manager to install docker-compose to ensure you get the right version for your Raspberry Pi.
sudo pip3 install docker-composeLet it go through it's paces and you should be ready to go.
Installing is as easy as:
- Clone down this repo
- Edit the appropriate config files
- Start it up
Clone down the repo.
git clone [email protected]:maddox/magic-cards-docker.git
Edit the config.json and actions.json files found in:
magic-cards/config
Learn about configuring Magic Cards in its documentation.
This repo already has a Sonos action ready and configured. You should edit the actions.json file to change the room name you want your Sonos action to happen on. The room name is case sensitive.
Launch the containers with:
script/start
This will launch everything and keep it up. It may take a minute before everything is available. It's just a Raspberry Pi after all.
Browse the script dir to see other things you can use.
You can access the services on these ports:
- Magic Cards: port 5000
- Node Sonos HTTP API: port 5005
If you're having troubles, you can get help from the community on Spectrum.