PHPackages                             baptouuuu/series - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. baptouuuu/series

ActiveProject[Utility & Helpers](/categories/utility)

baptouuuu/series
================

Series watcher

2.1.0(5y ago)017[2 PRs](https://github.com/Baptouuuu/series/pulls)MITHTMLPHP ~7.4|~8.0

Since Mar 4Pushed 2y agoCompare

[ Source](https://github.com/Baptouuuu/series)[ Packagist](https://packagist.org/packages/baptouuuu/series)[ RSS](/packages/baptouuuu-series/feed)WikiDiscussions develop Synced 2mo ago

READMEChangelogDependencies (8)Versions (10)Used By (0)

Series
======

[](#series)

[![Build Status](https://github.com/Baptouuuu/Series/workflows/CI/badge.svg?branch=master)](https://github.com/Baptouuuu/Series/actions?query=workflow%3ACI)[![codecov](https://camo.githubusercontent.com/7f6908a04b76ad7b54a6c993aaeaf8b8fe8ec38e1ef1ffcd138d1af4cfb36376/68747470733a2f2f636f6465636f762e696f2f67682f426170746f757575752f5365726965732f6272616e63682f646576656c6f702f67726170682f62616467652e737667)](https://codecov.io/gh/Baptouuuu/Series)

This tool allows you to report the episodes of your tv shows you need to watch.

This project is born to allow to follow your tv shows without the need to use a web service. By using a dedicated web service you tv shows consumption is tracked via the account you need to log into. This tool store your usage in your home folder under the `.series` folder, thus keeping your consumption private.

The technical goal of this project is to showcase the implementation of the [clock pattern](https://github.com/Baptouuuu/talks/tree/master/time%20dependency).

Installation
------------

[](#installation)

```
composer global require baptouuuu/series
```

Usage
-----

[](#usage)

The first step is for you to select the series you want to watch:

```
series watch
```

This will ask you to choose the series (airing this month) you want to watch. Since this tool doesn't access a global database of tv shows you'll need to run this command every month in order to discover new series.

**Note**: if for some reason you want to stop watching a show simply run `series unwatch`, it will ask you which one you want to stop watching.

Then each time you want to catch up of all episodes you need to watch:

```
series report
```

The first time it will retrieve the epsiodes since the last day. But if you want to display episodes since a given date simply add an argument to the command of the form `{year}-{month}-{day}`.

Examples of the commands:

[![](watch.png)](watch.png) [![](report.png)](report.png)

Tech
----

[](#tech)

Below is the dependency graph of this tool in case you want to understand the inner working.

[![](graph.svg)](graph.svg)

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity74

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~216 days

Recently: every ~271 days

Total

6

Last Release

1906d ago

Major Versions

1.1.0 → 2.0.02020-03-30

PHP version history (3 changes)1.0.0PHP ~7.2

2.0.0PHP ~7.4

2.1.0PHP ~7.4|~8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/851425?v=4)[Baptiste Langlade](/maintainers/Baptouuuu)[@Baptouuuu](https://github.com/Baptouuuu)

---

Top Contributors

[![Baptouuuu](https://avatars.githubusercontent.com/u/851425?v=4)](https://github.com/Baptouuuu "Baptouuuu (49 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/baptouuuu-series/health.svg)

```
[![Health](https://phpackages.com/badges/baptouuuu-series/health.svg)](https://phpackages.com/packages/baptouuuu-series)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)