https://github.com/socialviolation/asciiban
asciiban generates ASCII banners for given prompts
https://github.com/socialviolation/asciiban
ascii ascii-art cli colors golang just-for-fun package terminal
Last synced: 6 months ago
JSON representation
asciiban generates ASCII banners for given prompts
- Host: GitHub
- URL: https://github.com/socialviolation/asciiban
- Owner: socialviolation
- License: gpl-3.0
- Created: 2023-04-04T09:34:04.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-09-16T10:34:47.000Z (almost 2 years ago)
- Last Synced: 2025-08-09T21:39:39.709Z (11 months ago)
- Topics: ascii, ascii-art, cli, colors, golang, just-for-fun, package, terminal
- Language: Go
- Homepage:
- Size: 4.12 MB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING.txt
Awesome Lists containing this project
README
```text
█████╗ ███████╗ ██████╗██╗██╗██████╗ █████╗ ███╗ ██╗
██╔══██╗██╔════╝██╔════╝██║██║██╔══██╗██╔══██╗████╗ ██║
███████║███████╗██║ ██║██║██████╔╝███████║██╔██╗ ██║
██╔══██║╚════██║██║ ██║██║██╔══██╗██╔══██║██║╚██╗██║
██║ ██║███████║╚██████╗██║██║██████╔╝██║ ██║██║ ╚████║
╚═╝ ╚═╝╚══════╝ ╚═════╝╚═╝╚═╝╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═══╝
```
asciiban is a go package or CLI tool that generates ASCII art banners for a given prompt. It is
a fun and creative way to make your command-line prompts stand out.
# SDK
# Installation
To Install, run the following tool.
`go get -u github.com/socialviolation/asciiban@main`
## Usage
It can then be used in your code using the following example:
```go
package main
import (
"github.com/socialviolation/asciiban/ascii"
)
func main() {
ascii.Print(ascii.Args{
Message: "What is real?",
Palette: ascii.PaletteMintGreen,
Font: ascii.FontGeorgia11,
})
}
```
# CLI
## Installation
You can install the asciiban cli by running the following command:
```bash
go install github.com/socialviolation/asciiban@main
```
This will install the tool in your `$GOBIN` directory.
## Usage
To use asciiban cli, simply run the following command:
```bash
asciiban "Your text here"
```
This will generate an ASCII art banner for the text you entered. More information can be found by running `asciiban --help`
```text
Available Commands:
completion Generate the autocompletion script for the specified shell
fonts Subcommands show info for available fonts
help Help about any command
palettes Subcommands show info for available palettes
random Generate ascii banner using random font & colours
Flags:
-f, --font string Colour palette to use (default "ansishadow")
-h, --help help for asciiban
-m, --mode string Palette Colour Mode (simple | alternating | vertical | horizontal)
-p, --palette string Colour palette to use (default "default")
```
* For example, to generate an ASCII art banner using the big font and green color, run the following command:
```bash
asciiban -f georgia11 -p matrix "What is real?"
```
## Examples
## Contributing
If you find any bugs or have suggestions for improvements, please feel free to open an issue or submit a pull request on
the GitHub repository: https://github.com/socialviolation/asciiban
## License
This tool is released under the GPL-3.0 License. See the LICENSE file for details.