![\"Scale](\"src/assets/favicon/apple-touch-icon.png\"){kind=icon}
Overview
\n \nThe interface is split in to 4 sections.
\n- \n
- Top bar: access the main functions of the software \n
- Left column: manual entry of scale data \n
- Center column: table of tuning data \n
- Right column: options and configuration \n
The top bar provides many useful functions.
\n- \n
- New: generate a new scale or load one from a file \n
- Modify: apply some transformation to a scale that is currently loaded \n
- Export: save your work in one of many formats \n
- About: about Scale Workshop \n
Import/export tunings
\nImport
\nScale Workshop supports import of Scala .scl files, AnaMark .tun files and Korg 'logue .mnlgtuns/.mnlgtuno'.\n Click 'New' on the top menu bar and then click 'Import .scl' or 'Import .tun'
\n \nNote: AnaMark .tun import is incomplete, but it should be able to import .tun V2.00 files exported by\n Scale Workshop and Scala.
\n\nConvert
\nConvert .scl or convert .tun tunings by importing them and then exporting.
\n\nExport
\nMany synthesizers support microtonal scales. Usually they will require some format of tuning file. Scale Workshop\n supports many of the popular formats.
\nTo see a list of synths that support microtonal scales, see the
AnaMark TUN (.tun)
\nIf your synth supports .tun format, then please refer to its manual to find how to load the .tun file.
\n\nScala scale (.scl)
\nIf your synth supports .scl format, then please refer to its manual to find how to load the .scl file.
\n\nScala keyboard mapping (.kbm)
\nScale Workshop does not support arbitrary keyboard mappings, however it can output a .kbm file with linear\n mapping that has your chosen base MIDI note and base frequency.
\n\nMax/MSP coll (.txt)
\nWhen building synths in Max/MSP try using a coll object rather than an mtof object. Coll can load a\n specially-formatted text file containing a list of frequencies. Scale Workshop exports this kind of text file for\n you. Set up your coll object as below, and click the 'read' button to bring up a load file dialog.
\n \nThen when you input MIDI note numbers to the coll object, it will output the desired frequency.
\n\nPureData text (.txt)
\nWhen building synths in PureData try using a text object rather than an mtof object. The text object can load a\n specially-formatted text file containing a list of frequencies. Scale Workshop exports this kind of text file for\n you. Then when you input MIDI note numbers to the text object, it will output the desired frequency.
\n\nKontakt script (.txt)
\nKontakt's scripting environment allows you to retune each key to any pitch. Scale Workshop can export this script\n for you automatically. Once exported, copy and paste the contents of the script into the script editor of your\n Kontakt instrument.
\n\nSoniccouture tuning file (.nka)
\nTuning format for Soniccouture's sampled instruments for Kontakt.
\n\nHarmor Pitch Map (.fnv)
\nHarmor allows retuning keys from C0 to C10 for up to 5 octaves up or down from 12 EDO.\n To do so, go to the \"Pitch\" tab, then \"Keyboard mapping\".\n Click the small arrow at the bottom left and select \"Open State File...\".\n From there, open the file that you exported from Scale Workshop.\n You will have to do this for every part that you use (A and/or B).
\n\nSytrus Pitch Map (.fnv)
\nSytrus allows retuning keys from C0 to C10 for up to 4 octaves up or down from 12 EDO.\n Warning: You won't be able to slide notes. If you do, the pitch will be incorrect.\n To do so, go to operator you want to retune, select the \"Pitch\" tab, then \"Keyboard mapping\".\n Click the small arrow at the bottom left and select \"Open State File...\".\n From there, open the file that you exported from Scale Workshop.\n Then, turn PE (Pitch Envelope) knob to the maximum value.
\n\nKorg Sound Librarian Scale/Octave (.mnlgtuns/.mnlgtuno)
\nThese are for the Sound Librarian software associated with Korg's Monologue, Minilogue, and Prologue synths, \n and can be loaded with the \"File > Load Single Scale\" menu option. The \"Scale\" format follows the MIDI 1.0 \n \"Bulk Tuning Dump\" specification that allows for a 128-note table defined in semitones plus .0061 cents \n of precision with a supported frequency range of 8.1758 Hz to 12543.875 Hz. The \"Octave\" format follows \n the \"Scale/Octave Tuning Dump\" MIDI specification and only allows for 12 defined notes that will automatically \n repeat at the octave. Scales with more than 12 notes will be cut off, and pitches can only deviate from standard \n tuning by -64/+63 cents.
\n \nDeflemask 'fine tune' reference (.txt)
\nExports a reference sheet to help you make microtonal music using the Deflemask tracker. Notes in Deflemask can have a 'fine tune' property. This reference sheet will show you the data you need to input.
\n\nReaper Note Name Map (.txt)
\nReaper allows all 128 rows in its piano roll MIDI editor to have a custom label. This export option gives\n each note a label based on its pitch, with some other properties depending on the selected options.\n \"Scala Data\" will preserve the notes' notation, keeping ratios when possible and allowing for mixed notations. \n For \"Cents\", \"Frequencies\", and \"Decimals\", each interval will be converted to the chosen format. \"Degrees\" \n will simply use \"N\\D\" notation where N is the scale degree and D is the number of notes \n the scale has.\n Show Period Number will put the octave/period number of the interval after the pitch label.\n Calculate Period in Pitch will transpose each interval by the number of periods it is from the base note.\n It will try to preserve the notation of the interval, but will fallback to cents if it's not possible.\n Base Period Number will shift the base note from unison by this many periods. For example if you want your\n the base note & frequency to be note 48 at 256 Hz, but want unison to be an octave higher with note 60 at 512 Hz,\n you can set this to -1 period, meaning the base note & frequency is shifted one period below unison.\n Base Cents Value and Base Degree Number allow you to set a different value for the base note in \n cents or degrees respectively, similar to the \"Base Period Number\" option. In most cases this should be 0.
\nReaper will look for these files by default in:
- \n
- Windows - C:\\Users\\[username]\\AppData\\Roaming\\REAPER\\MIDINoteNames \n
- macOS - /Users/[username]/Library/Application Support/REAPER/MIDINoteNames
Presets
\nA selection of preset scales are provided as examples.
\n \n\n\nScale design
\nScale Workshop allows you to create musical scales either by manual data input or by selecting menu options.\n We'll cover the menu options first.
\nStart by clicking the New option on the top menu bar. Select from equal temperament, rank-2\n temperament, etc.
\n \n\nEqual temperaments
\nEqual temperaments are scales where every\n step is of equal size. The most well-known example perhaps is 12-tone equal temperament (12edo) which divides an\n octave into 12 equal parts and is the standard tuning in the West. Other well known equal tempered scales include\n 24edo (quartertones), 19edo and 31edo.
\nTo create a new equal temperament scale click New > Equal temperament and then enter values\n to create the scale.
\n \nNumber of divisions refers to the number of notes in your scale. Interval to divide will usually be 2/1 (octave)\n but could be a different value, for example to make Bohlen-Pierce you would have 13 divisions of 3/1.
\n\nRank-2 temperaments
\nCreate a rank-2 temperament using a generator and period.
\n \n\nHarmonic series segments
\nGenerate a segment of the harmonic series by specifying the lowest and highest harmonics to be part of the scale.\n If the highest harmonic is double that of the lowest harmonic then the scale will repeat at the octave.
\n \n\nSubharmonic series segments
\nGenerate a segment of the subharmonic series by specifying the lowest and highest subharmonics to be part of the\n scale. If the highest subharmonic is double that of the lowest subharmonic then the scale will repeat at the\n octave.
\n \n\nEnumerate chord
\nCreate a scale from a list of harmonics separated by colons.
E.g. 4:5:6:7:8
![](\"src/assets/img/guide/enumerate-chord.png\")
Combination product set
\nCreate a scale by multiplying harmonics in different combinations. Optionally, the resulting scale can be reduced by 2/1 and sorted in ascending order.
\nCombination product set (Xenharmonic Wiki)
\n![](\"src/assets/img/guide/cps.png\")
Manual data entry
\nScales can be written manually by typing them in to the Scale data text field. Enter one\n interval per line. Do not enter 1/1 on the first line as it is already assumed that the first note is 1/1.
\n \nValues with a . are cents values: e.g. 701.955
\n Values with slash (/) are ratios: e.g. 3/2
\n Values with a backslash (n\\m) are n degrees of m-EDO: e.g. 7\\12
\n Values with comma (,) are decimals: e.g. 1,5
\n The final value is your octave or pseudo-octave: e.g. 2/1
Just intonation examples
\n5-limit just major:
\n9/8\n5/4\n4/3\n3/2\n5/3\n15/8\n2/1\n
Harmonics 8-16:
\n9/8\n10/8\n11/8\n12/8\n13/8\n14/8\n15/8\n16/8\n\n
Equal temperament examples
\nBlackwood[10] in 15edo:
\n2\\15\n3\\15\n5\\15\n6\\15\n8\\15\n9\\15\n11\\15\n12\\15\n14\\15\n15\\15\n
8edo in cents:
\n150.\n300.\n450.\n600.\n750.\n900.\n1050.\n1200.\n\n
Misc examples
\nYou can combine any of the above styles in the same scale if needed:
\n1,2\n3\\9\n700.1\n2/1\n\n\n
Modify scales
\nThere are menu options to help you modify your current scale. Note you must have some scale data loaded already\n in order to modify it. Click 'Modify' on the top menu bar to see the options.
\n \n\nSort ascending
\nSorts your scale ascendingly.
\n \nReduce
\nMakes your entire scale fit within a desired 'modulus' interval, typically 2/1. Intervals in your scale which are larger than the modulus will wrap around, leaving only a remainder.
\n\nRotate
\nAllows you to choose an interval of your scale to become 1/1.
\n\nSubset
\nTakes a subset of the current scale. Subsets are entered numerically.
\n \n\nStretch/compress
\nApplies a linear stretch across the current scale. Enter a stretch factor, where 1 is no stretch at all.
\n \n\nRandom variance
\nApplies a random detuning of each note in the scale. If the checkbox is ticked, this will also detune the octave.\n If unticked, the octave will remain unchanged.
\n \n\nTempo-sync beating
\nThis retunes each note of your scale to the nearest harmonic and then tunes the base frequency to match the BPM.\n This can result in LFO-like pulsations when playing chords.
\nThe effect is most effective when using \"rich\" harmonic sounds (e.g. sawtooth waves) on a synth with excellent\n intonation accuracy (e.g. almost all digital synths).
\n \nResolution allows you to control how much retuning is applied. Low values will result in a more drastic retuning\n of your original scale; in some cases this will result in notes converging on the same note, resulting in\n duplicates. For more obvious tempo-synced effects, choose a resolution that is a power of 2, e.g. 32, 64, or 128.\n
\n\nApproximate by ratios
\nThis steps you through each interval of your scale, shows you a selection of ratios that are close to your interval, and allows you to choose the ratio for each.
\n\nApproximate by harmonics
\nThis retunes each interval in your scale to the nearest harmonic. You select the denominator.
\n\nApproximate by subharmonics
\nThis retunes each interval in your scale to the nearest subharmonic. You select the numerator.
\n\nEqualize
\nThis retunes each interval in your scale to the nearest equal step. You select the number of steps to equally divide the interval of equivalence.
\n\nSynthesizer
\nScale Workshop has a built-in synth so that you can play and hear your scales. This is useful for auditioning the\n scale you're working on, however it is very simple and isn't recommended for live performance.
\n\nPlaying with a MIDI controller
\nPlay notes on any connected MIDI device in order to hear your current scale. This requires you to use a web-MIDI capable browser. Must be enabled first by clicking\n the 'MIDI I/O' menu option then clicking the 'MIDI on' button while your controller is connected.
\n\nPlaying with QWERTY
\nUse your computer keyboard to play your current scale, much like an isomorphic keyboard.
\nNote: QWERTY note input is disabled any time that a text or input field has focus. An indicator\n can be seen at the top-right of the screen to show you if you are able to play the QWERTY keyboard currently:
\n \n \nNot all international keyboard layouts are supported. Users who wish to see their keyboard layout supported are\n encouraged to contribute to the project by adding their own layout to keymap.js in the project source.
\n\nPlaying with mouse / touch screen
\nOn the top menu, click Virtual Kbd to display a grid overlay. Click / Touch the grid to hear your scale. The mapping on the\n grid is the same as the mapping on the QWERTY keys.
\n \n\nIsomorphic mapping
\nWhen using the QWERTY or the Virtual keyboard, by default each note along a horizontal axis is 1 scale degree\n apart and each note along vertical axis is 5 scale degrees apart. This can be changed by using the\n Isomorphic keyboard settings shown on the right column of the Scale Workshop interface.
\n \n\nChanging the sound of the synth
\nThe synth has the following options:
\n- \n
- Main Volume \n
- Waveform: Semisine (default), Octaver, Triangle, Square, Sawtooth, Brightness, Harmonic Bell, Warm, Sine \n
- Amplitude envelope: Organ, Pad, Percussive (Short, Medium and Long) \n
- Delay effect: feedback delay echo \n
- Max polyphony: maximum number of voices that can be played at one time. Use a low value if you're on a low powered device. Many devices will be capable of 64 or more simultaneous voices. Must refresh the page for changes to take effect. \n
MIDI I/O
\nScale Workshop can behave like a MIDI tuning box, allowing for MIDI input into the app and then outputting MIDI notes plus multichannel pitch bend messages, thereby allowing you to hear your scale on a supported MIDI synth.
\nBefore getting started, make sure that your web browser is web-MIDI compatible. Not all browsers support MIDI I/O.
\nOn your MIDI synth device, you should set pitch bend range to +/- 1 octave.
\nConnect your MIDI device(s) to your computer, then click the MIDI I/O option in the top menu. Then click the red 'MIDI on' button. If this was successful, the button will turn green and you will see a list of your MIDI devices below.
\n![](\"src/assets/img/guide/midi-io-settings.png\")
MIDI devices can be enabled or disabled by selecting the check boxes next to each device. Each individual channel can also be enabled or disabled by the check boxes.
\n\nMisc. tips
\nGeneral settings can be found on the right side of the Scale Workshop interface.
\n \nIf an exported tuning file doesn't seem to load into a softsynth properly, then try changing the value of\n Line endings format and re-saving the file. If you're using a Windows computer it's recommended\n to set this to Microsoft, otherwise set this to Unix.
\nDark mode makes the Scale Workshop interface dark.
\n \nUndo/redo your tuning changes by using the back/forward browser navigation buttons.
\nIf the synth gets too noisy, you can kill all sound by clicking the Quiet button.
\n![](\"src/assets/img/scale-workshop-og-image.png\")
\n ![](\"src/assets/favicon/android-chrome-192x192.png\")
\n \n