Metadata-Version: 2.4
Name: ovos_ocp_news_plugin
Version: 0.1.3a5
Summary: OCP news feed stream extractor plugin
Author-email: JarbasAi <jarbasai@mailfence.com>
License: Apache-2.0
Project-URL: Homepage, https://github.com/OpenVoiceOS/ovos-ocp-news-plugin
Keywords: ovos,ocp,plugin
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: ovos-plugin-manager<3.0.0,>=2.1.0
Requires-Dist: ovos-ocp-rss-plugin<1.0.0,>=0.0.2
Requires-Dist: ovos-ocp-m3u-plugin<1.0.0,>=0.0.1
Requires-Dist: pytz
Requires-Dist: beautifulsoup4
Dynamic: license-file

# OCP News Plugin

This plugin lets [OCP](https://github.com/OpenVoiceOS/ovos-media) play news feeds from several providers. It resolves a news request to the real stream URL and hands it to OCP for playback.

## Install

```bash
pip install ovos-ocp-news-plugin
```

## Usage

OCP loads this plugin through the `opm.ocp.extractor` entry point. It handles two kinds of stream requests:

- A URI with the `news//` prefix, for example `news//georgia-today`.
- A URI that starts with one of the news provider URLs the plugin recognizes (for example a TSF or NPR feed URL).

No manual setup is needed beyond installing the plugin. OCP settings for this plugin live under the `news` key in `mycroft.conf`. The plugin defines no settings of its own.

## Related projects

- [OpenVoiceOS/ovos-media](https://github.com/OpenVoiceOS/ovos-media): the OCP media player that loads this extractor.
- [OpenVoiceOS/ovos-ocp-rss-plugin](https://github.com/OpenVoiceOS/ovos-ocp-rss-plugin): extracts streams from RSS and podcast feeds. Several news sources here resolve through it.
- [OpenVoiceOS/ovos-ocp-m3u-plugin](https://github.com/OpenVoiceOS/ovos-ocp-m3u-plugin): extracts streams from M3U playlists.
- [OpenVoiceOS/ovos-ocp-audio-plugin](https://github.com/OpenVoiceOS/ovos-ocp-audio-plugin): a sibling OCP stream extractor plugin.

## License

Apache-2.0
