{"id":20434264,"url":"https://github.com/alex8088/shadowizer","last_synced_at":"2025-10-29T00:09:31.609Z","repository":{"id":245131064,"uuid":"817351712","full_name":"alex8088/shadowizer","owner":"alex8088","description":"A cli tool for adding box shadow to images","archived":false,"fork":false,"pushed_at":"2024-06-22T16:02:37.000Z","size":678,"stargazers_count":12,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-21T01:35:03.031Z","etag":null,"topics":["box-shadow","image","shadow"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/alex8088.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-06-19T14:19:35.000Z","updated_at":"2024-06-30T02:41:34.000Z","dependencies_parsed_at":"2024-06-22T23:36:42.849Z","dependency_job_id":"ecc1a887-a452-491b-87be-f5ca54848175","html_url":"https://github.com/alex8088/shadowizer","commit_stats":null,"previous_names":["alex8088/shadowizer"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alex8088%2Fshadowizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alex8088%2Fshadowizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alex8088%2Fshadowizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alex8088%2Fshadowizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alex8088","download_url":"https://codeload.github.com/alex8088/shadowizer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248631682,"owners_count":21136562,"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":["box-shadow","image","shadow"],"created_at":"2024-11-15T08:25:33.612Z","updated_at":"2025-10-29T00:09:31.498Z","avatar_url":"https://github.com/alex8088.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eshadowizer\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003eA cli tool for adding box shadow to images\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://img.shields.io/npm/v/shadowizer?color=orange\u0026label=version\"\u003e\n\u003cimg src=\"https://img.shields.io/github/license/alex8088/shadowizer?color=blue\" alt=\"license\" /\u003e\n\u003c/p\u003e\n\n\u003cpre align=\"center\"\u003enpm i -g \u003cb\u003eshadowizer\u003c/b\u003e\u003c/pre\u003e\n\n\u003cp align='center'\u003e\u003cb\u003eBefore\u003c/b\u003e\u003c/p\u003e\n\n\u003cp align='center'\u003e\n\u003cimg src='./screenshots/before.jpg' width=\"364\"/\u003e\n\u003c/p\u003e\n\n\u003cp align='center'\u003e\u003cb\u003eAfter\u003c/b\u003e\u003c/p\u003e\n\n\u003cp align='center'\u003e\n\u003cimg src='./screenshots/after.png' width=\"394\"/\u003e\n\u003c/p\u003e\n\n## Usage\n\nSee `shadowizer --help` for more details.\n\n### shadowizer [root]\n\nFind images and add box shadow to them. You can specify the root directory, which can be an absolute path, or a path relative to the current working directory. Default to `process.cwd()`.\n\nIt should be noted that all images with added shadows will be output in `png` format to the `shadowizer-{timestamp}` directory in the root directory.\n\n\u003e Why not other output formats such as `jpeg`, because png supports transparency.\n\n| Options                | Description                                                                  |\n| ---------------------- | :--------------------------------------------------------------------------- |\n| `-f, --files`          | specify images, support glob patterns, default: `\\*.{png,jpg,jpeg,webp}` |\n| `-c, --shadowColor`    | set shadow color, default: `#00000073`                                       |\n| `-b, --shadowBlur`     | set shadow blur, default: `25`                                               |\n| `-x, --shadowOffsetX`  | set shadow offset x, default: `0`                                            |\n| `-y, --shadowOffsetY ` | set shadow offset y, default: `0`                                            |\n\nExample：\n\n```sh\n# specify directory to find images\nshadowizer path/to\n\n# specify multiple images\nshadowizer -f text.png -f fun.png\n\n# specify images with glob patterns\nshadowizer -f *.png\n\n# set shadow color\nshadowizer -c #00000073\n```\n\n## API\n\n### addShadow\n\n- type: `(imagePath: string, shadow?: ShadowOptions) =\u003e Promise\u003cvoid | Buffer\u003e`\n\nAdds a box shadow to the specified image.\n\n```js\nimport { addShadow } from 'shadowizer'\n```\n\n### saveShadowImage\n\n- type: `(imagePath: string, outDir?: string, shadow?: ShadowOptions) =\u003e Promise\u003cboolean\u003e`\n\nAdds a box shadow to the specified image and saves it to disk.\n\n```js\nimport { saveShadowImage } from 'shadowizer'\n```\n\n## License\n\n[MIT](./LICENSE) © alex.wei\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falex8088%2Fshadowizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falex8088%2Fshadowizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falex8088%2Fshadowizer/lists"}