PHPackages jeffersongoncalves/banners-cli - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [CLI & Console](/categories/cli) 4. / 5. jeffersongoncalves/banners-cli ActiveProject[CLI & Console](/categories/cli) jeffersongoncalves/banners-cli ============================== CLI tool to generate banner images using beyondcode/banners service. Built with Laravel Zero. v1.2.0(1mo ago)13↓75%MITPHPPHP ^8.2CI passing Since Feb 24Pushed 1mo agoCompare [ Source](https://github.com/jeffersongoncalves/banners-cli)[ Packagist](https://packagist.org/packages/jeffersongoncalves/banners-cli)[ Docs](https://github.com/jeffersongoncalves/banners-cli)[ RSS](/packages/jeffersongoncalves-banners-cli/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (6)Dependencies (15)Versions (7)Used By (0) [![Banners CLI](https://raw.githubusercontent.com/jeffersongoncalves/banners-cli/main/art/jeffersongoncalves-banners-cli.png)](https://raw.githubusercontent.com/jeffersongoncalves/banners-cli/main/art/jeffersongoncalves-banners-cli.png) Banners CLI =========== [](#banners-cli) [![Tests](https://github.com/jeffersongoncalves/banners-cli/actions/workflows/run-tests.yml/badge.svg)](https://github.com/jeffersongoncalves/banners-cli/actions/workflows/run-tests.yml) [![Build](https://github.com/jeffersongoncalves/banners-cli/actions/workflows/build.yml/badge.svg)](https://github.com/jeffersongoncalves/banners-cli/actions/workflows/build.yml) [![Latest Release](https://camo.githubusercontent.com/c7396c5cea2d5d3d3799539adabaf18151fb0ac88af17fd31b32a35aad14b22b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6a6566666572736f6e676f6e63616c7665732f62616e6e6572732d636c69)](https://github.com/jeffersongoncalves/banners-cli/releases/latest) [![PHP 8.2+](https://camo.githubusercontent.com/8f0af9c5395ae4ef8ba7a7ad65fa61c44927ea9c3eb3be91a13c678254f29bd4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e322d383839324246)](https://camo.githubusercontent.com/8f0af9c5395ae4ef8ba7a7ad65fa61c44927ea9c3eb3be91a13c678254f29bd4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e322d383839324246) [![License](https://camo.githubusercontent.com/d738aeaf1132c156be855c8af9a9380304e6f7742fdc0c5c3c8033797a74e56b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6a6566666572736f6e676f6e63616c7665732f62616e6e6572732d636c69)](LICENSE) CLI tool to generate banner images using the [beyondcode/banners](https://banners.beyondco.de/) service. Configure default parameters and generate banners with a single command. Requirements ------------ [](#requirements) - PHP >= 8.2 Installation ------------ [](#installation) ### Download PHAR (recommended) [](#download-phar-recommended) Download the latest `banners.phar` from the [Releases](https://github.com/jeffersongoncalves/banners-cli/releases) page: ``` # Download and make executable curl -sL https://github.com/jeffersongoncalves/banners-cli/releases/latest/download/banners.phar -o banners chmod +x banners sudo mv banners /usr/local/bin/banners ``` ### Via Composer (global) [](#via-composer-global) ``` composer global require jeffersongoncalves/banners-cli ``` Usage ----- [](#usage) ### Generate a banner [](#generate-a-banner) ``` banners banner:generate "My Project" ./banner.png ``` ### With options [](#with-options) ``` banners banner:generate "My Project" ./banner.png \ --theme=dark \ --style=style_2 \ --pattern=texture \ --fontSize=72px \ --packageManager="composer require" \ --packageName="vendor/package" \ --description="A great PHP package" \ --md \ --showWatermark \ --fileType=png ``` ### Available options [](#available-options) OptionValuesDefault`--theme``light`, `dark``light``--style``style_1`, `style_2``style_1``--pattern`90+ hero-patterns (e.g. `texture`, `topography`, `circuitBoard`)`circuitBoard``--fontSize`CSS size (e.g. `96px`, `72px`)`96px``--packageManager`Any text*(empty)*`--packageName`Any text*(empty)*`--description`Any text*(empty)*`--md`Flag (enable markdown)`false``--showWatermark`Flag`false``--images`Image URL or heroicon name*(empty)*`--fileType``png`, `jpeg``png`Configuration ------------- [](#configuration) Save default values so you don't have to pass them every time. ### Interactive wizard [](#interactive-wizard) ``` banners config:init ``` The wizard configures: theme, style, pattern, fontSize, markdown rendering, watermark, and file type. ### Set individual values [](#set-individual-values) ``` banners config:set theme dark banners config:set pattern texture banners config:set fontSize 72px banners config:set md true banners config:set showWatermark true ``` ### View current config [](#view-current-config) ``` banners config:show ``` Configuration is stored in `~/.banners-cli/config.json`. Command-line options always override config values. Development ----------- [](#development) ``` # Clone git clone git@github.com:jeffersongoncalves/banners-cli.git cd banners-cli # Install dependencies composer install # Run tests composer test # Run code formatting composer lint # Build PHAR composer build ``` License ------- [](#license) Banners CLI is open-source software licensed under the [MIT license](LICENSE). ### Health Score 40 — FairBetter than 88% of packages Maintenance90 Actively maintained with recent releases Popularity5 Limited adoption so far Community6 Small or concentrated contributor base Maturity51 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~6 days Total 6 Last Release 50d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/411493?v=4)[Jefferson Gonçalves](/maintainers/jeffersongoncalves)[@jeffersongoncalves](https://github.com/jeffersongoncalves) --- Top Contributors [![jeffersongoncalves](https://avatars.githubusercontent.com/u/411493?v=4)](https://github.com/jeffersongoncalves "jeffersongoncalves (38 commits)") --- Tags bannerbeyondcodeclicomposerimage-generatorlaravel-zeropharphpphpcomposerclipharlaravel-zerobeyondcodebannerimage-generator ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/jeffersongoncalves-banners-cli/health.svg) ``` [![Health](https://phpackages.com/badges/jeffersongoncalves-banners-cli/health.svg)](https://phpackages.com/packages/jeffersongoncalves-banners-cli) ``` ### Alternatives [nunomaduro/collision Cli error handling for console/command-line PHP applications. 4.6k331.8M8.5k](/packages/nunomaduro-collision)[nunomaduro/laravel-console-menu Laravel Console Menu is an output method for your Laravel/Laravel Zero commands. 815412.0k48](/packages/nunomaduro-laravel-console-menu)[nunomaduro/laravel-console-task Laravel Console Task is a output method for your Laravel/Laravel Zero commands. 2582.1M11](/packages/nunomaduro-laravel-console-task)[nunomaduro/laravel-console-summary A Beautiful Laravel Console Summary for your Laravel/Laravel Zero commands. 662.0M3](/packages/nunomaduro-laravel-console-summary)[nunomaduro/laravel-console-dusk Laravel Console Dusk allows the usage of Laravel Dusk in Laravel/Laravel Zero artisan commands. 16255.4k7](/packages/nunomaduro-laravel-console-dusk)[mehrancodes/laravel-harbor A CLI tool to Quickly create On-Demand preview environment for your apps. 9989.0k](/packages/mehrancodes-laravel-harbor) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)