{"id":16317033,"url":"https://github.com/simatwa/fzmovies-api","last_synced_at":"2025-04-08T13:32:41.208Z","repository":{"id":257808796,"uuid":"866480093","full_name":"Simatwa/fzmovies-api","owner":"Simatwa","description":"Unofficial Python API/SDK for fzmovies.net","archived":false,"fork":false,"pushed_at":"2024-11-16T16:17:22.000Z","size":160,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-23T13:22:33.609Z","etag":null,"topics":["fzmovies","movies","movies-api"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Simatwa.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-02T10:41:16.000Z","updated_at":"2025-03-06T16:21:05.000Z","dependencies_parsed_at":null,"dependency_job_id":"3459ef96-a073-403e-ab1f-44eef37dff1e","html_url":"https://github.com/Simatwa/fzmovies-api","commit_stats":{"total_commits":66,"total_committers":1,"mean_commits":66.0,"dds":0.0,"last_synced_commit":"9ebfa122b32135492aa011d356d67a48695cdd44"},"previous_names":["simatwa/fzmovies-api"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simatwa%2Ffzmovies-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simatwa%2Ffzmovies-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simatwa%2Ffzmovies-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simatwa%2Ffzmovies-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Simatwa","download_url":"https://codeload.github.com/Simatwa/fzmovies-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247851983,"owners_count":21006860,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["fzmovies","movies","movies-api"],"created_at":"2024-10-10T22:06:24.709Z","updated_at":"2025-04-08T13:32:40.801Z","avatar_url":"https://github.com/Simatwa.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003efzmovies-api\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"#\"\u003e\u003cimg alt=\"Python version\" src=\"https://img.shields.io/pypi/pyversions/fzmovies-api\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Simatwa/fzmovies-api/actions/workflows/python-test.yml\"\u003e\u003cimg src=\"https://github.com/Simatwa/fzmovies-api/actions/workflows/python-test.yml/badge.svg\" alt=\"Python Test\"/\u003e\u003c/a\u003e\n\u003ca href=\"LICENSE\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/static/v1?logo=GPL\u0026color=Blue\u0026message=GPLv3\u0026label=License\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://pypi.org/project/fzmovies-api\"\u003e\u003cimg alt=\"PyPi\" src=\"https://img.shields.io/pypi/v/fzmovies-api\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Simatwa/fzmovies-api/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/Simatwa/fzmovies-api?label=Release\u0026logo=github\" alt=\"Latest release\"\u003e\u003c/img\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Simatwa/fzmovies-api/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/release-date/Simatwa/fzmovies-api?label=Release date\u0026logo=github\" alt=\"release date\"\u003e\u003c/img\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/psf/black\"\u003e\u003cimg alt=\"Black\" src=\"https://img.shields.io/badge/code%20style-black-000000.svg\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Simatwa/fzmovies-api/actions/workflows/python-publish.yml\"\u003e\u003cimg src=\"https://github.com/Simatwa/fzmovies-api/actions/workflows/python-publish.yml/badge.svg\" alt=\"Python-publish\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://pepy.tech/project/fzmovies-api\"\u003e\u003cimg src=\"https://static.pepy.tech/personalized-badge/fzmovies-api?period=total\u0026units=international_system\u0026left_color=grey\u0026right_color=blue\u0026left_text=Downloads\" alt=\"Downloads\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Simatwa/fzmovies-api/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/downloads/Simatwa/fzmovies-api/total?label=Asset%20Downloads\u0026color=success\" alt=\"Downloads\"\u003e\u003c/img\u003e\u003c/a\u003e\n\u003ca href=\"https://hits.seeyoufarm.com\"\u003e\u003cimg src=\"https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com/Simatwa/fzmovies-api\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003e Unofficial Python API/SDK for fzmovies.net\n\n```python\nfrom fzmovies_api import Auto\n\nAuto(\n     query=\"Fast and Furious 5\",\n     quality=\"720p\",\n  ).run()\n\n# Will show download progressbar\n\"\"\"\nFast_and_Furious_5_BluRay v2_720p.mkv\n805 MB ██████████████████                            42%|\n\"\"\"\n\n```\n\n## Installation\n\n```\n$ pip install fzmovies-api[all]\n```\n\nAlternatively, you can download binaries for your system from [here](https://github.com/Simatwa/fzmovies-api/releases/latest).\n\n## Usage\n\n\u003cdetails\u003e\n\n\u003csummary\u003e\n  \u003ch3\u003eDevelopers\u003c/h3\u003e\n\u003c/summary\u003e\n\n```python\n# Search by Starcast\n\nfrom fzmovies_api import Search\n\nsearch = Search(\n    query=\"Jason Statham\",\n    searchby=\"Starcast\"\n)\n\nprint(\n    search.results\n)\n\n# Output\n\"\"\"\n\u003cSearchResults movies=[\u003cMovieInSearch title=\"Fast and Furious Presents - Hobbs and Shaw\",year=2019\u003e | \u003cMovieInSearch title=\"Fast X\",year=2023\u003e | \u003cMovieInSearch title=\"The Fate of the Furious [Part 8]\",year=2017\u003e | \u003cMovieInSearch title=\"Mechanic Resurrection\",year=2016\u003e | \u003cMovieInSearch title=\"The Meg\",year=2018\u003e | \u003cMovieInSearch title=\"Wrath of Man\",year=2021\u003e | \u003cMovieInSearch title=\"The Beekeeper\",year=2024\u003e | \u003cMovieInSearch title=\"Operation Fortune Ruse de guerre\",year=2023\u003e | \u003cMovieInSearch title=\"The Expendables 2\",year=2012\u003e | \u003cMovieInSearch title=\"The Expendables 3\",year=2014\u003e | \u003cMovieInSearch title=\"Meg 2 The Trench\",year=2023\u003e | \u003cMovieInSearch title=\"Homefront\",year=2013\u003e | \u003cMovieInSearch title=\"Parker\",year=2013\u003e | \u003cMovieInSearch title=\"Safe\",year=2012\u003e | \u003cMovieInSearch title=\"The Expendables 1\",year=2010\u003e | \u003cMovieInSearch title=\"The Transporter 2002\",year=2002\u003e | \u003cMovieInSearch title=\"Transporter 3 2008\",year=2008\u003e | \u003cMovieInSearch title=\"Death Race\",year=2008\u003e | \u003cMovieInSearch title=\"Expend4bles\",year=2023\u003e | \u003cMovieInSearch title=\"Transporter 2 2005\",year=2005\u003e]\u003e\n\"\"\"\n```\n\n#### Perform Search Using Filters\n\n```python\nfrom fzmovies_api import Search\nfrom fzmovies_api.filters import IMDBTop250Filter\n\nsearch = Search(\n    query = IMDBTop250Filter()\n)\n\nprint(\n    search.results\n)\n\n\n#Output\n\"\"\"\n\u003cSearchResults movies=[\u003cMovieInSearch title=\"Schindlers List\",year=1993\u003e | \u003cMovieInSearch title=\"The Godfather - Part 1\",year=1972\u003e | \u003cMovieInSearch title=\"Pulp Fiction\",year=1994\u003e | \u003cMovieInSearch title=\"12 Angry Men\",year=1957\u003e | \u003cMovieInSearch title=\"Terminator 2 Judgment Day\",year=1991\u003e | \u003cMovieInSearch title=\"The Avengers\",year=2012\u003e | \u003cMovieInSearch title=\"The Cold Light of Day\",year=2012\u003e | \u003cMovieInSearch title=\"The Good the Bad and the Ugly\",year=1966\u003e | \u003cMovieInSearch title=\"The Shawshank Redemption\",year=1994\u003e | \u003cMovieInSearch title=\"Raging Bull\",year=1980\u003e | \u003cMovieInSearch title=\"The Lion King\",year=1994\u003e | \u003cMovieInSearch title=\"New Gladiators\",year=2002\u003e | \u003cMovieInSearch title=\"The Dictator\",year=2012\u003e | \u003cMovieInSearch title=\"The Matrix\",year=1999\u003e | \u003cMovieInSearch title=\"Heat\",year=1995\u003e | \u003cMovieInSearch title=\"2001 A Space Odyssey\",year=1968\u003e | \u003cMovieInSearch title=\"The Silence of the Lambs\",year=1991\u003e | \u003cMovieInSearch title=\"The Departed\",year=2006\u003e | \u003cMovieInSearch title=\"Braveheart\",year=1995\u003e | \u003cMovieInSearch title=\"Up\",year=2009\u003e]\u003e\n\"\"\"\n```\n\n#### Fetch All Search Results\n\n```python\nfrom fzmovies_api import Search\nfrom fzmovies_api.filters import IMDBTop250Filter\n\nsearch = Search(\n    query = IMDBTop250Filter()\n)\n\nprint(\n    search.all_results\n)\n\n```\n\n##### Limit movies and stream results\n\n```python\nfrom fzmovies_api import Search\nfrom fzmovies_api.filters import MovieGenreFilter\n\nsearch = Search(\n    query = MovieGenreFilter(\n        \"Action\"\n    )\n)\n\nfor result in search.get_all_results(\n    limit=40,\n    stream=True\n    ):\n\n    print(\n        result, end='\\n\\n'\n    )\n```\n\n#### Download Movies\n\n```python\nfrom fzmovies_api import Search, Navigate, DownloadLinks, Download\nfrom fzmovies_api.filters import OscarsFilter\n\nsearch = Search(\n    query=OscarsFilter(\n        category=\"Best Picture\"\n    )\n)\n\nfor movie in search.all_results.movies:\n\n    # Navigate to the specific movie-page\n    movie_page = Navigate(movie).results\n\n    # Go to page containing download link\n    download_link_page = DownloadLinks(\n        movie_page.files[1]\n    )\n\n    download_link_metadata = download_link_page.results\n\n    # Follow the link to download the movie\n    download_movie = Download(\n        download_link_metadata.links[0]\n    )\n\n    print(\n        \"Downloading : '\" + movie.title + \"' of size \" + download_link_metadata.size\n    )\n\n    # Dowload the movie using save method\n    saved_to = download_movie.save(\n        download_link_metadata.filename,\n        # To silence progressbar \u0026 any other stdout:\n        # progress_bar = False,\n        # quiet = True\n    )\n\n    print(\n        saved_to\n    )\n```\n\n##### Using Auto\n\n```python\nfrom fzmovies_api import Auto\nfrom fzmovies_api.filters import RecentlyReleasedFilter\n\nstart = Auto(\n    query=RecentlyReleasedFilter(\n        category=\"Hollywood\"\n    )\n)\n\nstart.run()\n```\n\n\n\u003c/details\u003e\n\n### CLI\n\n- Basic case yet very handy\n\n   ```sh\n   $ python -m fzmovies_api download \u003cQUERY\u003e\n   # e.g python -m fzmovies_api download \"Thor - Love and Thunder\"\n   ```\n\n\u003e [!TIP]\n\u003e Shorthand for `python -m fzmovies_api` is `fzmovies`\n\n\u003cdetails\u003e\n\n\u003csummary\u003e\n   \u003ccode\u003e$ fzmovies download --help\u003c/code\u003e\n\u003c/summary\u003e\n\n```\nUsage: python -m fzmovies_api download [OPTIONS] QUERY\n\n  Perform search and download first movie in the search results\n\nOptions:\n  -s, --searchby [Name|Director|Starcast]\n                                  Query search-by filter - Name\n  -c, --category [All|Bollywood|Hollywood|DHollywood]\n                                  Query movie category - All\n  -q, --quality [480p|720p]       Movie file download quality - 720p\n  -o, --output TEXT               Filename for saving the movie contents to\n  -d, --directory TEXT            Directory for saving the movie contents -\n                                  pwd\n  -z, --chunk-size INTEGER        Chunk_size for downloading files in KB - 512\n  -r, --resume                    Resume downloading incomplete files - False\n  -q, --quiet                     Not to stdout anything - False\n  -y, --yes                       Okay to all prompts - False\n  --help                          Show this message and exit.\n\n```\n\n\u003c/details\u003e\n\n\u003e [!NOTE]\n\u003e **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.\n\n## Disclaimer\n\nThis 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimatwa%2Ffzmovies-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimatwa%2Ffzmovies-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimatwa%2Ffzmovies-api/lists"}