Back to search
bead-color-codes
SkillGitHub
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
Markdown
[](/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
- # Bead Color Codes
- [](https://www.npmjs.com/package/bead-color-codes) [](LICENSE) [](LICENSE-DATA.md)
- **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)
- 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:
- - **what a colour becomes in another brand**, as 20 precomputed conversion tables, and
- - **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.
- 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.
- ## Palettes
- | Palette | Colours | Trust | Files | Pattern maker |
- | --- | --: | --- | --- | --- |
- | 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) |
- | 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) |
- | 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) |
- | 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) |
- | 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) |
- | 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) |
- | 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) |
- | 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) |
- ### How far to trust a palette
- - `official` — the maker publishes these numbers and ours match them
- - `measured` — measured from the maker's own material by a documented method
- - `cross-checked` — several independent sources compared, conflicts settled by a written rule
- - `community` — sampled from physical beads or photos by hobbyists, not independently checked
- - `approximate` — codes and names are right, the colour is a screen stand-in
- - `generated` — not a product line; our own list of the colours a craft uses
- Every fuse palette here is `community`. That is not a disclaimer we can skip past — see the next section for what it costs.
- 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.
- ## Brands do not line up (and the data says by how much)
- 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:
- | from ↓ to → | Perler | Hama | Artkal | Nabbi | MARD |
- | --- | --- | --- | --- | --- | --- |
- | **Perler** | — | 7.0 (1%) | 4.2 (13%) | 8.7 (1%) | 4.6 (13%) |
- | **Hama** | 5.7 (3%) | — | 5.0 (11%) | 9.2 (2%) | 3.9 (21%) |
- | **Artkal** | 5.1 (9%) | 6.7 (5%) | — | 8.7 (1%) | 4.3 (13%) |
- | **Nabbi** | 4.2 (6%) | 6.9 (10%) | 4.4 (6%) | — | 4.5 (10%) |
- | **MARD** | 6.0 (6%) | 7.4 (3%) | 5.6 (8%) | 9.3 (0%) | — |
- 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.
- 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.
- ```js
- convert('perler-midi', '80-19080', 'hama-midi', {limit: 2})
- // matches: H115 Bright Green ΔE 8.42
- // H98 Pastel Mint ΔE 13.66
- // sameName: H10 Green ΔE 19.48 <- both sold as "Green"
- ```
- 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.
- ## Craft geometry
- A colour list is not enough to draw a chart. [`data/crafts.json`](data/crafts.json) carries what EasyBeadPattern draws and prints with:
- | Craft | Cell | Layout | Pattern maker |
- | --- | --- | --- | --- |
- | Fuse beads | 5 × 5 mm, 29 × 29 pegboard | square | [Free Bead Pattern Maker](https://easybeadpattern.com) |
- | Pony beads | no reliable size | square | [Free Pony Bead Pattern Maker](https://easybeadpattern.com/pony-bead-pattern-maker) |
- | Kandi | no reliable size | square | [Free Kandi Pattern Maker](https://easybeadpattern.com/kandi-pattern-maker) |
- | Bead loom | 1.3 × 1.6 mm (Delica 11/0) | square | [Free Bead Loom Pattern Maker](https://easybeadpattern.com/bead-loom-pattern-maker) |
- | 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) |
- | 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) |
- | Friendship bracelet | one knot, no fixed size | square | [Free Friendship Bracelet Pattern Maker](https://easybeadpattern.com/friendship-bracelet-pattern-maker) |
- | Cross stitch | 1.81 × 1.81 mm (14-count Aida) | square | [Free Cross Stitch Pattern Maker](https://easybeadpattern.com/cross-stitch-pattern-maker) |
- 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.
- ## Use it
- ### Link the files straight from a CDN
- ```
- https://cdn.jsdelivr.net/npm/bead-color-codes@1/data/json/perler-midi.json
- https://cdn.jsdelivr.net/npm/bead-color-codes@1/data/csv/hama-midi.csv
- https://cdn.jsdelivr.net/npm/bead-color-codes@1/data/convert/perler-midi-to-hama-midi.json
- ```
- ### JavaScript
- No dependencies, ESM, types included.
- ```sh
- npm install bead-color-codes
- ```
- ```js
- import {getColor, nearest, convert, boards, shoppingList} from 'bead-color-codes'
- getColor('hama-midi', 'h-1') // "H01", "h1" and "H-01" all work
- // → { code: 'H01', name: 'White', hex: '#E5ECF1', rgb: [229, 236, 241] }
- nearest('#E8A0B0', 'dmc-floss', {limit: 2}) // closest floss to a colour
- // → [ { code: '604', name: 'Cranberry Lt', hex: '#EFA8C0', deltaE: 3.48 }, … ]
- convert('perler-midi', '80-15181', 'hama-midi') // Perler Light Grey → Hama
- // → { from: {…}, to: 'hama-midi', matches: [ { code: 'H77', deltaE: 6.89 }, … ], sameName: {…} }
- boards(58, 87) // how a pattern splits
- // → { cols: 2, rows: 3, total: 6, beads: 5046, cm: { w: 29, h: 43.5 }, … }
- shoppingList(pixels, 'perler-midi') // beads to buy, most used first
- // → [ { code: '80-19018', name: 'Black', hex: '#323234', deltaE: …, count: … }, … ]
- ```
- Also exported: `listPalettes`, `getPalette`, `searchColors`, `listCrafts`, `getCraft`, and from `bead-color-codes/color` the colour maths itself — `hexToLab`, `ciede2000`.
- ### Command line
- ```sh
- npx bead-color-codes palettes
- npx bead-color-codes convert perler-midi 80-19005 hama-midi
- npx bead-color-codes nearest '#E8A0B0' artkal-s --limit 5
- npx bead-color-codes list hama-midi --format csv
- npx bead-color-codes boards 58 87
- ```
- ### MCP server (Claude, Cursor, VS Code…)
- 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.
- ```sh
- claude mcp add bead-color-codes -- npx -y bead-color-codes mcp
- ```
- ```json
- {
- "mcpServers": {
- "bead-color-codes": {
- "command": "npx",
- "args": ["-y", "bead-color-codes", "mcp"]
- }
- }
- }
- ```
- - `list_palettes` — every palette and how far to trust it
- - `get_color` — one colour by its code, written any reasonable way
- - `find_closest` — closest colours to a hex value, ranked by CIEDE2000
- - `convert_color` — a code in one brand → its closest equivalents in another
- - `search_colors` — search by name or code
- - `get_craft_geometry` — cell size, row offsets and pegboard per craft
- - `plan_pegboards` — how a pattern splits onto boards, and its finished size
- ## Data format
- Every palette file carries its own provenance:
- ```jsonc
- {
- "id": "hama-midi",
- "brand": "Hama",
- "product": "Hama Midi beads (5 mm)",
- "count": 92,
- "status": "community",
- "notes": "Hama H-codes (H01, H02 ...). Sampled from physical beads by hobbyists.",
- "sources": [{ "title": "maxcleme/beadcolors", "url": "…", "license": "MIT" }],
- "license": "MIT",
- "easybeadpattern": "https://easybeadpattern.com/hama-bead-pattern-maker",
- "chart": "https://easybeadpattern.com/colors/hama",
- "colors": [
- { "code": "H01", "name": "White", "hex": "#E5ECF1", "rgb": [229, 236, 241], "source": "Jeppewl" },
- { "code": "H19", "name": "Clear", "hex": "#D8D2CE", "rgb": [216, 210, 206], "special": true }
- ]
- }
- ```
- `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.
- Everything under `data/` is generated. To change a value, edit the CSV in [`source/`](source) and run `npm run build`.
- ## Found a wrong colour?
- 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.
- ## Sources and licence
- Where every number comes from: [SOURCES.md](SOURCES.md).
- - **Code** — MIT, see [LICENSE](LICENSE).
- - **Fuse bead palettes** — MIT, from [maxcleme/beadcolors](https://github.com/maxcleme/beadcolors), reshaped here.
- - **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).
- Suggested credit:
- > Bead colour data from [bead-color-codes](https://github.com/comficker/bead-color-codes) by [EasyBeadPattern](https://easybeadpattern.com), CC BY 4.0.
- ## About EasyBeadPattern
- [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 inFree to use. If it’s helped, pass it on.