{"id":37065967,"url":"https://github.com/raphiz/seriesbutler","last_synced_at":"2026-01-14T07:44:16.601Z","repository":{"id":57465808,"uuid":"42243988","full_name":"raphiz/seriesbutler","owner":"raphiz","description":"DISCONTINUED: Downloads your favorite TV shows just by running one simple command","archived":true,"fork":false,"pushed_at":"2017-04-14T15:23:05.000Z","size":111,"stargazers_count":2,"open_issues_count":9,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-09-02T20:02:03.474Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/raphiz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-09-10T12:48:03.000Z","updated_at":"2023-01-28T20:32:26.000Z","dependencies_parsed_at":"2022-09-13T03:11:04.510Z","dependency_job_id":null,"html_url":"https://github.com/raphiz/seriesbutler","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/raphiz/seriesbutler","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphiz%2Fseriesbutler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphiz%2Fseriesbutler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphiz%2Fseriesbutler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphiz%2Fseriesbutler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raphiz","download_url":"https://codeload.github.com/raphiz/seriesbutler/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphiz%2Fseriesbutler/sbom","scorecard":{"id":761989,"data":{"date":"2025-08-11","repo":{"name":"github.com/raphiz/seriesbutler","commit":"8e45d614ff51e39d02d28115ea95b7aff2996309"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":1.7,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Maintained","score":0,"reason":"project is archived","details":["Warn: Repository is archived."],"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":0,"reason":"10 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2022-238 / GHSA-h3qr-fjhm-jphw","Warn: Project is vulnerable to: PYSEC-2025-49 / GHSA-5rjg-fvgr-3xxf","Warn: Project is vulnerable to: GHSA-cx63-2mw6-8hw5","Warn: Project is vulnerable to: PYSEC-2022-43012 / GHSA-r9hx-vwmv-q579","Warn: Project is vulnerable to: PYSEC-2022-43017 / GHSA-qwmp-2cf2-g9g6","Warn: Project is vulnerable to: GHSA-c33w-24p9-8m24","Warn: Project is vulnerable to: GHSA-9hjg-9r4m-mvj7","Warn: Project is vulnerable to: GHSA-9wx4-h78v-vm56","Warn: Project is vulnerable to: PYSEC-2023-74 / GHSA-j8r2-6x86-q33q","Warn: Project is vulnerable to: PYSEC-2018-28 / GHSA-x84v-xcm2-53pg"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-22T23:43:13.346Z","repository_id":57465808,"created_at":"2025-08-22T23:43:13.347Z","updated_at":"2025-08-22T23:43:13.347Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28413480,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T05:26:33.345Z","status":"ssl_error","status_checked_at":"2026-01-14T05:21:57.251Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-14T07:44:15.949Z","updated_at":"2026-01-14T07:44:16.589Z","avatar_url":"https://github.com/raphiz.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DISCONTINUED!\n# Seriesbutler 1.3.0-dev\n[![Build Status](https://travis-ci.org/raphiz/seriesbutler.svg)](https://travis-ci.org/raphiz/seriesbutler)\n[![codecov.io](https://codecov.io/github/raphiz/seriesbutler/coverage.svg?branch=master)](https://codecov.io/github/raphiz/seriesbutler?branch=master)\n[![Dependency Status](https://www.versioneye.com/user/projects/55f17d5ad4d2040019000060/badge.svg?style=flat)](https://www.versioneye.com/user/projects/55f17d5ad4d2040019000060)\n\nDownload your favourite TV shows just by running one simple command.\n\n```bash\nseriesbutler fetch\n```\n\n## Legal notice\nDownloading TV Series may not be legal in your country of residence - please check with your local laws before installing!\nThe author of this software does not take ANY responsibility for what you do with it!\n\n## Installation\nSeriesbutler can be installed using pip. Note that Seriesbutler only supports Python \u003e= 3.4!\n\n```\nsudo pip3 install seriesbutler\n```\n\n\n## Usage\nWhy should you use Seriesbutler? There are two major reasons: You want your home server to\ngrab the series for you - so that they are ready for you to watch when you want to or you just\nwant to use the command line - instead of clicking all the ads away.\n\nBefore using Seriesbutler, you should create a new directory in which the series are managed.\n\n```bash\nmkdir series/\ncd series/\n```\n\nWe have to initialize the directory to make it work with Seriesbutler.\n\n```bash\nseriesbutler init\n```\n\nNext, you can add new Series using the `add` command - this should be pretty straight-forward.\n\n```bash\nseriesbutler add\n```\n\nAfter adding the new series successfully, you can check for new episodes to download. This might take some time - the command line output will help you understand what's going on.\n\n```bash\nseriesbutler fetch\n```\n\nHere is a quick demo showing the basic usage of Seriesbutler\n[![asciicast](https://asciinema.org/a/e6661ede9noc0fjdjxi5qotxk.png)](https://asciinema.org/a/e6661ede9noc0fjdjxi5qotxk)\n\nFor more information, checkout the usage information by calling\n\n```\nseriesbutler --help\n```\n\n### Configuration\nYou can manually modify the Seriesbutler configuration - it's a simple plain JSON file called\n`Seriesbutler.json` located in the Seriesbutler working directory.\n\nThe full [JSON Schema](http://json-schema.org/) can be found [here](https://github.com/raphiz/seriesbutler/blob/master/seriesbutler/models.py#L27)\n\n#### hosters (required)\nSome hosters might have a terrible video quality while others are fast and good. This\noption allows you to specify preferred hosters, which will instruct Seriesbutler to look for\ngive preference to the links of this hoster.\n\nThe ignored list specifies hosters which will be completely ignored, even if no other links\nare available.\n\nNote that these rules match if a host name *starts with* one of the specified hoster names -\nif you specify *played* for example, it will apply for *http://played.to/* as well as *http://played-stuff.xyz/*.\n\nThe order in which the preferred links are checked is the same as declared here.\n\n```json\n{\n    \"hosters\": {\n        \"ignored\": [\n            \"played\",\n            \"vodlocker\"\n        ],\n        \"preferred\": [\n            \"vidspot.net\",\n            \"allmyvideos.net\"            \n        ]\n    }\n}\n```\n\n#### series (required)\nThe series array contains zero or more TV series elements which Seriesbutler will keep\ntrack of. Use the command line option `seriesbutler add` and `seriesbutler remove`\ninstead of manually edit this option - it's much simpler!\n\n```json\n{\n    \"series\": [\n        {\n            \"imdb\": \"tt1586680\",\n            \"name\": \"Shameless (US)\",\n            \"start_from\": {\n                \"season\": 5,\n                \"episode\": 9\n            }\n        }\n    ]\n}\n```\n\n#### ydl_options (optional)\nThis is the most flexible - but most complicated option. It allows you to directly pass\noptions to [youtube-dl](https://rg3.github.io/youtube-dl/) - as if you were using its API\ndirectly. This is very useful if you prefer a certain format or want to use an alternative downloader etc.\n\nCheckout the [youtube-dl README](https://github.com/rg3/youtube-dl/blob/master/README.md) for all supported options.\n\n```json\n{\n    \"ydl_options\" : {\n        \"recodevideo\" : \"mp4\",\n        \"external_downloader\": \"axel\",\n        \"external_downloader_args\": [\"-a\"]\n    }\n}\n```\n\n## Supported Sites\nSeriesbutler fetches links from the following sites:\n\n* [putlocker-series.com](http://putlocker-series.com) - since version v1.3.0\n* [solarmovie.ph](http://solarmovie.ph)\n* [watchseries.ag](http://watchseries.ag)\n\nThe video files are downloaded using [youtube-dl](https://rg3.github.io/youtube-dl/).\n\n\n## What's next\n* There are some TODOs in the code to be resolved\n* Support more sites\n* Prefer links that have a good quality declared (eg. HD or 10/10 video)\n* Improve performance\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraphiz%2Fseriesbutler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraphiz%2Fseriesbutler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraphiz%2Fseriesbutler/lists"}