{"id":18613893,"url":"https://github.com/sameera-madushan/posterpy","last_synced_at":"2025-04-10T23:32:10.369Z","repository":{"id":43225738,"uuid":"257352093","full_name":"sameera-madushan/PosterPy","owner":"sameera-madushan","description":"Python script that helps you to search, download movie posters and set them as folder icons.","archived":false,"fork":false,"pushed_at":"2023-05-22T23:24:02.000Z","size":22,"stargazers_count":53,"open_issues_count":7,"forks_count":3,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-25T06:51:12.449Z","etag":null,"topics":["folder-icons","icon-changer","movie-poster","python"],"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/sameera-madushan.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":"2020-04-20T17:14:29.000Z","updated_at":"2025-01-26T13:27:43.000Z","dependencies_parsed_at":"2023-01-22T00:19:42.463Z","dependency_job_id":null,"html_url":"https://github.com/sameera-madushan/PosterPy","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sameera-madushan%2FPosterPy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sameera-madushan%2FPosterPy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sameera-madushan%2FPosterPy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sameera-madushan%2FPosterPy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sameera-madushan","download_url":"https://codeload.github.com/sameera-madushan/PosterPy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248316484,"owners_count":21083453,"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":["folder-icons","icon-changer","movie-poster","python"],"created_at":"2024-11-07T03:24:08.160Z","updated_at":"2025-04-10T23:32:10.107Z","avatar_url":"https://github.com/sameera-madushan.png","language":"Python","funding_links":["https://www.buymeacoffee.com/sameeramadushan"],"categories":[],"sub_categories":[],"readme":"# PosterPy\n\nThis is a python script that helps you to search, download movie posters and set them as folder icons. PosterPy uses the popular [IMDbPY](https://imdbpy.github.io/) package to search movies and [TMDb a.k.a The Movie Data Base](https://www.themoviedb.org/) API to download movie posters.\n\n![iaa1](https://user-images.githubusercontent.com/55880211/80022395-a2b95700-84f9-11ea-8dca-d0f0eff217bd.gif)\n\n## For Your Attention \n\n- Your PC may take some time to index the newly added icons. If the icons doesn't appear after 3 - 5 minutes try clearing and resetting thumbnail cache of our PC. [Here](https://www.sevenforums.com/tutorials/10797-thumbnail-cache-clear-reset.html) is a article on how to clear and reset thumbnail cache in Windows.\n\n- Since PosterPy is using the TMDb API to download movie posters you need to have a TMDb API key in order to use this script. To register for an API key click [here](https://www.themoviedb.org/account/signup). Once you register an account [this](https://developers.themoviedb.org/3/getting-started/introduction) will help you to request and find your API key. (This is an one time process. Once you obatin your API key you need to enter it to the script when it ask for the key and that's it.)\n\n## I don't like these icons. How do i remove them?\n\nTo remove the poster icon from a folder, just delete the .ico and desktop.ini file from the folder. desktop.ini file is hidden by default. Therefore make sure you have __Show Hidden Items__ option ticked. \n\n## Screenshot\n\n![Untitled collage](https://user-images.githubusercontent.com/55880211/80029365-4f98d180-8504-11ea-84e3-f94a1fe64e09.png)\n\n## Git Installation\n```\n# clone the repo\n$ git clone https://github.com/sameera-madushan/PosterPy.git\n\n# change the working directory to PosterPy\n$ cd PosterPy\n\n# install the requirements\n$ pip3 install -r requirements.txt\n```\n\n## Usage\n\n```\npython posterpy.py\n```\n\n## Support \u0026 Contributions\n- Please ⭐️ this repository if this project helped you!\n- Contributions of any kind welcome!\n\n\u003ca href=\"https://www.buymeacoffee.com/sameeramadushan\" target=\"_blank\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" alt=\"Buy Me A Coffee\" style=\"height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;\" \u003e\u003c/a\u003e\n\n## License\nPosterPy is made with ♥ by [@_\\_sa_miya__](https://twitter.com/__sa_miya__) and it is released under the MIT license.\n\n## Contributors\n\nThanks goes to this wonderful person. :heart:\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/sdushantha\"\u003e\u003cimg src=\"https://avatars1.githubusercontent.com/u/27065646?s=400\u0026u=d50283901a14e11d6d387b7af1019bdaf12d3f93\u0026v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eSiddharth Dushantha\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003c/td\u003e\n\n\u003c/table\u003e\n\n## Attribution\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/55880211/80030773-4a3c8680-8506-11ea-876c-31501affbf0c.jpg\"\u003e\n  Movie posters are powered by themoviedb.org\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsameera-madushan%2Fposterpy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsameera-madushan%2Fposterpy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsameera-madushan%2Fposterpy/lists"}