oh-my-logo: Create Stunning ASCII Art Logos with Gradients in Your Terminal
Summary
oh-my-logo is a powerful and zero-dependency CLI tool and library for generating beautiful ASCII art logos with vibrant gradient colors directly in your terminal. It offers various rendering modes, a wide selection of palettes, and extensive customization options to transform plain text into eye-catching visual banners. Perfect for enhancing project READMEs, CI/CD logs, or personalizing your terminal experience.
Repository Info
Tags
Click on any tag to explore related repositories
Introduction
oh-my-logo is an impressive command-line interface (CLI) tool and TypeScript library designed to bring colorful, gradient-filled ASCII art logos to your terminal. Inspired by tools like Claude Code or Gemini CLI, it allows you to easily generate striking visual banners for your projects, scripts, or personal use. With zero dependencies, oh-my-logo is incredibly fast and simple to use, offering both outlined ASCII art and filled block character modes.
Key features include 13 beautiful built-in palettes, various gradient directions, multi-line text support, customizable fonts, and unique shadow styles for filled characters. Whether you need a quick, stylish header for a README or a dynamic logo for a terminal application, oh-my-logo provides a flexible and fun solution.
Installation
oh-my-logo offers multiple ways to get started, from no-installation quick starts to global CLI installation and library integration.
Quick Start with npx
No installation is needed to try it out instantly:
npx oh-my-logo "HELLO WORLD"
For filled characters, add the --filled flag:
npx oh-my-logo "YOUR LOGO" sunset --filled
Global Installation (CLI)
To use oh-my-logo as a global command:
npm install -g oh-my-logo
As a Library
Integrate oh-my-logo into your Node.js or TypeScript projects:
npm install oh-my-logo
Examples
Explore some of the ways you can use oh-my-logo to create stunning terminal art.
Basic Usage
# Simple logo with default blue gradient
npx oh-my-logo "STARTUP"
# Multi-line company logo with a sunset palette
npx oh-my-logo "MY\nCOMPANY" sunset
# Matrix-style hacker text with filled characters
npx oh-my-logo "HACK THE PLANET" matrix --filled
Different Rendering Modes
Choose between classic outlined ASCII or modern filled blocks.
# Outlined ASCII art (default)
npx oh-my-logo "CODE" fire
# Filled block characters
npx oh-my-logo "CODE" fire --filled
# Filled with different shadow styles
npx oh-my-logo "CODE" fire --filled --block-font chrome # Minimal box shadows
npx oh-my-logo "CODE" fire --filled --block-font shade # Dotted shadow effect
Custom Color Palettes
Define your own gradients using hex codes.
# JSON array (double quotes recommended)
npx oh-my-logo "MY LOGO" --palette-colors '["#00ff00","#ffa500","#ff0000"]'
# Simple comma-separated notation
npx oh-my-logo "MY LOGO" --palette-colors "'#00ff00', '#ffa500', '#ff0000'"
Reverse Gradient Effect
Flip any color palette for unique visual effects.
# Normal sunset gradient (red ? orange)
npx oh-my-logo "GRADIENT" sunset
# Reversed sunset gradient (orange ? red)
npx oh-my-logo "GRADIENT" sunset --reverse-gradient
Why Use oh-my-logo?
oh-my-logo is more than just a fun tool, it offers practical applications for developers and terminal enthusiasts alike:
- Project Banners: Add eye-catching headers to your README files on GitHub or GitLab.
- Terminal Startup: Display your company logo or a personalized message when opening terminals.
- CI/CD Pipelines: Make deployment logs more visually appealing and easier to parse with branded messages.
- Development Tools: Brand your custom CLI applications with unique, colorful logos.
- Presentations: Create stunning terminal demos that capture attention.
- Personal Branding: Add flair to your shell prompt or scripts, making your terminal truly yours.
Links
Explore the oh-my-logo project further on GitHub:
- GitHub Repository: https://github.com/shinshin86/oh-my-logo