PipeScore

A bagpipe notation app

PipeScore is a free, easy-to-use, online bagpipe notation application. Use it here!

PipeScore's unique feature is reactive gracenotes - pipe embellishments that automatically update when you change the note that they are on. This means gracenotes can be added in sets (e.g. 'add a doubling to this note') rather than the user having to individually pick the correct one.

Watch the video for an introduction to using PipeScore.

PipeScore is powered by:

typescript
mithril for rendering
firebase for saving, user accounts, and hosting, via the following libraries:
- firebase-auth-lite
- firebase-firestore-lite
esbuild for building
biome for linting
prettier for code formatting

Features

Reactive embellishments - a faster way to input gracenotes
Automatic note grouping and spacing
Sharing using URLs
Playback
Ties, triplets, time signatures, text boxes
Parts, repeats, second timings
Harmonies
Multiple tunes and pages
Undo / Redo
Importing/exporting from the Bagpipe Music Writer format
Exporting to PDF
Cloud saving, downloading and uploading of files
Built-in documentation, as well as a comprehensive help page
Multi-language interface (currently English and French)
Intuitive user interface for all of the above
~16000 lines of code (including tests)

Documentation

See src/PipeScore/README.md for documentation.

This manual is a helpful guide to BWW files.

Running locally

You will need:

python3 (and pip3)
npm

To install dependencies, run:

$ npm install            # install JS dependencies
$ pip3 install svgwrite  # install svgwrite, for building icons

To build JS files, icons and HTML pages, run:

$ npm run build     # build JS, static pages and icons

Run the following commands to run locally, ideally in separate terminals:

$ npm run dev       # run the development server
$ npm run watch     # rebuild JS on changes
$ npx tsc --watch   # typecheck

To build a production JS bundle run:

$ npm run build    # build minified bundle

Contributors

Thank you to any and all who have contributed code to PipeScore!

benjaminelliot - the initial implementation of BWW file parsing
HerveDubois - translations of gracenote names into French