{"id":13587351,"url":"https://github.com/BenjaminOddou/alfred-folderify","last_synced_at":"2025-04-07T21:33:45.460Z","repository":{"id":144139740,"uuid":"596306970","full_name":"BenjaminOddou/alfred-folderify","owner":"BenjaminOddou","description":"📁 Generate pixel-perfect macOS folder icons","archived":false,"fork":false,"pushed_at":"2023-05-24T18:03:33.000Z","size":2860,"stargazers_count":12,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-02-13T21:47:59.162Z","etag":null,"topics":["alfred","alfred-workflow","alfred5","alfred5-workflow","folder","folderify","icons","image-generator","image-processing","shell","zsh"],"latest_commit_sha":null,"homepage":"https://alfred.app/workflows/benjaminoddou/folderify/","language":"Shell","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/BenjaminOddou.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}},"created_at":"2023-02-01T22:34:05.000Z","updated_at":"2024-02-13T21:47:59.920Z","dependencies_parsed_at":"2023-08-10T02:46:52.569Z","dependency_job_id":null,"html_url":"https://github.com/BenjaminOddou/alfred-folderify","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BenjaminOddou%2Falfred-folderify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BenjaminOddou%2Falfred-folderify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BenjaminOddou%2Falfred-folderify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BenjaminOddou%2Falfred-folderify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BenjaminOddou","download_url":"https://codeload.github.com/BenjaminOddou/alfred-folderify/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223295380,"owners_count":17121773,"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":["alfred","alfred-workflow","alfred5","alfred5-workflow","folder","folderify","icons","image-generator","image-processing","shell","zsh"],"created_at":"2024-08-01T15:06:10.296Z","updated_at":"2024-11-06T06:30:50.628Z","avatar_url":"https://github.com/BenjaminOddou.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"\u003cimg src=\"public/icon_dark_mode.webp#gh-dark-mode-only\" alt=\"logo-dark\" height=\"55\"/\u003e\n\u003cimg src=\"public/icon_light_mode.webp#gh-light-mode-only\" alt=\"logo-light\" height=\"55\"/\u003e\n\n[![made with heart by Benjamin Oddou](https://img.shields.io/badge/made%20with%20%E2%99%A5%20by-benjamin%20oddou-3FAEFF.svg?style=flat)](https://github.com/BenjaminOddou)\n[![saythanks](https://img.shields.io/badge/say-thanks-0182E5.svg?style=flat)](https://saythanks.io/to/BenjaminOddou)\n\nWelcome to the Alfred Folderify repository: **An Alfred Workflow** ✨\n\n## ✅ Prerequisites\n\n* MacOS\n* Alfred 5. Note that the [Alfred Powerpack](https://www.alfredapp.com/powerpack/) is required to use workflows.\n\n## ⬇️ Installation\n\n1. [Download the workflow](https://github.com/BenjaminOddou/alfred-folderify/releases/latest)\n2. Double click the `.alfredworkflow` file to install\n\n## 🏎️ Folderify\n\nUnder the hood, the icon generation is made with [folderify](https://github.com/lgarron/folderify) made by [Lucas Garron](https://github.com/lgarron).\n\n## 🧰 Setup the workflow\n\n### Install dependencies\n\n#### Open the Terminal of you Mac and run the following commands\n\nInstall folderify (using [Homebrew](https://brew.sh)) :\n\n```shell\nbrew install folderify\n```\n\n\u003e Note that you have [other installation options](https://github.com/lgarron/folderify#other-installation-options) for folderify\n\n## 🧙‍♂️ Invoke the workflow\n\nThere are 2 flows in this workflow :\n\n1. The first one allows you to assign an generated icon to one or multiple folder(s). It can be triggered by writing `foldicon` keyword.\n2. The second allows you to generate `mask.icns` and `mask.iconset` files from one or multiple mask(s). You can invoke this flow with the `imgicon` keyword.\n\nYou can edit these triggers (flagged with a `🕹️` symbol) in the user configuration panel.\n\n## 🤖 Usage of the workflow\n\n### Setup variables\n\n1. `📂 Data Folder`. Set the folder path that will host output logs generated by folderify.\n\n\u003e Note that if you change the `Data folder` location after generating logs, you should probably move the file created along in the new folder.\n\n2. `🎨 Color scheme` corresponds to the `--color-scheme COLOR_SCHEME` folderify argument and allows you to change the color of the icon folder (slight difference). \n\n`🌓 Auto` : will match current system settings.\n\n`🌑 Dark` : --color-scheme dark will force dark mode.\n\n![big_sur_dark](public/big_sur_dark.webp)\n\n`🌕 Light` : --color-scheme light will force light mode.\n\n![big_sur_light](public/big_sur_light.webp)\n\n1. `✂️ Trim margins` corresponds to the `--no-trim` folderify argument.\n\n`Yes 👍` : checkbox is ticked, transparent margins are trimmed from all 4 sides.\n\n![big_sur_dark](public/big_sur_dark.webp)\n\n`No 👎` : checkbox is unticked, --no-trim. Keeps transparent margins from the mask.\n\n![no_trim](public/no_trim.webp)\n\nHere is a small schema to explain the principle :\n\n![schema_trim](public/schema_trim.webp)\n\n4. `📃 Detailed Logs` : corresponds to the `--verbose` folderify argument. \n\n`Yes 👍` : checkbox is ticked, --verbose, detailed output.\n\n![log_detailed](public/log_detailed.webp)\n\n`No 👎` : checkbox is unticked, simple output.\n\n![log_simple](public/log_simple.webp)\n\n1. `🔫 Workflow action`. Open/Reveal in finder the log file, display a post notification or do nothing.\n\n2. `🎷 Notification sound`. Set notification sound for this workflow.\n\n\u003e As of version 1.4.0, this is no longer possible to generate old folder style (leopard / yosemite). You can still download v2 of folderify [here](https://pypi.org/project/folderify/).\n\n### Modify icons folders\n\n\u003e Use `foldicon` to trigger this flow.\n\n![trigger1_1](public/trigger1_1.webp)\n\nChoose the mask that will be used for generating the new icon and press ⏎.\n\n![trigger1_2](public/trigger1_2.webp)\n\n### Reset icon folder\n\nTo reset a folder’s icon, open its Get Info panel then click the icon and press ⌫.\n\n### Generate icns and iconset files\n\n\u003e Use `imgicon` to trigger this flow.\n\n![trigger2_1](public/trigger2_1.webp)\n\n### Alfred Buffer and Universal Actions\n\nFor both flows, you can use the `Alfred Buffer` to select multiple folder(s) (flow 1) or mask(s) (flow 2).\n\n`Alfred Buffer` basic commands are :\n\n* ⌥↑ to add a file to the buffer from Alfred's results.\n* ⌥↓ to add a file and move to the next item in your list of results.\n* ⌥← to remove the last item from the buffer.\n* ⌥→ to action all items in the buffer.\n* ⌥⌫ to remove all items from the buffer.\n\nTo know more on how to use `Alfred Buffer`, follow this [link](https://www.alfredapp.com/help/features/file-search/#file-buffer).\n\n\u003e Note that `Alfred Buffer` is preferred compared to the `{query}`, meaning that if you select a folder/image (by clicking on it or by pressing enter ⏎) that is not included in the buffer, **it will not be compressed**.\n\n![alfred_buffer1](public/alfred_buffer1.webp)\n\n![alfred_buffer2](public/alfred_buffer2.webp)\n\nFor both flows you can use the corresponding `Alfred Universal Actions` :\n\n1. If you want to start the first flow, select one or multiple folders and select `Modify folder icon`.\n\n![universal1](public/universal1.webp)\n\n2. If you want to start the second flow, select one or multiple folders and select `Create folder icon from mask`.\n\n![universal2](public/universal2.webp)\n\n### Logs output\n\nCheck the logs of the folderify command under the `📂 Data folder`. The log file contains the 3 parts :\n1. Date and time of the workflow launch.\n2. Workflow options.\n3. Folderify command detailed.\n4. Folderify output.\n\n\u003e Note that each workflow run is separated by an horizontal rule.\n\n![log_simple](public/log_simple.webp)\n\n## ⚖️ License\n\n[MIT License](LICENSE) © Benjamin Oddou\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBenjaminOddou%2Falfred-folderify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FBenjaminOddou%2Falfred-folderify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBenjaminOddou%2Falfred-folderify/lists"}