Get the icon of a file or app as a PNG image (macOS)
npm install file-icon> Get the icon of a file or app as a PNG image
Requires macOS 10.10 or later. macOS 10.13 or earlier needs to download the Swift runtime support libraries.
``sh`
npm install file-icon
`js
import fs from 'node:fs';
import {fileIconToBuffer, fileIconToFile} from 'file-icon';
// An app name can be used
const buffer = await fileIconToBuffer('Safari');
fs.writeFileSync('safari-icon.png', buffer);
// An array of app names
const apps = ['Finder', 'Safari'];
const buffers = await fileIconToBuffer(apps);
buffers.map((buffer, index) => fs.writeFileSync(${apps[index]}-icon.png, buffer));
// Or a bundle ID
const buffer2 = await fileIconToBuffer('com.apple.Safari', {size: 64});
fs.writeFileSync('safari-icon.png', buffer2);
// Or an array of bundle IDs
const bundleIds = ['com.apple.Finder', 'com.apple.Safari'];
const buffers2 = await fileIconToBuffer(bundleIds);
buffers2.map((buffer, index) => fs.writeFileSync(${bundleIds[index]}-icon.png, buffer));
// Or a process ID
const buffer3 = await fileIconToBuffer(257);
fs.writeFileSync('pid.png', buffer3);
// Or an array of process IDs
const pids = [257, 16];
const buffers3 = await fileIconToBuffer(pids, {size: 128});
buffers3.map((buffer, index) => fs.writeFileSync(${pids[index]}-icon.png, buffer));
// Or a path to an app / file
const buffer4 = await fileIconToBuffer('/Applications/Safari.app');
fs.writeFileSync('safari-icon.png', buffer4);
// Or an array of file paths
const paths = ['/Applications/Safari.app', '/Applications/Calculator.app'];
const buffers4 = await fileIconToBuffer(paths);
buffers4.map((buffer, index) => fs.writeFileSync(app-${index}-icon.png, buffer));
// Or a mix of all of them!
const mixedBuffers = await fileIconToBuffer(['Finder', 257, 'com.apple.Calculator', '/Applications/Safari.app']);
// You can also use fileIconToFile and provide options.destination with the path to write to
await fileIconToFile('Safari', {destination: 'safari-icon.png'});
// You can also use same length arrays for input and options.destination
await fileIconToFile(['Safari', 'Finder'], {destination: ['safari-icon.png', 'finder-icon.png']});
console.log('Done');
`
Returns a Promise for a PNG image if input is of type string or number.
Returns a Promise for multiple PNG images if input is of type Array.
Type: string | number | Array
Either:
- App name (string)
- App bundle identifier (string)
- App process ID (number)
- Path to an app (string)
- Path to a file (string)
Type: object
#### size
Type: number\1024
Default: \1024
Maximum:
Size of the returned icon.
Returns a Promise that resolves when the files are written to options.destination.
Type: string | number | Array
Type: object
#### size
Type: number\1024
Default: \1024
Maximum:
Size of the returned icon.
#### destination
Required\
Type: string | string[]
Output file for the icon. If input is a single value, options.destination must be of type string. If input is an Array, options.destination must be of type string[] with the same length as input`.
- file-icon-cli - CLI for this module
- app-path - Get the path to an app