{"id":17309136,"url":"https://github.com/cornelk/beadmachine","last_synced_at":"2025-04-14T13:51:46.118Z","repository":{"id":28095411,"uuid":"31593475","full_name":"cornelk/beadmachine","owner":"cornelk","description":"Bead Pattern Generator","archived":false,"fork":false,"pushed_at":"2024-11-27T15:36:57.000Z","size":819,"stargazers_count":14,"open_issues_count":2,"forks_count":6,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-28T02:53:21.791Z","etag":null,"topics":["beads","golang","image-processing"],"latest_commit_sha":null,"homepage":"","language":"Go","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/cornelk.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":"2015-03-03T10:46:51.000Z","updated_at":"2025-03-15T20:14:45.000Z","dependencies_parsed_at":"2024-06-19T02:45:04.347Z","dependency_job_id":"9a4310dc-c347-4d96-992d-4af00b42b0ef","html_url":"https://github.com/cornelk/beadmachine","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/cornelk%2Fbeadmachine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cornelk%2Fbeadmachine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cornelk%2Fbeadmachine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cornelk%2Fbeadmachine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cornelk","download_url":"https://codeload.github.com/cornelk/beadmachine/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248891071,"owners_count":21178558,"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":["beads","golang","image-processing"],"created_at":"2024-10-15T12:26:57.482Z","updated_at":"2025-04-14T13:51:46.088Z","avatar_url":"https://github.com/cornelk.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# beadmachine\n\nA bead pattern creator. Convert any imagine into a suitable color palette pixel by pixel in order to be able to create a matching, beadable pattern.\nIt also shows you a statistic about the used beads.\n\n## Features\n\n- Cross-platform\n- Uses all available CPU cores to process the image\n- Supports gif/jpg/png as input file formats\n- Can output a HTML file with detailed info on which bead to use for each pixel\n- Color matching based on [CIEDE2000](http://en.wikipedia.org/wiki/Color_difference#CIEDE2000 \"\")\n- Included bead palettes: [Hama](http://www.hama.dk \"\")\n- Optional image resizing\n- Image filters to preprocess the input image\n\n## Installation\n\nCompiling the tool from source code needs to have a recent version of [Golang](https://go.dev/) installed.\n\n```\ngo install github.com/cornelk/beadmachine@latest\n```\n\n## Command-line options:\n```\nBead pattern creator\n\n  --verbose, -v          verbose output\n  --input INPUT, -i INPUT\n                         image to process\n  --output OUTPUT, -o OUTPUT\n                         output filename for the converted PNG image\n  --html HTML, -l HTML   output filename for a HTML based bead pattern file\n  --palette PALETTE, -p PALETTE\n                         filename of the bead palette [default: colors_hama.json]\n  --width WIDTH, -w WIDTH\n                         resize image to width in pixel\n  --height HEIGHT, -e HEIGHT\n                         resize image to height in pixel\n  --boardwidth BOARDWIDTH, -x BOARDWIDTH\n                         resize image to width in amount of boards\n  --boardheight BOARDHEIGHT, -y BOARDHEIGHT\n                         resize image to height in amount of boards\n  --boarddimension BOARDDIMENSION, -y BOARDDIMENSION\n                         dimension of a board [default: 20]\n  --beadstyle, -b        make output file look like a beads board\n  --translucent, -t      include translucent colors for the conversion\n  --nocolormatching, -n\n                         skip the bead color matching\n  --grey, -g             convert the image to greyscale\n  --blur BLUR            apply blur filter (0.0 - 10.0)\n  --sharpen              apply sharpen filter\n  --gamma GAMMA          apply gamma filter (0.0 - 10.0)\n  --contrast CONTRAST    apply contrast adjustment (-100 - 100)\n  --brightness BRIGHTNESS\n                         apply brightness adjustment (-1 - 1)\n  --help, -h             display this help and exit\n```\n\n## Example Usage\nTo convert the sample yoshi image to Hama bead colors:\n\n```bash\n./beadmachine -i examples/yoshi_thinking_in.png -o out.png -l pattern.html\n```\n\n\u003cimg src=\"https://raw.githubusercontent.com/CornelK/beadmachine/master/examples/yoshi_thinking_in.png\" alt=\"Yoshi thinking in\" height=\"96\" width=\"84\"/\u003e -\u003e \u003cimg src=\"https://raw.githubusercontent.com/CornelK/beadmachine/master/examples/yoshi_thinking_out.png\" alt=\"Yoshi thinking out\" height=\"96\" width=\"84\"/\u003e\n\nAnd will print out a statistic:\n\n```bash\n2023-08-01 19:22:28  INFO    Image pixels {\"width\":28,\"height\":32}\n2023-08-01 19:22:28  INFO    Bead board used {\"width\":1,\"height\":1}\n2023-08-01 19:22:28  INFO    Bead board measurement in cm {\"width\":14,\"height\":16}\n2023-08-01 19:22:28  INFO    Bead colors {\"count\":9}\n2023-08-01 19:22:28  INFO    Beads used {\"color\":\"H38 Neon orange\",\"count\":18}\n2023-08-01 19:22:28  INFO    Beads used {\"color\":\"H35 Neon red\",\"count\":13}\n2023-08-01 19:22:28  INFO    Beads used {\"color\":\"H1 White\",\"count\":525}\n2023-08-01 19:22:28  INFO    Beads used {\"color\":\"H18 Black\",\"count\":179}\n2023-08-01 19:22:28  INFO    Beads used {\"color\":\"H10 Green\",\"count\":30}\n2023-08-01 19:22:28  INFO    Beads used {\"color\":\"H42 fluorescent green\",\"count\":38}\n2023-08-01 19:22:28  INFO    Beads used {\"color\":\"H47 Pastel Green\",\"count\":72}\n2023-08-01 19:22:28  INFO    Beads used {\"color\":\"H4 Orange\",\"count\":10}\n2023-08-01 19:22:28  INFO    Beads used {\"color\":\"H27 Beige\",\"count\":11}\n```\n\nThe output of the HTML pattern file will look similar to this:\n\n\u003cimg src=\"https://raw.githubusercontent.com/CornelK/beadmachine/master/examples/yoshi_thinking_htmlpattern.png\" alt=\"Yoshi HTML pattern\"/\u003e\n\nTo convert the sample Mona Lisa image to Hama bead colors, resize to a width of 58 pixel and create a bead style output:\n\n```bash\n./beadmachine -i examples/mona_lisa_in.jpg -o out.png -w 58 -b --blur 2\n```\n\n\u003cimg src=\"https://raw.githubusercontent.com/CornelK/beadmachine/master/examples/mona_lisa_in.jpg\" alt=\"Mona Lisa in\" height=\"461\" width=\"310\"/\u003e -\u003e \u003cimg src=\"https://raw.githubusercontent.com/CornelK/beadmachine/master/examples/mona_lisa_out.png\" alt=\"Mona Lisa out\" height=\"461\" width=\"310\"/\u003e\n\nAnd will print out a statistic:\n```bash\n2023-08-01 19:22:28  INFO    Image pixels {\"width\":722,\"height\":1074}\n2023-08-01 19:22:28  INFO    Bead board used {\"width\":2,\"height\":3}\n2023-08-01 19:22:28  INFO    Bead board measurement in cm {\"width\":29,\"height\":43}\n2023-08-01 19:22:28  INFO    Output image pixels {\"width\":58,\"height\":86}\n2023-08-01 19:22:28  INFO    Bead colors {\"count\":17}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcornelk%2Fbeadmachine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcornelk%2Fbeadmachine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcornelk%2Fbeadmachine/lists"}