Skip to content
Back to search

bead-color-codes

Codes, names and hex values for 1,068 bead and floss colours (Perler, Hama, Artkal, Nabbi, MARD, DMC, pony, seed), with cross-brand conversion tables and craft geometry.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/comficker--bead-color-codes/badge.svg)](/listings/comficker--bead-color-codes)

HTML

<a href="/listings/comficker--bead-color-codes"><img src="/api/listings/comficker--bead-color-codes/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 203 lines
  1. # Bead Color Codes
  2. [![npm](https://img.shields.io/npm/v/bead-color-codes)](https://www.npmjs.com/package/bead-color-codes) [![code: MIT](https://img.shields.io/badge/code-MIT-green)](LICENSE) [![data: CC BY 4.0](https://img.shields.io/badge/data-CC%20BY%204.0-blue)](LICENSE-DATA.md)
  3. **English** · [Deutsch](i18n/README.de.md) · [Français](i18n/README.fr.md) · [Español](i18n/README.es.md) · [Português (Brasil)](i18n/README.pt-BR.md) · [日本語](i18n/README.ja.md) · [简体中文](i18n/README.zh-CN.md)
  4. Codes, names and hex values for **1,068 bead and floss colours** — Perler, Hama, Artkal, Nabbi and MARD fuse beads, pony beads, seed beads and DMC floss — plus the two things a colour list alone never tells you:
  5. - **what a colour becomes in another brand**, as 20 precomputed conversion tables, and
  6. - **the geometry of the craft it is used in**: cell size in millimetres, how rows line up in peyote and brick stitch, and the 29 × 29 pegboard a fuse pattern is split onto.
  7. These are the palettes and the measurements behind [EasyBeadPattern](https://easybeadpattern.com), a free bead pattern maker. They are published here so that anyone writing a pattern maker, a colour converter or a shopping list does not have to collect them again — and so a wrong value gets fixed in one place.
  8. ## Palettes
  9. | Palette | Colours | Trust | Files | Pattern maker |
  10. | --- | --: | --- | --- | --- |
  11. | Perler Midi beads (5 mm) | 103 | `community` | [JSON](data/json/perler-midi.json) · [CSV](data/csv/perler-midi.csv) | [Free Perler Bead Pattern Maker](https://easybeadpattern.com/perler-bead-pattern-maker) · [colour chart](https://easybeadpattern.com/colors/perler) |
  12. | Hama Midi beads (5 mm) | 92 | `community` | [JSON](data/json/hama-midi.json) · [CSV](data/csv/hama-midi.csv) | [Free Hama Bead Pattern Maker](https://easybeadpattern.com/hama-bead-pattern-maker) · [colour chart](https://easybeadpattern.com/colors/hama) |
  13. | Artkal S series beads (5 mm) | 199 | `community` | [JSON](data/json/artkal-s.json) · [CSV](data/csv/artkal-s.csv) | [Free Artkal Bead Pattern Maker](https://easybeadpattern.com/artkal-bead-pattern-maker) · [colour chart](https://easybeadpattern.com/colors/artkal) |
  14. | Nabbi BioBeads (5 mm) | 30 | `community` | [JSON](data/json/nabbi.json) · [CSV](data/csv/nabbi.csv) | [Free Nabbi Bead Pattern Maker](https://easybeadpattern.com/nabbi-bead-pattern-maker) · [colour chart](https://easybeadpattern.com/colors/nabbi) |
  15. | MARD beads (5 mm) | 291 | `community` | [JSON](data/json/mard.json) · [CSV](data/csv/mard.csv) | [Free MARD Bead Pattern Maker](https://easybeadpattern.com/mard-bead-pattern-maker) · [colour chart](https://easybeadpattern.com/colors/mard) |
  16. | DMC six-strand embroidery floss | 273 | `approximate` | [JSON](data/json/dmc-floss.json) · [CSV](data/csv/dmc-floss.csv) | [Free Cross Stitch Pattern Maker](https://easybeadpattern.com/cross-stitch-pattern-maker) · [DMC colour chart](https://easybeadpattern.com/colors/dmc) |
  17. | Pony beads (generic) | 32 | `generated` | [JSON](data/json/pony.json) · [CSV](data/csv/pony.csv) | [Free Pony Bead Pattern Maker](https://easybeadpattern.com/pony-bead-pattern-maker) |
  18. | Seed beads 11/0 (generic) | 48 | `generated` | [JSON](data/json/seed.json) · [CSV](data/csv/seed.csv) | [Free Bead Loom Pattern Maker](https://easybeadpattern.com/bead-loom-pattern-maker) |
  19. ### How far to trust a palette
  20. - `official` — the maker publishes these numbers and ours match them
  21. - `measured` — measured from the maker's own material by a documented method
  22. - `cross-checked` — several independent sources compared, conflicts settled by a written rule
  23. - `community` — sampled from physical beads or photos by hobbyists, not independently checked
  24. - `approximate` — codes and names are right, the colour is a screen stand-in
  25. - `generated` — not a product line; our own list of the colours a craft uses
  26. Every fuse palette here is `community`. That is not a disclaimer we can skip past — see the next section for what it costs.
  27. No screen shows a physical bead exactly: finish, lighting and your monitor all move it. Use the hex to choose and compare; buy by the code.
  28. ## Brands do not line up (and the data says by how much)
  29. For every fuse colour, [`data/convert/`](data/convert) holds the three closest colours in each of the other four brands, ranked by CIEDE2000. The median distance to the **best** available match:
  30. | from ↓ to → | Perler | Hama | Artkal | Nabbi | MARD |
  31. | --- | --- | --- | --- | --- | --- |
  32. | **Perler** | — | 7.0 (1%) | 4.2 (13%) | 8.7 (1%) | 4.6 (13%) |
  33. | **Hama** | 5.7 (3%) | — | 5.0 (11%) | 9.2 (2%) | 3.9 (21%) |
  34. | **Artkal** | 5.1 (9%) | 6.7 (5%) | — | 8.7 (1%) | 4.3 (13%) |
  35. | **Nabbi** | 4.2 (6%) | 6.9 (10%) | 4.4 (6%) | — | 4.5 (10%) |
  36. | **MARD** | 6.0 (6%) | 7.4 (3%) | 5.6 (8%) | 9.3 (0%) | — |
  37. In brackets: the share of colours whose best match lands under ΔE 2.5, the point where most people stop seeing a difference. Reading across the Perler row: swap a Perler design to Hama and **one colour in a hundred** comes across unchanged.
  38. Some of that is real — Nabbi sells 30 colours, so of course a photo-matched Perler design cannot survive the move. Some of it is the sampling: these palettes were measured from physical beads by different people under different lights, and two makers' "Green" can sit ΔE 19 apart in the data while looking like cousins on the table. Where both brands sell a colour under the same name and the name match is not already in the top three, the table keeps it as `sameName` — a second, independent opinion to weigh against the numbers.
  39. ```js
  40. convert('perler-midi', '80-19080', 'hama-midi', {limit: 2})
  41. // matches: H115 Bright Green ΔE 8.42
  42. // H98 Pastel Mint ΔE 13.66
  43. // sameName: H10 Green ΔE 19.48 <- both sold as "Green"
  44. ```
  45. So: treat a conversion as a shortlist to hold against real beads, not an answer. If you want to see it applied to a whole image at once, drop the picture into the [bead pattern maker](https://easybeadpattern.com) and switch brand — the match is redone against that brand's palette.
  46. ## Craft geometry
  47. A colour list is not enough to draw a chart. [`data/crafts.json`](data/crafts.json) carries what EasyBeadPattern draws and prints with:
  48. | Craft | Cell | Layout | Pattern maker |
  49. | --- | --- | --- | --- |
  50. | Fuse beads | 5 × 5 mm, 29 × 29 pegboard | square | [Free Bead Pattern Maker](https://easybeadpattern.com) |
  51. | Pony beads | no reliable size | square | [Free Pony Bead Pattern Maker](https://easybeadpattern.com/pony-bead-pattern-maker) |
  52. | Kandi | no reliable size | square | [Free Kandi Pattern Maker](https://easybeadpattern.com/kandi-pattern-maker) |
  53. | Bead loom | 1.3 × 1.6 mm (Delica 11/0) | square | [Free Bead Loom Pattern Maker](https://easybeadpattern.com/bead-loom-pattern-maker) |
  54. | Peyote stitch | 1.3 × 1.6 mm | **peyote** — odd columns sit half a cell lower | [Free Peyote Pattern Maker](https://easybeadpattern.com/peyote-pattern-maker) |
  55. | Brick stitch | 1.6 × 1.3 mm | **brick** — every other row shifts half a cell right | [Free Brick Stitch Pattern Maker](https://easybeadpattern.com/brick-stitch-pattern-maker) |
  56. | Friendship bracelet | one knot, no fixed size | square | [Free Friendship Bracelet Pattern Maker](https://easybeadpattern.com/friendship-bracelet-pattern-maker) |
  57. | Cross stitch | 1.81 × 1.81 mm (14-count Aida) | square | [Free Cross Stitch Pattern Maker](https://easybeadpattern.com/cross-stitch-pattern-maker) |
  58. The peyote and brick offsets are the part most charts get wrong: drawn on a plain square grid, the design leans once it is on the thread.
  59. ## Use it
  60. ### Link the files straight from a CDN
  61. ```
  62. https://cdn.jsdelivr.net/npm/bead-color-codes@1/data/json/perler-midi.json
  63. https://cdn.jsdelivr.net/npm/bead-color-codes@1/data/csv/hama-midi.csv
  64. https://cdn.jsdelivr.net/npm/bead-color-codes@1/data/convert/perler-midi-to-hama-midi.json
  65. ```
  66. ### JavaScript
  67. No dependencies, ESM, types included.
  68. ```sh
  69. npm install bead-color-codes
  70. ```
  71. ```js
  72. import {getColor, nearest, convert, boards, shoppingList} from 'bead-color-codes'
  73. getColor('hama-midi', 'h-1') // "H01", "h1" and "H-01" all work
  74. // → { code: 'H01', name: 'White', hex: '#E5ECF1', rgb: [229, 236, 241] }
  75. nearest('#E8A0B0', 'dmc-floss', {limit: 2}) // closest floss to a colour
  76. // → [ { code: '604', name: 'Cranberry Lt', hex: '#EFA8C0', deltaE: 3.48 }, … ]
  77. convert('perler-midi', '80-15181', 'hama-midi') // Perler Light Grey → Hama
  78. // → { from: {…}, to: 'hama-midi', matches: [ { code: 'H77', deltaE: 6.89 }, … ], sameName: {…} }
  79. boards(58, 87) // how a pattern splits
  80. // → { cols: 2, rows: 3, total: 6, beads: 5046, cm: { w: 29, h: 43.5 }, … }
  81. shoppingList(pixels, 'perler-midi') // beads to buy, most used first
  82. // → [ { code: '80-19018', name: 'Black', hex: '#323234', deltaE: …, count: … }, … ]
  83. ```
  84. Also exported: `listPalettes`, `getPalette`, `searchColors`, `listCrafts`, `getCraft`, and from `bead-color-codes/color` the colour maths itself — `hexToLab`, `ciede2000`.
  85. ### Command line
  86. ```sh
  87. npx bead-color-codes palettes
  88. npx bead-color-codes convert perler-midi 80-19005 hama-midi
  89. npx bead-color-codes nearest '#E8A0B0' artkal-s --limit 5
  90. npx bead-color-codes list hama-midi --format csv
  91. npx bead-color-codes boards 58 87
  92. ```
  93. ### MCP server (Claude, Cursor, VS Code…)
  94. Give an assistant the palettes as tools, so "what is Perler 80-19005 in Hama?" or "closest DMC floss to #E8A0B0?" is answered from the data instead of from memory.
  95. ```sh
  96. claude mcp add bead-color-codes -- npx -y bead-color-codes mcp
  97. ```
  98. ```json
  99. {
  100. "mcpServers": {
  101. "bead-color-codes": {
  102. "command": "npx",
  103. "args": ["-y", "bead-color-codes", "mcp"]
  104. }
  105. }
  106. }
  107. ```
  108. - `list_palettes` — every palette and how far to trust it
  109. - `get_color` — one colour by its code, written any reasonable way
  110. - `find_closest` — closest colours to a hex value, ranked by CIEDE2000
  111. - `convert_color` — a code in one brand → its closest equivalents in another
  112. - `search_colors` — search by name or code
  113. - `get_craft_geometry` — cell size, row offsets and pegboard per craft
  114. - `plan_pegboards` — how a pattern splits onto boards, and its finished size
  115. ## Data format
  116. Every palette file carries its own provenance:
  117. ```jsonc
  118. {
  119. "id": "hama-midi",
  120. "brand": "Hama",
  121. "product": "Hama Midi beads (5 mm)",
  122. "count": 92,
  123. "status": "community",
  124. "notes": "Hama H-codes (H01, H02 ...). Sampled from physical beads by hobbyists.",
  125. "sources": [{ "title": "maxcleme/beadcolors", "url": "…", "license": "MIT" }],
  126. "license": "MIT",
  127. "easybeadpattern": "https://easybeadpattern.com/hama-bead-pattern-maker",
  128. "chart": "https://easybeadpattern.com/colors/hama",
  129. "colors": [
  130. { "code": "H01", "name": "White", "hex": "#E5ECF1", "rgb": [229, 236, 241], "source": "Jeppewl" },
  131. { "code": "H19", "name": "Clear", "hex": "#D8D2CE", "rgb": [216, 210, 206], "special": true }
  132. ]
  133. }
  134. ```
  135. `special` marks clear, glitter, neon and glow beads: they change once ironed, so the hex is only a stand-in and they are skipped by `nearest()` and by the conversion tables unless you ask for them. `source` names whoever sampled that colour, where the upstream data records it.
  136. Everything under `data/` is generated. To change a value, edit the CSV in [`source/`](source) and run `npm run build`.
  137. ## Found a wrong colour?
  138. Open an issue with the code, the brand and what you compared it against — a photo of the bead next to a colour card beats an opinion. Corrections go upstream too, so the next person gets them. This is community-sampled data: it gets better only when people who own the beads say something.
  139. ## Sources and licence
  140. Where every number comes from: [SOURCES.md](SOURCES.md).
  141. - **Code** — MIT, see [LICENSE](LICENSE).
  142. - **Fuse bead palettes** — MIT, from [maxcleme/beadcolors](https://github.com/maxcleme/beadcolors), reshaped here.
  143. - **Everything we assembled** (pony, seed and DMC lists, the conversion tables, the craft geometry) — CC BY 4.0, see [LICENSE-DATA.md](LICENSE-DATA.md).
  144. Suggested credit:
  145. > Bead colour data from [bead-color-codes](https://github.com/comficker/bead-color-codes) by [EasyBeadPattern](https://easybeadpattern.com), CC BY 4.0.
  146. ## About EasyBeadPattern
  147. [EasyBeadPattern](https://easybeadpattern.com) turns a photo, a drawing or pixel art into a bead pattern matched to real beads you can buy, with a bead count per colour and a printable page for each pegboard. It runs in the browser — the image is never uploaded — and it is free with no sign-up. There are [ready-made patterns](https://easybeadpattern.com/patterns), [guides](https://easybeadpattern.com/guides), a [bead letter and alphabet maker](https://easybeadpattern.com/bead-letters) and a [beadwork designer](https://easybeadpattern.com/beadwork) for drawing from scratch.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.