PHPackages                             mihaeu/sub-collector - 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. [CLI & Console](/categories/cli)
4. /
5. mihaeu/sub-collector

ActiveLibrary[CLI & Console](/categories/cli)

mihaeu/sub-collector
====================

Sub-Collector is a console based app written in PHP, its main purpose is to batch collect subtitles.

2.0.2(11y ago)340MITPHPPHP >=5.3.3CI failing

Since Oct 25Pushed 5y ago2 watchersCompare

[ Source](https://github.com/mihaeu/sub-collector)[ Packagist](https://packagist.org/packages/mihaeu/sub-collector)[ RSS](/packages/mihaeu-sub-collector/feed)WikiDiscussions master Synced yesterday

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

Sub-Collector
=============

[](#sub-collector)

[![Build Status](https://camo.githubusercontent.com/beb5073abb01934600fd5f414c694d79b376a8bc9e25bf7ebb7398a89a61ea9f/68747470733a2f2f7472617669732d63692e6f72672f6d69686165752f7375622d636f6c6c6563746f722e706e67)](https://travis-ci.org/mihaeu/sub-collector)[![Coverage Status](https://camo.githubusercontent.com/bdeb9159f12b7af2ed1b0dec1137f9d64dc9a113b88396bae3535605964dfb41/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6d69686165752f7375622d636f6c6c6563746f722f62616467652e706e67)](https://coveralls.io/r/mihaeu/sub-collector)

[![sub-collector usage example](https://camo.githubusercontent.com/565745c5ecd1378ae48bd982b3cd9dda4b0b583d738e4abaa09c0e84d8b2ce06/687474703a2f2f6b696d61692e6d696b652d6465762e696e666f2f7375622d636f6c6c6563746f722d6578616d706c652e676966)](https://camo.githubusercontent.com/565745c5ecd1378ae48bd982b3cd9dda4b0b583d738e4abaa09c0e84d8b2ce06/687474703a2f2f6b696d61692e6d696b652d6465762e696e666f2f7375622d636f6c6c6563746f722d6578616d706c652e676966)

Sub-Collector is a small project that I started, because I was sick of manually searching for subtitles for my ever growing collection of movies.

There are other tools out there which are way more mature and which have a wide selection of features. These tools however were not written in PHP and this is console based, so let's see where it goes.

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

[](#installation)

> I'm assuming you're familiar with Composer. If you are not and you made it here, I strongly advise you to take 5 minutes to read up on the [Getting Started](https://getcomposer.org/doc/00-intro.md) section. It'll change your life (or at least the way you write PHP).

Make sure `~/.composer/bin` is in your `$PATH` and then simply execute:

```
composer global require mihaeu/sub-collector:dev-master
```

Usage
-----

[](#usage)

For now Sub-Collector's functionality is very limited. To download subtitles for all the movies (or a single movie) within a path just use:

```
sub-collector download [PATH_TO_YOUR_MOVIE_COLLECTION]
```

Tests
-----

[](#tests)

I'm aiming for as close to 100% test coverage as is sensible. If you want to check out the tests for yourself install the require-dev deps from composer (default) and run:

```
vendor/bin/phpunit --testdoc --coverage-text
```

The `--testdox` produces a more "agile" (buzzzz!) output which is a good way to get started if you're trying to check out the functionality. The whole command will produce something like this:

```
# ...

DownloadCommand
 [x] Downloading of subtitles for a movie without subtitle and existing subtitle on server
 [x] Download of subtitles for movie without subtitle but no subtitle on server
 [x] Downloading of subtitles for a movie which has subtitles is skipped

Finder
 [x] Only accepts directories
 [x] Only movies are found in a folder
 [x] Movies can be nested deeply inside a folder
 [x] Movie with subtitle will be detected
 [x] Movie without subtitle will be detected
 [x] Custom file extensions will be detected

SubCollector
 [x] Subtitle can be downloaded if exists
 [x] Subtitle cannot be downloaded if it does not exist
 [x] Downloaded subtitle will be saved as a srt file
 [x] Subtitle file will only be saved when subtitle was found

# ...

Code Coverage Report

 Summary:
  Classes: 83.33% (5/6)
  Methods: 88.24% (15/17)
  Lines:   84.00% (84/100)
```

Thanks to
---------

[](#thanks-to)

- [themoviedb.org](http://www.themoviedb.org/) for providing a free-to-use API
- [Symfony](http://symfony.com/)/[SensioLabs](http://sensiolabs.com/en) and especially [Fabien Potencier](http://fabien.potencier.org/) for what he does for PHP (for this particular project the [DomCrawler](https://github.com/symfony/DomCrawler))
- the [Composer](https://getcomposer.org/) team for revolutionizing the way I and many others write PHP
- [GitHub](https://github.com) for redefining collaboration
- [Travis CI](https://travis-ci.org/) for improving the quality and compatibility of thousands of open source projects
- [Sebastian Bergmann](http://sebastian-bergmann.de/) for [PHPUnit](http://phpunit.de) and many other awesome QA tools

License
-------

[](#license)

MIT, see `LICENSE` file.

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 76.5% 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 ~43 days

Recently: every ~28 days

Total

7

Last Release

4322d ago

Major Versions

0.1 → 1.0.12014-03-20

1.0.3 → 2.0.02014-07-13

### Community

Maintainers

![](https://www.gravatar.com/avatar/b1cfd32112845e28319a56265bdcac255118e0fba4eb36ccfa6c718f5e52bc49?d=identicon)[mihaeu](/maintainers/mihaeu)

---

Top Contributors

[![mihaeu](https://avatars.githubusercontent.com/u/2168701?v=4)](https://github.com/mihaeu "mihaeu (65 commits)")[![martinlindhe](https://avatars.githubusercontent.com/u/181531?v=4)](https://github.com/martinlindhe "martinlindhe (20 commits)")

---

Tags

moviesubtitleSubDB

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mihaeu-sub-collector/health.svg)

```
[![Health](https://phpackages.com/badges/mihaeu-sub-collector/health.svg)](https://phpackages.com/packages/mihaeu-sub-collector)
```

###  Alternatives

[illuminate/console

The Illuminate Console package.

12944.1M5.1k](/packages/illuminate-console)[crazywhalecc/static-php-cli

Build single static PHP binary, with PHP project together, with popular extensions included.

1.8k13.9k](/packages/crazywhalecc-static-php-cli)[matthiasnoback/symfony-console-form

Use Symfony forms for Console command input

368264.8k8](/packages/matthiasnoback-symfony-console-form)[madewithlove/license-checker

CLI tool to verify allowed licenses for composer dependencies

54449.8k21](/packages/madewithlove-license-checker)[shel/neos-terminal

Neos CMS Ui terminal for running Eel expressions and other commands

1441.3k](/packages/shel-neos-terminal)

PHPackages © 2026

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