# Internet radio electronics and software for Black Portal Detroit

Electronics and software for the Black Portal Detroit work By Wes Taylor for the [Code Switch show at at MOCAD](https://thekitchen.org/on-view/code-switch-distributing-blackness-reprogramming-internet-art/). Electronics and software built and written by Boaz Sender based on Wes' concept and at Wes' direction.

## Software provisioning and setup

This repository also contains documentation for how to buy and setup the electronics for Black Portal Detroit.

1. Broadcaster bill of materials and software setup instructions in [broadcaster.md](broadcaster.md)
2. Listener bill of materials and software setup instructions in [listener.md](listener.md)

## Custom software

This repository contains custom software for turning a m3u radio stream into a logic for random selection of lyrics from an sqlite database of song stanzas written by Detroiters from the neighborhood where MOCAD is.

3. Custom software development instructions in [listener-lcd-screen-software.md](listener-lcd-screen-software.md)

## Turning on the devices

4. The sequence for turning on the system is in [how-to-turn-it-on.md](how-to-turn-it-on.md)

Prior research that didn't work in `research-` md files.

## Dynamic DNS Setup

The broadcaster configures Namecheap Dynamic DNS to make the stream available at blackportaldetroit.com without requiring a static IP address. The setup includes:

- Automatic IP address detection and updates
- Namecheap integration for seamless domain management
- Icecast running directly on port 80 (no router port forwarding needed)

## Live access

5. If everything is turned on and configured properly, you may visit http://blackportaldetroit.com to hear the broadcaster.