{"id":13479232,"url":"https://github.com/eth-p/mac-icons","last_synced_at":"2025-03-24T00:32:44.774Z","repository":{"id":53024648,"uuid":"356141997","full_name":"eth-p/mac-icons","owner":"eth-p","description":"An assortment of custom MacOS folder icons, editable without Adobe products.","archived":false,"fork":false,"pushed_at":"2022-09-07T22:51:43.000Z","size":2317,"stargazers_count":13,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-19T02:38:18.639Z","etag":null,"topics":["folder-icons","icns","icons","iconset","mac","mac-folder-icons","macos","macos-folder-icons"],"latest_commit_sha":null,"homepage":"","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/eth-p.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-04-09T05:04:58.000Z","updated_at":"2025-01-26T20:13:53.000Z","dependencies_parsed_at":"2023-01-17T23:15:55.363Z","dependency_job_id":null,"html_url":"https://github.com/eth-p/mac-icons","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eth-p%2Fmac-icons","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eth-p%2Fmac-icons/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eth-p%2Fmac-icons/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eth-p%2Fmac-icons/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eth-p","download_url":"https://codeload.github.com/eth-p/mac-icons/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245191486,"owners_count":20575246,"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","icns","icons","iconset","mac","mac-folder-icons","macos","macos-folder-icons"],"created_at":"2024-07-31T16:02:11.879Z","updated_at":"2025-03-24T00:32:39.761Z","avatar_url":"https://github.com/eth-p.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# mac-icons\n\nAn assortment of custom MacOS folder icons designed to match the native look and feel.\n\n\n## Screenshots\n![image](https://user-images.githubusercontent.com/32112321/114133617-2a3ed800-98bb-11eb-80b5-3aa783c650a2.png)\n\n\n\n## Installation\n\n**Step 1: Download the icons.**  \nDownload the zip for your version of MacOS from the [latest release](https://github.com/eth-p/mac-icons/releases/latest).\n\n**Step 2: Find a folder.**  \nIn Finder, right-click on the folder you want to apply an icon to and choose \"Get Info\".\n\n**Step 3: Copy the icon.**  \nIn Finder, copy the icon you want to apply to the folder.\n\n**Step 4: Apply the icon.**  \nInside the \"Get Info\" window, click on the folder icon and press `Command + V`.\n\n**Step 5: You're done!**  \nEnjoy your new folder icon.\n\n**ALTERNATE INSTRUCTIONS:**  \nhttps://support.apple.com/en-ca/guide/mac-help/mchlp2313/mac\n\n\n## DIY Instructions\n\nIf you want to build your own icon engravings, you'll need to install a couple of things:\n\n- A computer running MacOS.\n- A SVG editor of your choice.\n- ImageMagick (`brew install imagemagick`)\n- librsvg (`brew install librsvg`)\n\nOnce everything is installed, you're ready to go!  \n\n1. Create a `512x512` monochrome SVG file and save it under `Create/Engravings`.\n2. Double-click the `Create.command` file (or run it with `bash Create.command`).\n\nIf you're familiar with the command line, you can create individual images like so:\n\n```bash\nbash generate.sh \"Create/Templates/(Template)\" \"Create/Engravings/(Engraving).svg\" \"Icon.icns\"\n```\n\n\n## DIY Pro Instructions\n\n**If you want to build your own folder templates, you'll need to know how to use the ImageMagick command line to manipulate images.**\n\nA template is a MacOS `.iconset` with an extra `imio.sh` file inside.\nThe `imio.sh` file is a bash script that contains functions used to create the embossed engraving and apply it to the template folder icons:\n\n```bash\ntemplate_info() {\n\techo \"My First Template\"\n}\n\n# This function will emboss the icon engraving.\n#\n# Input:\n#   $1             -- The engraving image.\n#   $ICON_HEIGHT   -- The icon height in pixels.\n#   $ICON_WIDTH    -- The icon width in pixels.\n#   $ICON_TYPE     -- The icon type (i.e. iconset suffix)\n#   $ICON_VARIANT  -- The icon variant (e.g. '@1x' or '@2x')\n# \n# Output:\n#   The raw BMP-format image data for the embossed engraving.\n#   You can use `bmp:-` as the ImageMagick output file for that.\ntemplate_emboss() {\n\t\n\t# This command will turn the engraving red.\n\t# More advanced commands will be needed to create an emboss effect.\n\tmagick convert \"$1\" \\( -clone 0 -fill '#ff0000' -colorize 100 \\) \\\n\t\t-background none -compose Src -flatten \\\n\t\tbmp:-\n\t\n}\n\n# This function will combine the engraving and the template folder icon.\n# \n# Input:\n#   $1             -- The embossed engraving image.\n#   $2             -- The folder image.\n#   $ICON_HEIGHT   -- The icon height in pixels.\n#   $ICON_WIDTH    -- The icon width in pixels.\n#   $ICON_TYPE     -- The icon type (i.e. iconset suffix)\n#   $ICON_VARIANT  -- The icon variant (e.g. '@1x' or '@2x')\n# \n# Output:\n#   The raw PNG-format image data for the combined image.\n#   You can use `png:-` as the ImageMagick output file for that.\ntemplate_combine() {\n\t\n\t# Find the best placement geometry for the icon size.\n\t# The following values are for Big Sur.\n\tlocal geom=''\n\tcase \"${ICON_TYPE}\" in\n\t\t'16x16')                geom='8x8+0+1' ;;\n\t\t'32x32'|'16x16@2x')     geom='16x16+0+2' ;;\n\t\t'32x32@2x')             geom='32x32+0+3' ;;\n\t\t'128x128')              geom='64x64+0+6' ;;\n\t\t'256x256'|'128x128@2x') geom='128x128+0+12' ;;\n\t\t'512x512'|'256x256@2x') geom='256x256+0+25' ;;\n\t\t'512x512@2x')           geom='512x512+0+50' ;;\n\tesac\n\t\n\t# Composite the images.\n\tmagick composite -gravity Center \\\n\t    -compose ATop \\\n\t    -geometry \"$geom\" \\\n\t    \"$1\" \"$2\" \\\n\t    png:-\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feth-p%2Fmac-icons","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feth-p%2Fmac-icons","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feth-p%2Fmac-icons/lists"}