{"id":17534,"library":"cli-real-favicon","title":"RealFaviconGenerator CLI","description":"cli-real-favicon is a Node.js command-line interface (CLI) tool designed to automate the process of generating multi-platform favicons using the RealFaviconGenerator web service. It allows developers to generate comprehensive icon sets (including web app manifests, iOS, Android, and Windows tile icons) based on a single source image and a detailed configuration file. The current stable version, 0.0.9, was released several years ago and the project appears to be unmaintained. This means it may not support the latest icon formats, browser requirements, or security best practices, and relies on an older version of the RealFaviconGenerator API. Its primary utility lies in programmatically generating favicon assets, but its age necessitates careful consideration for new projects. The tool's distinct feature is its ability to take a configuration exported from the RealFaviconGenerator website and apply it locally through a CLI.","status":"abandoned","version":"0.0.9","language":"javascript","source_language":"en","source_url":"https://github.com/RealFaviconGenerator/cli-real-favicon","tags":["javascript","favicon","cli","RealFaviconGenerator"],"install":[{"cmd":"npm install cli-real-favicon","lang":"bash","label":"npm"},{"cmd":"yarn add cli-real-favicon","lang":"bash","label":"yarn"},{"cmd":"pnpm add cli-real-favicon","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[],"quickstart":{"code":"// 1. Create a source image, e.g., `src/logo.png` (min. 260x260px).\n// 2. Go to RealFaviconGenerator.net, upload your image, and customize your favicons.\n// 3. On the result page, navigate to the 'Node CLI' tab and copy the generated configuration JSON.\n// Save this JSON to a file in your project, e.g., `favicon-config.json`.\n// (Example content below, your actual content will vary based on your choices):\n{\n \"design\": {\n \"ios\": {\n \"pictureAspect\": \"backgroundAndMargin\",\n \"backgroundColor\": \"#ffffff\",\n \"margin\": \"14%\"\n },\n \"androidChrome\": {\n \"pictureAspect\": \"noBackground\",\n \"themeColor\": \"#ffffff\"\n },\n \"safariPinnedTab\": {\n \"pictureAspect\": \"silhouette\",\n \"themeColor\": \"#5bbad5\"\n },\n \"windows\": {\n \"pictureAspect\": \"noBackground\",\n \"backgroundColor\": \"#da532c\"\n }\n },\n \"settings\": {\n \"compression\": \"false\",\n \"scalingAlgorithm\": \"Lanczos\",\n \"errorOnImageTooSmall\": false,\n \"readmeFile\": false,\n \"htmlCodeFile\": false,\n \"previewFile\": false,\n \"markupFile\": false,\n \"versioning\": \"false\",\n \"manifest\": {\n \"name\": \"My Awesome App\",\n \"display\": \"standalone\",\n \"orientation\": \"any\",\n \"startUrl\": \"/\",\n \"backgroundColor\": \"#ffffff\",\n \"themeColor\": \"#ffffff\"\n }\n },\n \"version\": \"0.16\"\n}\n\n// 4. Install the CLI tool globally:\nnpm install -g cli-real-favicon\n\n// 5. Run the favicon generation command. \n// The paths for config, source image, and output directory are crucial.\nmkdir -p public/favicons\ncli-real-favicon generate favicon-config.json src/logo.png public/favicons\n\nconsole.log('Favicons generated in public/favicons!');\n// You will then integrate the generated HTML markup into your project's .\n","lang":"javascript","description":"This quickstart guides you through generating a comprehensive set of favicons using `cli-real-favicon`, leveraging a configuration obtained from the RealFaviconGenerator website."},"warnings":[{"fix":"For new projects, consider actively maintained alternatives or use the RealFaviconGenerator website directly. If using this CLI, run in a controlled environment and audit dependencies for security risks. Modern Node.js versions might require polyfills or specific execution flags for older CJS modules.","message":"The package (v0.0.9) has not been updated since 2017. It may rely on outdated dependencies with known security vulnerabilities (CVEs) and might not function correctly with modern Node.js versions (e.g., Node.js 16+ or ESM-only environments) or current RealFaviconGenerator API changes.","severity":"breaking","affected_versions":">=0.0.9"},{"fix":"Always test the output thoroughly after generation. If generation fails or outputs are incorrect, first check the RealFaviconGenerator website for service status or API change announcements.","message":"The CLI's core functionality is entirely dependent on the external RealFaviconGenerator.net API. Any breaking changes, deprecations, or outages on the web service's side will directly impact the CLI's ability to generate favicons, without any possibility of a fix from this unmaintained package.","severity":"gotcha","affected_versions":">=0.0.9"},{"fix":"Ensure `favicon-config.json` is a valid JSON. Verify that `src/logo.png` (or your chosen source image) exists and is accessible. Confirm that `public/favicons` (or your chosen output directory) is created and writable before running the command.","message":"The configuration JSON, source image path, and output destination path are critical. Incorrect paths or an invalid configuration JSON (e.g., missing required fields) will lead to generation failures without clear error messages from the CLI.","severity":"gotcha","affected_versions":">=0.0.9"}],"env_vars":null,"last_verified":"2026-04-23T00:00:00.000Z","next_check":"2026-07-22T00:00:00.000Z","problems":[{"fix":"Check the CLI output for any preceding warnings. Ensure the source image is valid and accessible. Verify network connectivity. Confirm the output directory exists and has write permissions. Review the `favicon-config.json` for any errors.","cause":"A generic error indicating a failure during the favicon generation process. This often stems from issues with the source image, network connectivity to RealFaviconGenerator.net, or problems writing to the output directory.","error":"Error: Command failed with exit code 1"},{"fix":"If you intend to use it globally, run `npm install -g cli-real-favicon`. If installed locally in a project, execute it using `npx cli-real-favicon` or by referencing the binary directly: `node_modules/.bin/cli-real-favicon`.","cause":"The `cli-real-favicon` executable is not available in your system's PATH. This typically happens if the package was not installed globally or if the global `node_modules` bin directory isn't in your PATH.","error":"cli-real-favicon: command not found"},{"fix":"Ensure the `favicon-config.json` file is present in the directory from which you are running the command, or provide the correct relative or absolute path to its location.","cause":"The CLI cannot find the specified configuration file at the provided path. This indicates a file path error.","error":"Error: ENONT: no such file or directory, open 'favicon-config.json'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}