portal/docs/how-to-turn-it-on.md

Hardware setup instructions

This readme contains insructions for plugging in the system and turning it on. Full software setup documentation is in the broadcaster-software.md and listener-software.md files.

Make sure to do the following steps in the order they are listed:

Requirements

• Modem and internet plan (no static IP required - uses Dynamic DNS).
• Provisioned broadcaster with Dynamic DNS configured
• Provisioned listener

Steps

Turn on broadcaster

1. Plug the usb mic cable into a microphone
2. Plug the usb mic cable into the top right (blue colored) usb port on the broadcaster (raspberry pi 4b)
3. Plug the ethernet cable into the broadcaster and the router
4. Plug the power into the broadcaster (this is how you turn it on)

Networking (Simplified with Dynamic DNS)

Networking

6. Log into the router.
7. Find the ip address of the broadcaster (hostname portal) - usually in the advanced > network > dhcp.
8. No port forwarding needed - icecast runs directly on port 80.
9. The broadcaster will automatically update blackportaldetroit.com with the current public IP address via Dynamic DNS.

Turn on listener

1. Turn on the listener (raspberry pi zero). plug it into a monitor and keyboard. when it boots, type sudo raspi-config. navigate to system settings and change the wifi settings so it can access the internet.
2. The listener is pre-configured to stream from http://blackportaldetroit.com/portal.m3u - no manual configuration needed.
3. Type sudo systemctl restart listener
4. mic check

Important notes

• The microphone must always be plugged into the broadcaster before the broadcaster is on
• The broadcaster must always be on when the listener is turned on. if it is not, then the listener needs to be restarted once the broadcaster is on.
• Dynamic DNS automatically keeps blackportaldetroit.com pointed to your current IP address
• No router port forwarding required - icecast runs directly on port 80