91 lines
2.6 KiB
Markdown
91 lines
2.6 KiB
Markdown
<div align=center>
|
|
|
|
<img width="500px" src="https://github.com/user-attachments/assets/f8f42b9f-43c9-4c0b-914c-fc2bce5a438d" />
|
|
|
|
|
|
# MikuSays 🎤
|
|
|
|
A `cowsay` clone with Hatsune Miku ASCII art and speech bubbles.
|
|
|
|
**NOW WITH**
|
|
<img height=24 src="https://cdn.xserv.pp.ua/files/css/COLORS.svg" alt="COLORS">
|
|
|
|
|
|
[](https://github.com/xxanqw/mikusays/releases/latest)
|
|
[](https://aur.archlinux.org/packages/mikusays)
|
|
|
|
</div>
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
Usage: mikusays [OPTIONS] [TEXT]
|
|
|
|
Arguments:
|
|
[TEXT] Text to display in the speech bubble
|
|
|
|
Options:
|
|
-s, --style <STYLE> Style of the Miku art. A random one is chosen if not specified
|
|
-l, --list List all available art styles with their indices
|
|
--rainbow Apply a smooth rainbow gradient across the ASCII art
|
|
--saturation <SATURATION> Saturation level for rainbow gradient (0-100) [default: 100]
|
|
--brightness <BRIGHTNESS> Brightness level for rainbow gradient (0-100) [default: 50]
|
|
--color <COLOR> Override with a single solid color
|
|
--gradient <START:END> Define a custom two-color gradient (e.g., --gradient red:blue)
|
|
--no-color Disable all coloring (respects NO_COLOR environment variable)
|
|
-h, --help Print help
|
|
-V, --version Print version
|
|
```
|
|
|
|
## Installation
|
|
|
|
### Arch Linux
|
|
```bash
|
|
yay -S mikusays
|
|
paru -S mikusays
|
|
```
|
|
|
|
### Debian / Ubuntu / Fedora / RHEL / CentOS
|
|
The repository and instructions available here: https://apt.xxanqw.pp.ua
|
|
|
|
### macOS (or Linux if using Homebrew)
|
|
```bash
|
|
brew tap xxanqw/mikusays
|
|
brew install mikusays
|
|
```
|
|
|
|
### Windows
|
|
- **Using Scoop**:
|
|
|
|
```bash
|
|
scoop bucket add extras
|
|
scoop bucket add xxanqw-bucket https://github.com/xxanqw/scoop-bucket
|
|
scoop update
|
|
scoop install mikusays
|
|
```
|
|
- **Using Installer**:
|
|
|
|
Download `mikusays-windows-inst-any-x.x.x.exe` from [Latest release page](https://github.com/xxanqw/mikusays/releases/latest)
|
|
|
|
---
|
|
|
|
### Download from [Releases](https://github.com/xxanqw/mikusays/releases):
|
|
|
|
- **Windows**: `mikusays-windows-*.exe`
|
|
- Small note for Windows that application depends on `vcredist2022`
|
|
(installing with scoop and installer resolve this dependency automatically)
|
|
- **Linux**: `mikusays-linux-*`
|
|
- **macOS**: `mikusays-macos-*`
|
|
|
|
Or build from source:
|
|
```bash
|
|
cargo build --release
|
|
```
|
|
|
|
## Development
|
|
|
|
```bash
|
|
cargo build
|
|
cargo run -- "message"
|
|
```
|