stream_finder module

The stream_finder helpers make it easier to populate your configs/cameras.yaml file. They aggregate multiple public camera directories, normalize the responses, and return ready-to-use stream definitions. Two providers are bundled:

• Insecam – requests are bootstrapped with a desktop browser profile and fall back to hardened headers when the site responds with HTTP 403, improving success rates.

• EarthCam – detail pages, embedded players, and JSON configs are parsed so that nested .m3u8 playlists (and other manifests such as .mpd or .mp4) surface automatically, even when the playlist is assembled from base/file elements inside EarthCam’s player configuration JSON.

When you run python main.py --find-camera the application uses stream_finder.CameraStreamFinder to look up a city, deduplicate the results, and write them to camera_streams_<city>.yaml. Each entry includes the stream URL, protocol, and any HTTP headers (such as Referer) that must be preserved when you add the stream to your configuration.

API Reference