gitwtfhub

wtf is typed-scores?

geronimocastano/typed-scores — explained in plain English

Analysis updated 2026-05-18

6TypstAudience · writerComplexity · 3/5Setup · moderate

TL;DR

A Typst package for writing western music notation directly in text documents. Type short note strings and it renders proper engraved sheet music, no separate music editor needed.

Mindmap

mindmap
  root((typed-scores))
    What it does
      Music notation in Typst
      Type notes as text
      Renders sheet music
    Tech stack
      Typst package
      Rust plugin
      WebAssembly
      CeTZ drawing
    Entry points
      Bar for quick snippets
      Score for full pieces
    Music features
      Chords and rests
      Ties and beams
      Grace notes and tremolos
    Formatting
      Multi-staff layout
      Auto line breaking
      Chord symbols above staff
    Audience
      Musicians using Typst
      Sheet music creators

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Write short single-measure music snippets inside a Typst document using the bar helper.

REASON 2

Create full multi-staff sheet music with repeat barlines, volta brackets, and rehearsal marks using the score function.

REASON 3

Build lead sheets with chord symbols above the staff for harmony notation.

REASON 4

Type out chords, rests, ties, beams, tuplets, and grace notes using compact text shorthand.

What's in the stack?

TypstRustWebAssemblyCeTZBravura font

How it stacks up

geronimocastano/typed-scoresauser/resumemoritzheiber/briefvorlage
Stars6
LanguageTypstTypstTypst
Last pushed2026-05-262026-06-24
MaintenanceMaintainedActive
Setup difficultymoderatemoderatemoderate
Complexity3/52/52/5
Audiencewriterpm founderpm founder

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Typst installed and the Rust/WebAssembly plugin, users need to learn the compact note-event text syntax.

The license for this package is not specified in the provided explanation.

Wtf does this do

Typed-scores is a package for Typst, a document typesetting system, that lets you write western music notation directly in your documents. Instead of using a separate graphical music editor and pasting images, you type short text strings that describe notes, rests, chords, and other musical symbols. The package then renders them as proper engraved sheet music. It relies on a Rust and WebAssembly plugin to parse the input, uses CeTZ for drawing, and ships with Bravura font glyphs for the actual music symbols. The package offers two main entry points. A helper called bar is meant for quick, single-measure snippets on one staff, accepting just notes, clef, key, and time. For anything more complete, the score function handles multi-staff pieces, multiple systems, clef changes, repeat barlines, volta brackets, rehearsal marks, and navigation symbols like segno and coda. You declare staff identities once, then supply note data per bar for each staff. Notes are written in a compact event language. A string like c4:q d e f means a C4 quarter note followed by three more quarter notes that inherit the same octave and duration. You can write chords, rests, ties, beams, tuplets, grace notes, tremolos, and arpeggios all through text shorthand. Durations use single letters: w for whole, h for half, q for quarter, e for eighth, and so on, with dots appended for dotted rhythms. The package also supports chord symbols above the staff for lead-sheet style harmony, and it handles layout decisions automatically. Multi-system scores justify their spacing to fill a given width, and the line breaker aims for balanced density rather than a fixed number of bars per line. You can control indentation, ragged-right behavior, bar numbering, and other formatting details through function arguments. The full README is longer than what was shown.

Yoink these prompts

Prompt 1
Help me write a Typst document using typed-scores that shows a simple C major scale across one measure on a treble clef staff using the bar function.
Prompt 2
I want to create a two-staff piano score in Typst with typed-scores that includes a repeat barline and a volta bracket for first and second endings. Show me how to structure the score function call.
Prompt 3
Write a typed-scores bar string in Typst for a melody that starts with a C4 quarter note, then three more quarter notes that inherit the same octave, followed by a half rest.
Prompt 4
Show me how to add chord symbols above a staff in typed-scores so I can make a lead sheet with a treble clef melody and G7, Cmaj7 chord labels above the bars.

Frequently asked questions

wtf is typed-scores?

A Typst package for writing western music notation directly in text documents. Type short note strings and it renders proper engraved sheet music, no separate music editor needed.

What language is typed-scores written in?

Mainly Typst. The stack also includes Typst, Rust, WebAssembly.

What license does typed-scores use?

The license for this package is not specified in the provided explanation.

How hard is typed-scores to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is typed-scores for?

Mainly writer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.