Skip to content
/ acb Public

Adobe Photoshop Color Book (ACB) encoder and decoder

Notifications You must be signed in to change notification settings

atesgoral/acb

Repository files navigation

acb

npm (scoped) CI TypeScript

Adobe Photoshop Color Book (ACB) encoder and decoder.

What

Adobe Photoshop's color picker allows you to pick colors from standard color libraries. These libraries reside as .acb files inside Photoshop's installation directory (e.g. /Applications/Adobe Photoshop/Presets/Color Books on macOS). This library allows you to decode and encode .acb files. You can extract color data from Photoshop's color books, as well as creating your own custom color books you can use them yourself or distribute them.

image

Install

npm install @atesgoral/acb
# Or:
yarn add @atesgoral/acb

Book structure

The output from the decoder and the expected input into the decoder looks something like this:

const book = {
  id: 42,
  title: 'Primary colors',
  description: 'Primary light colors, as perceived by humans.',
  colorNamePrefix: '',
  colorNamePostfix: '',
  pageSize: 3,
  pageKey: 1,
  colorModel: 'RGB',
  colors: [
    {name: 'Red', code: 'RED   ', components: [255, 0, 0]},
    {name: 'Green', code: 'GREEN ', components: [0, 255, 0]},
    {name: 'Blue', code: 'BLUE  ', components: [0, 0, 255]},
  ],
};

If you're using TypeScript, there is a ColorBook interface that is exported by the library:

import type {ColorBook} from '@atesgoral/acb';

const book: ColorBook = {
  // ...
};

All properties are mandatory:

field description
id The unique color book identifier. You must ensure that
this does not conflict with an existing color book that
exists in Photoshop's color book folder. Stock Photoshop
color books seem to start at id 3000.
title The color book title. Photoshop seems to show the
filename instead of this.
description The color book description. Photoshop doesn't show this
anywhere. Use '^R' for the registered trademark symbol
(®) and '^C' for the copyright symbol (©).
colorNamePrefix The prefix to prepend to every color name.
colorNamePostfix The suffix to append to every color name.
pageSize The number of colors to show on every color page in the
library color picker. The maximum that Photoshop allows
is 9.
pageKey Which color (by index) on a page to use as the color page
key. For example, with 9 colors per page, 5 would be the
middle of the page color.
colorModel The color model of the color book. Valid values are:
* 'RGB'
* 'CMYK'
* 'Lab'
(import type {ColorModel} from '@atesgoral/acb';)
colors And array of color records.

Each color record (import type {Color} from '@atesgoral/acb';) consists of the following mandatory properties:

field description
name The color name.
code A 6-character unique code for the color.
components An array of component values. For RGB, it's 3 values 0..255.
For CMYK it's 4 values 0..100. For Lab the L component is
0..100 while a and b are -128..127. (All ranges are inclusive.)

Decoding examples

Decoding from the standard input stream

import {AcbStreamDecoder} from '@atesgoral/acb';

const decoder = new AcbStreamDecoder();

decoder.on('book', (book) => {
  console.log(JSON.stringify(book, null, 2));
});

decoder.on('error', (error) => console.error(error));

process.stdin.pipe(decoder).pipe(process.stdout);

Decoding from a buffer

import {Readable} from 'stream';

import {AcbStreamDecoder} from '@atesgoral/acb';

const decoder = new AcbStreamDecoder();

decoder.on('book', (book) => {
  console.log(JSON.stringify(book, null, 2));
});

decoder.on('error', (error) => console.error(error));

const buffer = fs.readFileSync('./book.acb');

Readable.from(buffer).pipe(decoder).pipe(process.stdout);

Encoding examples

encodeAcb is a generator that yields Buffer chunks.

Encoding to the standard output stream

import {Readable} from 'stream';

import {encodeAcb} from '@atesgoral/acb';

const book = {
  // ...
};

const readable = Readable.from(encodeAcb(book));
readable.pipe(process.stdout);

Encoding into a single Buffer

import {encodeAcb} from '@atesgoral/acb';

const book = {
  // ...
};

const buffer = Buffer.concat([...encodeAcb(book)]);

Background

I reverse-engineered the ACB format back in 2003 before Adobe had it published publicly. I've been creating custom color books on the side for artists, printers and ink manifacturers. I've finally gotten around to publicly publishing a library that everyone can use.

About

Adobe Photoshop Color Book (ACB) encoder and decoder

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published