# 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.

## Cloudflare Tunnel Setup

The broadcaster uses Cloudflare Tunnel to make the stream available at blackportaldetroit.com without requiring static IP, port forwarding, or dealing with CG-NAT. The setup includes:

- Secure tunnel bypassing router/firewall restrictions
- Automatic SSL certificate management
- Built-in DDoS protection and global CDN
- Works with any internet connection type (LTE, cable, DSL, fiber)

## Live access

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