Typscord

Typesetting for @everyone.

Typscord is a Discord bot that renders Typst code.

Important

External third-party packages and fonts are currently unsupported.

Development Setup

Typscord is written in Rust using the Axum web framework for the Tokio runtime. Compiling and rendering is powered by the official Typst library bindings.

Loading Environment Variables

Important

Some environment variables are required only for scripts/automation while others are required at runtime.

# For Nushell
open .env | from toml | load-env

Name	Description	Scripts?	Server?
DISCORD_APPLICATION_ID	Used for programmatically registering the slash commands via the Discord API.	✅	❌
DISCORD_BOT_TOKEN	Used for sending HTTP requests to the Discord API for interaction followup messages.	✅	✅
DISCORD_PUBLIC_KEY	Used to verify whether incoming Discord interactions are actually from Discord.	❌	✅
TYPSCORD_COMPILATION_TIMEOUT	The maximum number of milliseconds to wait for a Typst compilation to finish.	❌	✅
PORT	The TCP port to which the network socket will bind.	❌	✅

Registering the Slash Commands

The discord.json contains all of the application command configurations of the bot's supported commands.

# To register the slash command...
curl --request 'PUT' --header 'Content-Type: application/json' --header "Authorization: Bot $DISCORD_BOT_TOKEN" --data '@discord.json' "https://discord.com/api/v10/applications/$DISCORD_APPLICATION_ID/commands"

Note

See the Nushell script register.nu for convenience.

Running the Server

# Make sure all the environment variables are properly set!
cargo run --release

Legal

The Typscord project is licensed under the GNU Affero General Public License v3.0. However, some files (e.g., brand assets) are exceptions that have been licensed under different terms and limitations. See the COPYING.md file for more details.

Special Thanks

• Angelica Raborar for designing the original logo and mascot for Typscord: "Typo the Blue Crab".
• mattfbacon/typst-bot for being an invaluable resource/example of invoking Typst as a library within a Discord bot. Many abstractions in Typscord were inspired by the prior art.