Metadata-Version: 2.3
Name: episode-monitor
Version: 1.1.1
Summary: Monitor wikipedia pages of tv shows and send a notification when new episodes are detected
Requires-Dist: dbus-python>=1.4.0
Requires-Dist: notify2>=0.3.1
Requires-Dist: pyyaml>=6.0.2
Requires-Dist: requests>=2.32.5
Requires-Python: >=3.13
Description-Content-Type: text/markdown

# episode-monitor

Send desktop notifications when new episodes are detected for a list ov tv shows.

## Installation

### From PyPI

```console
pipx install episode-monitor
```

### From source

```console
git clone https://github.com/laszloszurok/episode-monitor
cd episode-monitor
python -m build
pipx install dist/episode-monitor-0.0.1-py3-none-any.whl
```

## Usage

Frist run creates a config file on `$XDG_CONFIG_HOME/episode_monitor/config.yaml` (defaults to `~/.config/episode_monitor/config.yaml`).
The default config file:
```yaml
interval: 300
shows:
- The Simpsons
- Family Guy
- South Park
```
Without any parameters the script will run continously and poll the configured pages evry `interval` seconds.

```console
episode-monitor
```
If the `--once` flag is given to the script, it will run a check for the configured pages and exit.
```console
episode-monitor --once
```

Episode counts will be stored at `$XDG_STATE_HOME/episode_monitor/episode_counts.json` (`~/.local/state/episode_monitor/episode_counts.json` by default).

Logs will be stored at `$XDG_CACHE_HOME/episode_monitor/episode_log.txt` (`~/.cache/episode_monitor/episode_log.txt` by default).

## License

`episode-monitor` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.
