https://github.com/simatwa/fzmovies-api
Unofficial Python API/SDK for fzmovies.net
https://github.com/simatwa/fzmovies-api
fzmovies movies movies-api
Last synced: 7 months ago
JSON representation
Unofficial Python API/SDK for fzmovies.net
- Host: GitHub
- URL: https://github.com/simatwa/fzmovies-api
- Owner: Simatwa
- License: gpl-3.0
- Created: 2024-10-02T10:41:16.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-16T16:17:22.000Z (11 months ago)
- Last Synced: 2025-03-23T13:22:33.609Z (7 months ago)
- Topics: fzmovies, movies, movies-api
- Language: Python
- Homepage:
- Size: 156 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
fzmovies-api
> Unofficial Python API/SDK for fzmovies.net
```python
from fzmovies_api import Auto
Auto(
query="Fast and Furious 5",
quality="720p",
).run()
# Will show download progressbar
"""
Fast_and_Furious_5_BluRay v2_720p.mkv
805 MB ██████████████████ 42%|
"""
```
## Installation
```
$ pip install fzmovies-api[all]
```
Alternatively, you can download binaries for your system from [here](https://github.com/Simatwa/fzmovies-api/releases/latest).
## Usage
Developers
```python
# Search by Starcast
from fzmovies_api import Search
search = Search(
query="Jason Statham",
searchby="Starcast"
)
print(
search.results
)
# Output
"""
| | | | | | | | | | | | | | | | | | | ]>
"""
```
#### Perform Search Using Filters
```python
from fzmovies_api import Search
from fzmovies_api.filters import IMDBTop250Filter
search = Search(
query = IMDBTop250Filter()
)
print(
search.results
)
#Output
"""
| | | | | | | | | | | | | | | | | | | ]>
"""
```
#### Fetch All Search Results
```python
from fzmovies_api import Search
from fzmovies_api.filters import IMDBTop250Filter
search = Search(
query = IMDBTop250Filter()
)
print(
search.all_results
)
```
##### Limit movies and stream results
```python
from fzmovies_api import Search
from fzmovies_api.filters import MovieGenreFilter
search = Search(
query = MovieGenreFilter(
"Action"
)
)
for result in search.get_all_results(
limit=40,
stream=True
):
print(
result, end='\n\n'
)
```
#### Download Movies
```python
from fzmovies_api import Search, Navigate, DownloadLinks, Download
from fzmovies_api.filters import OscarsFilter
search = Search(
query=OscarsFilter(
category="Best Picture"
)
)
for movie in search.all_results.movies:
# Navigate to the specific movie-page
movie_page = Navigate(movie).results
# Go to page containing download link
download_link_page = DownloadLinks(
movie_page.files[1]
)
download_link_metadata = download_link_page.results
# Follow the link to download the movie
download_movie = Download(
download_link_metadata.links[0]
)
print(
"Downloading : '" + movie.title + "' of size " + download_link_metadata.size
)
# Dowload the movie using save method
saved_to = download_movie.save(
download_link_metadata.filename,
# To silence progressbar & any other stdout:
# progress_bar = False,
# quiet = True
)
print(
saved_to
)
```
##### Using Auto
```python
from fzmovies_api import Auto
from fzmovies_api.filters import RecentlyReleasedFilter
start = Auto(
query=RecentlyReleasedFilter(
category="Hollywood"
)
)
start.run()
```
### CLI
- Basic case yet very handy
```sh
$ python -m fzmovies_api download
# e.g python -m fzmovies_api download "Thor - Love and Thunder"
```
> [!TIP]
> Shorthand for `python -m fzmovies_api` is `fzmovies`
$ fzmovies download --help
```
Usage: python -m fzmovies_api download [OPTIONS] QUERY
Perform search and download first movie in the search results
Options:
-s, --searchby [Name|Director|Starcast]
Query search-by filter - Name
-c, --category [All|Bollywood|Hollywood|DHollywood]
Query movie category - All
-q, --quality [480p|720p] Movie file download quality - 720p
-o, --output TEXT Filename for saving the movie contents to
-d, --directory TEXT Directory for saving the movie contents -
pwd
-z, --chunk-size INTEGER Chunk_size for downloading files in KB - 512
-r, --resume Resume downloading incomplete files - False
-q, --quiet Not to stdout anything - False
-y, --yes Okay to all prompts - False
--help Show this message and exit.
```
> [!NOTE]
> **fzmovies_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 fzmovies.net 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.