jtpotato / leucas

macOS CLI tool to create beluga-like Discord sketches.

leucas

A CLI that uses Discord's webhooks to post as a bot account, in order to simulate these Discord sketches.

You could probably set up a uBlock Origin rule to hide the "BOT" symbol, or you could just live with it.

The name comes from Delphinapterus leucas, the beluga whale.

Because... beluga

Built in Swift. Because I need to learn how to code without GitHub Copilot.

Installation

macOS ONLY (i think. linux users feel free to try out but i'm sorry if it doesn't work)

Download the binary from the Releases tab, and put it into a folder that's on your $PATH.

/usr/local/bin is pretty popular.

Verify it's installed by running leucas --version

If you wish, generate completions with leucas --generate-completion-script, and follow your shell's installation procedures for completions.

Usage

1. Make a JSON file. Example:

   Structure is as follows.

   {
     "characters": Character[],
     "messages": Message[]
   }

   Character

   {
     "api": string, // Discord webhook link
     "name": string,
     "profile": string? // optional, url to profile picture
   }

   Messages

   {
     "sender": int, // Index of the character in `characters`
     "message": string
   }

2. leucas --file path/to/script.json

   Messages are sent every second.