https://github.com/simatwa/fzseries-api
Unofficial Python SDK/API for fztvseries.live
https://github.com/simatwa/fzseries-api
fzseries fztvseries mobiletvshows series tvseres
Last synced: about 1 year ago
JSON representation
Unofficial Python SDK/API for fztvseries.live
- Host: GitHub
- URL: https://github.com/simatwa/fzseries-api
- Owner: Simatwa
- License: gpl-3.0
- Created: 2024-10-13T09:06:51.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-22T14:14:07.000Z (over 1 year ago)
- Last Synced: 2025-03-26T02:11:20.287Z (about 1 year ago)
- Topics: fzseries, fztvseries, mobiletvshows, series, tvseres
- Language: Python
- Homepage:
- Size: 84 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
fzseries-api
> Unofficial Python SDK/API for fztvseries.live
```python
from fzseries_api import Auto
Auto(
query="Mr. Robot",
).run()
# Will show download progressbar
"""
[T 1/10] Mr. Robot - S01E01 - eps1.0_hellofriend.mov
179 MB ████████████████████ 47%|
"""
```
## Installation
```sh
$ pip install fzseries-api[cli]
```
Alternatively, you can download standalone executable for your system from [here](https://github.com/Simatwa/fzseries-api/releases/latest).
## Usage
1. Developers
#### Search Series Using Title
```python
from fzseries_api import Search, TVSeriesMetadata, EpisodeMetadata, Download
from fzseries_api.models import SearchResults, TVSeriesSeason, EpisodeInSearch
search = Search(
query = "Into the Badlands"
)
series_search_results : list[SearchResults] = search.results.series
#First series metadata
target_series_metadata = TVSeriesMetadata(
series_search_results[0]
)
series_seasons:list[TVSeriesSeason] = target_series_metadata.results.seasons
# First season metadata
season_one_metadata = EpisodeMetadata(
series_seasons[0]
)
season_one_episodes: list[EpisodeInSearch] = season_one_metadata.results.episodes
# download first episode
saved_to = Download(
season_one_episodes[0]
).run()
print(
saved_to
)
```
#### Search Series Using Filters
```python
from fzseries_api import Search, TVSeriesMetadata, EpisodeMetadata, Download
from fzseries_api.models import SearchResults, TVSeriesSeason, EpisodeInSearch
from fzseries_api.filters import GenreFilter
search = Search(
query = GenreFilter(
genre="Sci-Fi"
)
)
series_search_results : list[SearchResults] = search.results.series
#First series metadata
target_series_metadata = TVSeriesMetadata(
series_search_results[0]
)
series_seasons:list[TVSeriesSeason] = target_series_metadata.results.seasons
# First season metadata
season_one_metadata = EpisodeMetadata(
series_seasons[0]
)
season_one_episodes: list[EpisodeInSearch] = season_one_metadata.results.episodes
# download first episode
saved_to = Download(
season_one_episodes[0]
).run()
print(
saved_to
)
```
### 2. CLI
```sh
$ fzseries download
# e.g fzseries download "Mr. Robot"
```
$ fzseries download --help
```
Usage: fzseries download [OPTIONS] QUERY
Download a whole series|seasons|episodes automatically
Options:
-b, --by [series|episodes] Query category
-so, --season-offset INTEGER Season number to start downloading from
-eo, --episode-offset INTEGER Episode number to start downloading from
-l, --limit INTEGER Number of proceeding episodes to download
before stopping
-t, --download-trials INTEGER Number of trials before giving up on
downloading an episode
-r, --request-timeout INTEGER Http request timeout while downloading
episodes in seconds.
-f, --format [High MP4|WEBM] Preffered movie download format
-d, --directory DIRECTORY Parent directory for saving the downloaded
contents
--enable-progressbar / --disable-progressbar
Show or hide downloading progress bar
--quiet Do not stdout any interactive messages
--include_metadata Add series title and episode-id in filename
--one-season-only Download only one season and stop.
--ignore-errors Ignore exceptions raised while downloading
episode
--confirm Confirm episodes before downloading them
--help Show this message and exit.
```
$ fzseries --help
```
Usage: fzseries [OPTIONS] COMMAND [ARGS]...
Unofficial Python SDK/API for fztvseries.live
Options:
--version Show the version and exit.
--help Show this message and exit.
Commands:
discover Search TV series using title or filter
download Download a whole series|seasons|episodes automatically
metadata Access particular series metadata - seasons and episodes
Repository : https://github.com/Simatwa/fzseries-api
```
> [!NOTE]
> **fzseries_api** provides a lot more than what you've just gone through here. Documenting isn't my thing, but I will try to update it as time goes by. Additionally, I cannot document this any better than the code itself; therefore, consider going through it.
## Disclaimer
This project is not affiliated with or endorsed by fztvseries.live or its owners. The API may change without notice, and this project does not guarantee compatibility with all future updates. The developers of this project are not responsible for any damages or losses resulting from the use of this API. This project is provided AS IS, without warranty of any kind, express or implied.