What's New

How is the world treating you? Updated 11-20-2022

News and views about the Smoosic Application and Smoosic Library

November, 2022

Where to start...Smoosic has been disassembled and reassembled multiple times. A project like this is never 'complete', but pretty much everything that I intended to do with Smoosic is now working, to some extent:

scores with part extraction
playback with instruments and samples
real-time editing, even for large scores
MIDI and MusicXML import and export has been enhanced. You can now export from Smoosic and import into MuseScore and vise-versa.
dynamic music library with links to scores, tags etc. Inspired by iRealPro app 'ireal' format
library mode for custom applications

I have rewritten the SVG rendering so that each page is its own SVG element (Renderer context, in VexFlow terminology). This allows us to edit large scores more quickly, since each SVG element is smaller. The renderer will only update pages that have changed music.

I added basic part features like transposing score, part-specific text, multi-measure rests.

Music playback is sample-based. Original samples come from Electronic Music Studios and Sonatina Symphonic Orchestra.

May 1 2022

Change to the way proportionality (softmax) is computed:

Measure default is now 0, non-0 values indicates it overrides score default. Default values means it uses whatever the score default is
score default is now in GlobalLayout ScoreModifier, not in preferences. It seemed to be more at home with the other layout parameters since they affect rendering.
the default value is now 5, down from 100. There has been [some discussion on the vexflow forums (https://github.com/0xfe/vexflow/pull/1383)] that the vexflow default is too high. This can result in shorter notes getting too little horizontal space, especially between the last 2 notes of a measure.

March 20, 2022 (potentially breaking)

Merged latest vexflow (4.0.1) with Smoosic. There are some changes in the API signatures for note modifiers (accidentals, etc.) that will break against earlier versions of Smoosic. But the formatting improvements for Vexflow 4.0.1 over 3.0.x are worth it.

Also fix a few bugs with copy/paste.

Jan 8 2022

Fix issues persisting part-specific layout, formatting, and key. Fix issues transposing in import/export musicXML.

(Potentially breaking) Config/application changes, December 2021

I am trying to simplify and canonize the rules for what the configuration file needs to contain, in the process reducing hard-coded magic that happens when the library or application is bootstrapped.

These configuration parameters apply to both application and library mode:

The parameter scoreDomContainer must specify the DOM element where the music is to be rendered, either string ID or HTMLElement.
The only parameter that is specified now on the query string is the language (?lang=xx). Everything else is specified in the configuration file. The language is, too, but the query string can override it.
if initialScore contains either a JSON score or a SmoScore object, it will start with that score
if the remoteScore contains a string, we will try to load the initial score from either XML or JSON file from that URL
If neither of these is specified and the local storage contains a score, it will load that.
If none of the above, the default (one measure of rests) score is produced.

The changes to remote loader basically mean you no longer need to do any promise/waiting to render a score.

These apply in application mode:

leftControls and topControls contain specifiers or HTMLElements for the button controls. If these elements are not present the UI will not launch.
menu and dialog DOM containers are created automatically, no need to specify those.

The configuration file is no longer a global. It is passed as a parameter where needed - I thought this would help with support of multiple editing regions in the DOM - think CKEditor.

I removed the concept of 'actions' to record editing macros. I burrowed this from a DAW called Reaper. Reaper lists the actions you have performed so you can copy them and apply them to other tracks/channels etc. But this didn't really work in Smoosic - the action is so dependent on the current selection that it wasn't deterministic. It's also probably not required - since this is a javascript application, you can do what you want to the score whenever you want.

I also removed all the instance details from the configuration object. Only DOM and configurable parameters are in the config object. The global Smo.SuiApplication.instance object contains hooks to the global instance.

MusicXML improvements, December 2021

I've been going through the MusicXML samples and testing for round trip, features missing etc. Also comparing against MuseScore. There was some XML we were emitting that wasn't correct according to the spec, and some which was just wrong or missing. Tempo, repeats, slurs, time signatures.

Round trip XML will always be a little bit 'lossy' since Smoosic does things a little bit differently than Finale.

MIDI import, for realsies, December, 2021

I replaced the midi parsing function with the one from https://github.com/NHQ/midi-file-parser/. This code seems to handle running status correctly. I did some comparisons to MuseScore input and it is...comparable. I added variable quantization to different note lengths, and basic triplet support. It doesn't support instruments so much, but instrument support in Smoosic in general is pretty raw.

MIDI import (sort of) November, 2021

I had hoped to finish MIDI import this week, but as usual I misunderestimated how hard it would be. The files exported from Smoosic import OK, except for tuplets. But any MIDI file from a performance or exported by another program is a crapshoot. I will need some logic dedicated to inferring the correct rhythms from the midi ticks.

Typescript migration complete (Halloween, 2021)

All of the project files have been rewritten in Typescript. The UI, particularly the dialog and menus, have been redone in a more component-friendly way. I expect to create new pens that describe how to create new UI elements, and modify existing ones.

Webpack migration complete (August, 2021)

Typescript migration underway. Most SMO files are already migrated. Pens have been updated to reflect the new build target.

If you are using the library, the biggest change will be mangling the 'Smo' namespace in your references to Smoosic types.

Webpack and general rewrite (July, 2021)

2 ways to do a thing, right and over. Some aspects of Smoosic need a fresh iteration before I can go much further.

First big change, moving from concat to webpack. I realize now why people use it. There's no other way to check for defined/unused symbols with a bunch of scripts that don't know about each other.

Once I am in webpack-land, I can start moving the SMO music files to typescript. Right now it is too easy to pass an Ornament when an Articulation is expected, etc.

While doing this, I expect to revisit the object model. 2 things that I did not consider in the first go-round:

Formatting can be score or part-specific, and can be score-wide or page-wide
Modifiers can be mapped to a specific note/measure, or the column, and can also be per part or per score.
Some attributes of objects are generated while rendering, others are serialized and persist.

Out of consideration for those who use Smoosic currently, and fear that it won't work out, I'm doing this work on a separate branch. I expect existing Smoosic files will be backwards-compatible. I will try to minimize the impact on existing codes.

UI improvements and bug fixes (April 3, 2021)

Background Rendering, Lyrics/Multi-Voice/Scrolling improvements and bug fixes.

Rendering longer scores, even just a page or 2, was frustrating. It can take several seconds to re-render the entire score. We now render in the background, with a progress bar, allowing one to edit while the score is rendering. Full re-render timer is pro-rated on render time, so you get more editing time.

Fixed some bugs with xml import/export.

Added measure-add dialog, for multiple measures.

Smoosic Application

Feb, 2021

Introducing...the Smoosic API. I've made a few minor tweaks in the initialzaiton that make it possible to create a library version of Smoosic. This has no native GUI, so you can create your own, or just call the API and render some music.

I created the following pens to help demonstrate how to use it.

Smoosic API This creates a simple HTML container, and renders a score in it. It demonstrates the mimimal objects you need to create, and how to update the model in such a way that your changes get rendered.

Load Score This demonstrates how to load a pre-made score and render it.

Load Music XML Similar to the above, but with an Music XML score (finale format).

Simple Music Editor I've been asked how to embed the editor in CKEditor or some other application that has its own event model This example shows that. It implements a very minimal music editor, and shows how keyboard and mouse events are handled.