io.github.otsirhPublished by GitHub account otsirhv1.13.0Updated Nov 14, 2026
Book covers from a title and an author: 39 styles, 28 palettes, mockups, SVG and PNG.
Generates book covers from a title and author, with styles, palettes, mockups and print-ready artwork, returning image links and an editor link.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.otsirh%2Fbook-cover-generator/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"book-cover-generator": {
"type": "http",
"url": "https://covers.otsirh.dev/mcp"
}
}
}[CI] [npm] [Website] [Dependencies] [Types] [OpenSSF Scorecard] [OpenSSF Best Practices] [License: MIT]
Generate book covers from a title and an author. 39 styles, 28 palettes or your own colours, a seeded randomizer, any size, and export to SVG, PNG, JPEG or WebP. The library has no dependencies and ships TypeScript types. It's written as plain ES modules, so it runs in the browser, Node, Deno and Bun.
▶ Open the generator · See every style
On covers.otsirh.dev you type a title and author (press Enter in the title to break its line where you want), and if you like a subtitle, a series line ("Book Two of the Ember Cycle"), a credit ("Translated by…") and a badge ("Winner of the Hugo Award", set as a seal in a corner clear of the text). Then you choose:
Store size shrinks the preview to the size a store lists covers at, to check the title still reads. Randomize reshuffles everything, except what you've locked. Undo and redo (Z, or Ctrl/Cmd+Z) step back and forth through your designs, and survive a reload; the browser's Back button leaves the site. Copy link shares the exact design, because the URL holds every setting, and Copy embed link gives the HTTP API URL that draws it, to put in any page. The main download is a PNG (a JPEG for an eBook, as KDP takes), and the export panel tells you which size suits Kindle, print or audiobook covers.
Mockup shows and downloads the cover as a 3D book, a flat shot, on an e-reader, or on a social card (a 1200 × 630 link preview, a square post or a story, with a line such as "Out now").
Many covers takes a list of books (one per line as Title | Author | Subtitle, or a CSV with a title column) and makes them all with the design you have, as PNG or SVG in one ZIP. With a fixed variation they share one look, as a series does; switch on "A different palette for each" for a set in several colours.
Paperback for print makes the whole cover of a printed paperback from the design: the back with your headline, back cover text and imprint (and the barcode's box left clear), the spine with the title and author, and the front. Choose the trim size, the page count and the paper, and it sizes everything as Amazon KDP asks: an eighth of an inch of bleed, a spine as wide as the pages are thick (and blank under 80 pages, as KDP requires), the front's art carried into the bleed. Download print PDF saves the file to upload: one page at 300 dpi, its trim marked. The back and spine take any colour of the palette; the settings stay in your browser for next time.
Keep, the star on the preview (or K), saves a design to a tray under the preview, together with the cover as it was drawn, so a later version of the app can't change it. Download all saves every kept design as a PNG in one ZIP file. Export saves the kept designs to a file, and Import adds them in another browser.
The app works offline once it has loaded.
Keyboard shortcuts:
R randomizes.← and → step through styles.[ and ] step through palettes.Z undoes and Shift+Z redoes.The single-key shortcuts can be turned off under the controls (for example with speech input).
The site draws covers from a URL too, so a page can show one with nothing installed:
GET /api/cover.svg answers with the cover as SVG.GET /api/mockup.svg answers with a mockup of it. Add kind (book, flat, ereader, card, square, story), text for the line on a card, square or story, and background.GET /api/cover.json says what a query draws: the style, palette, colours, seed, size and pins it came to (so a random style or palette can be kept), its link with every choice written out, and its SVG, PNG, edit and share URLs.GET /api/catalog.json lists every style (with its genres and the choices it lets you pin), palette, genre, font, format and mockup; GET /api/openapi.json describes the API as OpenAPI 3.1.GET /api/cover.png and GET /api/mockup.png answer with the same as PNG, for places that don't take SVG (email, chat, social posts): a cover up to 600,000 pixels (600 × 900), a mockup up to 2.1 million (a 1080 × 1920 story; a flat or e-reader shot, whose shadow costs more, 1.3 million). A larger one is drawn smaller to fit; scale (above 0, up to 4) asks for a size, refused if it won't fit. Larger PNGs come from the app, which draws them in your browser. The server draws them with open fonts and lays the text out in their widths; they have Latin, Greek and Cyrillic letters, so a cover in another script (Chinese, Japanese, Arabic…) gets a 422: ask for its SVG.The query takes the options' own names (title, author, subtitle, series, credit, badge, style, palette, seed, genre, font, lang, width, height) and the app's link parameters, so the part of an app link after # draws the same design (the server measures text with the widths of the fonts as macOS draws them, so on another system a line can break a little differently from the app's preview):
A title breaks its line at %0A. A design's link from the app (Copy link: https://covers.otsirh.dev/?title=…) shows that design in link previews, as a social card drawn by /api/mockup.png. Anyone may embed the answers (CORS and Cross-Origin-Resource-Policy allow it), and the headers X-Cover-Style, X-Cover-Palette and X-Cover-Version say what was drawn. The same URL always draws the same cover in a version of the library, so answers are cached for a day. Options the library rejects get a 400 with the reason as plain text. Add download=1 to any image to get it as a file named after the title (or download=my-cover to name it).
The API is free to use. PNGs not yet cached are limited to 240 a minute for each client, and MCP requests to 600 (429 with Retry-After beyond that); SVGs aren't limited. If you need more, draw the covers in your own code with the library, or run your own copy: fork the repository, set your account_id and routes (or "workers_dev": true) in wrangler.jsonc, and run npx wrangler deploy.
<book-cover>One script, then a cover wherever you write the element:
(/element.js is the same as one minified file; /src/element.js loads the library's modules as they are.)
Its attributes are the app's link parameters, except the title and the style, which are cover-title and cover-style (title and style are HTML's own): cover-title, author, subtitle, series, credit, badge, cover-style, genre, palette, seed, format, font, case, variant, texture (present: on) and lang (the language of the text, such as zh-Hant). Styles, palettes and fonts may be named as the app's menus name them. With loading="lazy", as on an image, a cover draws only once it comes near the viewport (a page of many covers loads faster); until then it holds the cover's shape and is named for screen readers, and attributes changed meanwhile apply when it draws. The cover is 240 px wide unless you style the element's width; it draws again when an attribute changes, and fires cover (with the cover) or cover-error (with what's wrong). It is drawn in the page, measuring the text with the fonts installed there, and shown as an image, so a page with Trusted Types can show it (its CSP must allow data: images). An image can't use the page's web fonts: if the page loads one that a cover's font stack names (such as EB Garamond or Oswald), the text is measured in it but drawn in the system's font, and may fit less well. From npm: import 'book-cover-generator/element'.
Book Cover Generator is a Model Context Protocol server, so an assistant such as Claude can make covers for you: "a cover for my horror novel The Hollow Night, in red". It answers with a link to the image and one that opens the cover in the app to change and download.
Add it to Claude Code:
Or to any client that takes a JSON configuration (Claude Desktop, Cursor and others):
The tools: create_cover (a title, and any of author, subtitle, style, genre, palette or your own colours, seed, format, font, pins), create_mockup (the same, as a 3D book, on an e-reader or on a social card), list_styles and list_palettes. Each cover comes with links to its SVG, its PNG and the app; the hosted server also answers with the picture itself, so the assistant can see what it made and your client can show it. Run locally, create_cover can also save the SVG to a file (output, a path ending in .svg).
@1 gives you the latest 1.x release. Pin an exact version (such as @1.1.0) if you need the artwork to never change.
In Deno, import npm:book-cover-generator; in Bun, bun add book-cover-generator. CI checks that Node, Deno and Bun draw the same covers byte for byte.
Options: -s/--style, -p/--palette, --bg, --ink, --accent, --subtitle, --texture, --seed, --format (paperback, ebook or square), --width, --height, --size, --genre, --lang, --series, --credit, --badge, --font, --case upper|normal, --variant name=value (--list shows each style's), -o/--out, --count, --batch <file|->, --out-dir, --print <trim> with --pages, --paper, --hook, --blurb, --blurb-file and --imprint, --json, --list, --help. A print cover is an SVG at 96 px to the inch: the app makes the PDF, or any SVG converter does (rsvg-convert -f pdf).
generateCover(options) → stringReturns the SVG markup.
createCover(options) → { svg, body, style, palette, colors, seed, width, height, lang, variants, title, author }Same as generateCover, but also tells you which style and palette were chosen. This is useful when either one was random. body is the markup inside the outer <svg>, for nesting the cover in a larger SVG (its ids are unique to the cover, so several can share a document).
An ink that reads badly on its bg (under 3:1 contrast) is replaced with black or white, so the text is always readable; the cover's colors say which.
Styles, palettes, genres and fonts may be given by id or by name, in any case: 'artdeco', 'Art Deco' and 'ART DECO' are the same style, and a book list or a link can name them as the app's menus do.
lang is set on the cover so Chinese characters get the right glyphs for the language. Without it, text with kana is marked Japanese and text with Hangul Korean; pass 'zh-Hans', 'zh-Hant' or 'ja' for text in Chinese characters only.
Titles and subtitles longer than 300 characters (authors: 200) are cut. With 'random', the style and palette are picked from the seed, so you get the same result every time for the same seed. Some styles prefer dark or light palettes when they pick one themselves. Invalid options throw an error that says what's wrong.
styles: array of style idsgenres: [{ id, name }], the genres styles suit: literary, thriller, horror, romance, fantasy, children, nonfictionlistStyles(): [{ id, name, description, group, variants, genres }]. variants lists the choices a style lets you pin, as [{ name, label, values: [{ value, label }] }]; pin them with createCover({ variants: { scene: 'forest' } }), and createCover reports the ones it used in variants. Names a style lacks are ignored. A value no style offers throws; with a style you name, so does a value that style lacks (a style picked at random takes only the pins it can)palettes: [{ id, name, bg, ink, accents, dark? }]randomSeed(): a short random seed stringpickStyle(options): the style id createCover would use for these options (resolving 'random' from the seed), without drawing the coverregisterStyle({ id, name, description, group, prefer, render(ctx) }): add your own style (see below). Replacing a built-in style takes registerStyle(style, { replace: true }); unregisterStyle(id) removes a style or brings the built-in backregisterPalette({ id, name, bg, ink, accents }): add a palette to use by id, as palette: 'brand' ({ replace: true } for a built-in id); unregisterPalette(id) removes it. Registered styles and palettes can also be picked by 'random', so registering one changes what a seed givesparseBookList(text): a list of books (CSV with commas, semicolons or tabs and a header row naming a title column, JSON lines, or one "Title | Author | Subtitle" per line) as cover options, one per bookstyleIdFor(name): the id of the style a name or id names, in any case ('Art Deco' → 'artdeco'), or undefinedoptionsForBook(book, defaults): the options for one of those books over the options every book shares (its own values win; a genre the shared style doesn't suit picks a style that does)noteText(x0, y0, x1, y1) and recordText(draw): note where a custom style writes its own text (so a badge stays clear of it), and collect what draw notesversion: the library's version (artwork for a seed can change between minor versions)sizeLimits ({ min: 50, max: 10000, ratio: 3 }) and formats (paperback, ebook and square as [width, height] at 600 px wide): the sizes covers can have, and the app's shapestitleBlock, authorFit: the typography the built-in styles use (a title with its lead line and subtitle, and the author line)fitText, drawText, fitStack, drawStack, splitLead, measureText, setTextMeasurer, FONTS: lower-level text helpers (fitText can hyphenate one long word with hyphenate: px), and baselineOf, textBottom, textGroupAttrs, markExtent for styles that draw text themselvesstrongAccents, textColor, tintText, fitTitleWith, textPanel, TEXT_CONTRAST: the colour and layout helpers the built-in styles use (accents that stand out, text colours that stay readable, giving up art for a longer title, a panel for title and author)svgUtils: the SVG, colour and noise helpers the built-in styles useTypes are included. CoverOptions, Cover, StyleId, PaletteId, StyleGroup, StyleContext, CoverStyle, TitleBlock and the rest are exported from the main entry point, and style and palette ids autocomplete.
Product shots (flat, book, ereader) follow the cover's size on a light backdrop (background to change it); social cards have fixed sizes and take the cover's colours. mockupKinds lists them.
createPrintCover(cover, print) lays out the back (the hook, the blurb's paragraphs at the largest size from 12 to 8 pt that fits, an imprint, and the barcode's 2 × 1.2 in box kept clear), the spine (the title and author, from 80 pages and when they'd be readable) and the front (the cover these options draw at the trim's shape, its edges mirrored into the bleed). Sizes follow Amazon KDP: trim by name (trimSizes) or [width, height] in inches, paper (paperTypes: white, cream, color, premium-color), bleed (0.125 in) and pageThickness for another printer's figures, backColor and spineColor (the cover's background and ink by default), and guides to dash the trim, the folds and the barcode's box for a preview. spineWidth(pages, paper) gives the spine alone, pageRange(trim, paper) the page counts a trim takes on a paper, and printLimits what KDP takes. svgToPdf draws a page too large for one canvas in strips.
setDpi(blob, dpi) records the pixel density in a PNG or JPEG you made yourself. It and zipFiles also work in Node.
render(ctx) returns SVG markup without the outer <svg> element. ctx contains:
title, author, subtitle (may be empty; a credit follows the subtitle on a line of its own), series (set by titleBlock above the title)W, H: the size of the coveru: a scale unit (1 at a short side of 600px)m: the suggested marginS: the short side; base text sizes on it so wide covers workrng: seeded random with next, float, int, bool, pick, shufflep: the palette, with bg, ink, accents, plus paper (lighter) and night (darker)id(name): makes ids that are unique per cover, for gradients and filterstitleFont, titleCase: the cover's font and titleCase, or null; titleBlock follows them, so a style that sets its title with it gets them for freedrawText, drawStack or titleBlock is noted, so a badge stays clear of it; a style that writes its own text elements can call noteText(x0, y0, x1, y1)choose(name, values): picks one of values as rng.pick would, unless the cover pins the variant name. Declare what can be pinned in the style's variants: { mood: { label: 'Mood', values: { calm: 'Calm', loud: 'Loud' } } }setTextMeasurer if you need exact fits there.style: 'random' picks for a given seed.Open examples/contact-sheet.html?palettes=noir,mint&seeds=a,b on the dev server to see many covers at once (also styles, titles, subtitle, w, h, cols and texture=1).
The site is a Cloudflare Workers deployment configured in wrangler.jsonc: static assets, with security headers in public/_headers, and a Worker (worker/index.js) that answers /api/*, /mcp and a design's link (/?title=…). The dev server answers them the same way.
Contributions are welcome. See CONTRIBUTING.md, and report security issues as described in SECURITY.md. Questions, ideas and covers you've made go in Discussions.
Source: README.md at commit bd83a89
Create a book cover
Draw a book cover. Answers with the picture, links to the image (SVG and PNG) and to edit it in the app, and the style, palette and seed it used.
svgcasefontlangseedbadgegenrestyletitlerequiredauthorcolorscredit+6 moreCreate a mockup of a cover
Draw a cover as a product shot (a 3D book, flat, on an e-reader) or on a social card with a line of text. Answers with the picture and its links.
svgcasefontkindlangseedtextbadgegenrestyletitlerequiredauthor+8 moreList the cover styles
The styles, with their genres and the choices each lets you pin.
genreList the colour palettes
The palettes, light and dark, with their colours.
Takes no parameters.
100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
<img src="https://covers.otsirh.dev/api/cover.svg?title=Dune&author=Frank+Herbert&style=retro" alt="Dune" /><script type="module" src="https://covers.otsirh.dev/element.js"></script>
<book-cover cover-title="Dune" author="Frank Herbert" cover-style="retro" seed="1"></book-cover>claude mcp add book-covers -- npx -y book-cover-generator --mcp# or, with nothing installed, the hosted server:claude mcp add --transport http book-covers https://covers.otsirh.dev/mcp{ "mcpServers": { "book-covers": { "command": "npx", "args": ["-y", "book-cover-generator", "--mcp"] } }}<script type="module"> import { generateCover } from 'https://cdn.jsdelivr.net/npm/book-cover-generator@1/src/index.js';
document.body.innerHTML = generateCover({ title: 'The Lighthouse Keeper', author: 'Mara Ellison', style: 'artdeco', palette: 'midnight', });</script>npm install book-cover-generatorimport { createCover } from 'book-cover-generator';import { writeFileSync } from 'node:fs';
const { svg, style, palette, seed } = createCover({ title: 'Neon Tide', author: 'Kai Moreno', style: 'random', // or a style id, see `styles` seed: 42, // same seed, same cover width: 1600, height: 2560,});writeFileSync('cover.svg', svg);npx book-cover-generator "The Lighthouse Keeper" "Mara Ellison" --style artdeco -o cover.svgnpx book-cover-generator --list # all styles and palettes# your own colours (the # is optional), as an eBook 1600 px widenpx book-cover-generator "Bright Machines" --bg 0b132b --ink f8f9fa --accent ff6b6b,4ecdc4 --format ebook --width 1600 -o cover.svg# any size, and the choices as JSON (with the SVG, when there is no -o)npx book-cover-generator "Neon Tide" --size 1800x2700 --json# a cover for every book in a list (CSV with a header row, JSON lines, or "Title | Author" lines), one look for allnpx book-cover-generator --batch books.csv --style minimal --seed series --out-dir covers# twelve variations to choose from: ideas/cover-1.svg … ideas/cover-12.svg (seeds 1 to 12)npx book-cover-generator "Salt and Static" --count 12 -o ideas/cover.svg# a paperback's whole cover for print (back, spine and front), 6 × 9 in with 320 pages on cream papernpx book-cover-generator "The Lighthouse Keeper" "Mara Ellison" -s artdeco --print 6x9 --pages 320 --paper cream \ --hook "Some lights are kept burning." --blurb-file blurb.txt -o paperback.svgimport { createCover, createMockup } from 'book-cover-generator';
const cover = createCover({ title: 'Neon Tide', author: 'Kai Moreno' });const { svg, width, height } = createMockup(cover, { kind: 'book' }); // or 'flat', 'ereader'const card = createMockup(cover, { kind: 'card', text: 'Out now' }); // 1200 × 630; also 'square', 'story'import { createPrintCover } from 'book-cover-generator';import { svgToPdf, downloadBlob } from 'book-cover-generator/browser';
const print = createPrintCover( { title: 'The Lighthouse Keeper', author: 'Mara Ellison', style: 'artdeco' }, { trim: '6x9', pages: 320, paper: 'cream', hook: 'Some lights are kept burning.', blurb: 'When the lamp…' },);print.inches; // { width: 13.05, height: 9.25, trim: [6, 9], spine: 0.8, bleed: 0.125 }const pdf = await svgToPdf(print.svg, { bleed: print.inches.bleed, title: 'The Lighthouse Keeper' });downloadBlob(pdf, 'paperback.pdf'); // one page at 300 dpi, the file to upload to KDPimport { downloadCover, rasterize, copyText, copyImage, zipFiles } from 'book-cover-generator/browser';
await copyText(svg); // copy SVG markupawait copyImage(svg, { scale: 2 }); // copy a PNG (where canCopyImage() is true)await downloadCover(svg, 'svg', 'my-cover'); // my-cover.svgawait downloadCover(svg, 'png', 'my-cover', { scale: 3, dpi: 300 }); // 1800×2700 PNG that prints at 6 × 9 inawait downloadCover(svg, 'jpeg', 'my-cover', { width: 1600, quality: 0.9 }); // exactly 1600 px wideconst name = await downloadCover(svg, 'webp', 'my-cover'); // 'my-cover.png' where WebP can't be madeconst blob = await rasterize(svg, { type: 'image/webp', width: 1600, height: 2560 });const zip = await zipFiles([ { name: 'cover.png', data: blob }, { name: 'cover.svg', data: svg },]);generateCover({ title: 'Bright Machines', palette: { bg: '#0b132b', ink: '#f8f9fa', accents: ['#ff6b6b', '#4ecdc4', '#ffe66d'] },});import { registerStyle, titleBlock, authorFit, drawText, FONTS } from 'book-cover-generator';
registerStyle({ id: 'plain', name: 'Plain', group: 'Typographic', render(c) { const title = titleBlock(c, { font: FONTS.serif, maxWidth: c.W - c.m * 2, maxHeight: c.H * 0.5, maxSize: c.S * 0.2, }); const author = authorFit(c); return ( `<rect width="${c.W}" height="${c.H}" fill="${c.p.bg}"/>` + title.draw({ x: c.m, y: c.m, fill: c.p.ink }) + drawText(author, { x: c.m, y: c.H - c.m - author.height, fill: c.p.ink }) ); },});npm ci # install dev tooling (the library itself has no dependencies)npx playwright install # browsers for the end-to-end testsnpm run dev # http://127.0.0.1:4173src/ the library (plain ES modules + .d.ts types) styles/ the 39 styles, in a file per familybin/ the CLIsite/ the web app (index.html is at the root)public/ files served at the site root: headers, 404, icons, manifest, service workertest/ unit tests (node --test)test-d/ type tests (tsc)e2e/ browser tests (Playwright)scripts/ build, dev server and asset generationworker/ the HTTP API (the site's Worker)