{"id":20081303,"url":"https://github.com/demberto/folderikon","last_synced_at":"2025-10-08T12:05:17.567Z","repository":{"id":57431694,"uuid":"412467618","full_name":"demberto/FolderIkon","owner":"demberto","description":"A Windows utility to set folder icons.","archived":false,"fork":false,"pushed_at":"2021-10-09T09:48:26.000Z","size":15,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-09T06:05:32.879Z","etag":null,"topics":["shell"],"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/demberto.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2021-10-01T12:59:58.000Z","updated_at":"2025-02-04T00:42:15.000Z","dependencies_parsed_at":"2022-09-02T11:51:46.941Z","dependency_job_id":null,"html_url":"https://github.com/demberto/FolderIkon","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/demberto%2FFolderIkon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/demberto%2FFolderIkon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/demberto%2FFolderIkon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/demberto%2FFolderIkon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/demberto","download_url":"https://codeload.github.com/demberto/FolderIkon/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252598256,"owners_count":21774227,"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":["shell"],"created_at":"2024-11-13T15:38:33.555Z","updated_at":"2025-10-08T12:05:12.487Z","avatar_url":"https://github.com/demberto.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FolderIkon\n\n![PyPI - Python Version](https://img.shields.io/pypi/pyversions/folderikon?color=g)\n![PyPI - Status](https://img.shields.io/pypi/status/folderikon)\n![License](https://img.shields.io/badge/license-MIT-green)\n![Lines of code](https://img.shields.io/tokei/lines/github/demberto/folderikon?label=loc)\n![Code Style: Black](https://img.shields.io/badge/code%20style-black-black)\n\n\u003e A Windows utility to set folder icons.\n\nNormally, setting a folder icon (not to be confused with a folder picture) through Windows Explorer requires an icon of ICO format, this means converting it first. Also changing the folder name will make the icon ineffective.\n\n**FolderIkon** will take a JPG, ICO or a PNG file, convert it, create/edit the configuration file `desktop.ini`, set the appropriate permissions and [notify the Shell](https://docs.microsoft.com/windows/win32/api/shlobj_core/nf-shlobj_core-shchangenotify) about the icon. The icon will be hidden as it has generally no other use, _also it is a 256x256 image, nothing beautiful_.\n\nHowever tilted images e.g those of product boxes etc. will not be displayed properly. A square image is recommended for optimum results. I suggest not to use images of other aspect ratios although they will work.\n\n## Installation\n\nRequires Python 3.6+ and Windows\n\n```\npip install --upgrade folderikon\n```\n\n## Usage\n\nSet the first ICO, JPG or PNG found in the current folder as the folder icon (subfolders not included).\n\n```\nfolderikon\n```\n\nSet `image` as the folder icon of the current folder. `image` can be a URL as well.\n\n```\nfolderikon -i image\n```\n\nSet `image` as the folder icon of `folder` and name the icon as `icon`\n\n```\nfolderikon -i image -d folder -o icon\n```\n\n## Note\n\nIt may take some time; or a restart of Windows Explorer for the folder icon to appear.\n\n## Command-line options\n\n```\nfolderikon [-h] [--image IMAGE] [--icon ICON] [--folder FOLDER] [--delete-original] [--raise-on-existing] [--dont-hide-icon] [--silent] [--no-color]\n\nA Windows utility to set folder icons.\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --image IMAGE, --input IMAGE, -i IMAGE\n                        The image to set as folder icon. JPG, ICO and PNG formats are supported. URLs can be specified as well. Defaults to the\n                        first JPG/PNG file found in the current folder.\n  --icon ICON, --output ICON, -o ICON\n                        Output icon file name. Defaults to the name of first JPG/PNG found in current folder saved with a '.ico' extension.\n  --folder FOLDER, -d FOLDER\n                        The path of the folder whose icon is to be set. Defaults to the current folder.\n  --delete-original, -f\n                        Deletes the original image.\n  --raise-on-existing   Raise an exception if the folder already has an icon.\n  --dont-hide-icon      The folder icon is marked as hidden by default. Use this option to not do it.\n  --no-color            Disables colored output.\n```\n\n### [TODO](TODO.md)\n\n### [Changelog](CHANGELOG.md)\n\n## Licence\n\nFolderIkon is distributed under the **MIT License**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdemberto%2Ffolderikon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdemberto%2Ffolderikon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdemberto%2Ffolderikon/lists"}