## Overview

streamtuner provides a framework for implementing stream directory handlers which can be loaded from separate plugins.

The API is not orthogonal with GObject and could be cleaner, but can nevertheless be used to easily add support for new stream directories to streamtuner.

## Conventions

- Unless noted otherwise, strings passed to functions or used as structure members must be encoded in UTF-8.

- Unless noted otherwise, strings returned by streamtuner are encoded in UTF-8.

- Handler callbacks which are susceptible to block the application for a long period will be run in a separate thread of execution.