Skip to content

Song Dialog

Albert S. edited this page Oct 26, 2026 · 1 revision

Song Properties

The Song Properties dialog allows you to view and edit information about the current Shakuhachi Song. It provides settings for song metadata, notation layout, musical parameters, and statistics.

The dialog contains four tabs:

  • General — Song information and metadata
  • Layout — Notation layout and spacing
  • Music Parameters — Tempo, time signatures, and tempo changes
  • Statistics — Information about the song's contents

General

The General tab contains descriptive information about the song.

Filename

Displays the current file path of the song.

This field is read-only and cannot be modified directly.

Open Read Only

Controls whether the song should be opened in read-only mode by default.

Enable this option to indicate that the song should normally be protected from editing when opened.

Title

Specifies the title displayed for the song.

If the song does not already have a title, the application may initially use the filename without its extension.

The title can contain up to 75 characters.

Author

Enter the name of the composer, arranger, or author.

The author field can contain up to 75 characters.

Version

Specifies the version or revision of the song.

For example:

  • 1.0
  • Revised Edition
  • Arrangement 2026

The version field can contain up to 75 characters.

Date

The dialog includes a date selector.

Note: In the current implementation, this control is not connected to a stored song property. Changing the displayed date does not update the song metadata.

Description

Enter additional information about the song, such as:

  • Musical background or history
  • Performance instructions
  • Arrangement notes
  • Information about the composer
  • Other remarks

The description supports multiple lines of text.

Layout

The Layout tab controls how notes and measures are arranged in the score.

Bars in boxes

Enables the display of musical bars within individual boxes.

This can help visually separate measures and make the notation easier to follow.

Normalize bar size

Adjusts the layout to normalize the size of bars.

This option is available only when Bars in boxes is enabled.

Avoid splitted bars

Attempts to prevent bars from being split across layout boundaries.

This option is available only when both Bars in boxes and Normalize bar size are enabled.

Visual quantsize to

Controls the visual quantization used when displaying note durations and spacing.

Enable Visual quantsize to and select one of the following values:

Value Musical subdivision
1/2 Half note
1/4 Quarter note
1/8 Eighth note
1/16 Sixteenth note
1/32 Thirty-second note

The selected value determines the visual quantization setting used for the score.

When the option is disabled, visual quantization is turned off.

Note: This setting controls notation layout rather than changing the underlying note pitches.

Music Parameters

The Music Parameters tab provides information about the musical structure of the song and allows you to modify the base tempo.

Notation

Displays the notation system used by the current track.

This information is displayed for reference and cannot be changed directly in this dialog.

Time Signature Changes

Lists the time signature changes defined in the song.

The table contains the following columns:

Column Description
Delete Selects a time signature change for deletion
Bar Number Position of the time signature change
Time Signature Numerator and denominator of the time signature

For example, a time signature of 4/4 indicates four quarter-note beats per measure.

Removing a Time Signature Change

  1. Locate the time signature change in the list.
  2. Check the corresponding Delete box.
  3. Click OK to apply the deletion.

Important: The first beat in bar 1 cannot be deleted. The application displays an error message if you attempt to remove this initial entry.

Tempo Changes

Displays the tempo changes defined within the song.

The table contains:

Column Description
Delete Selects a tempo change for deletion
¼ Position Position expressed in quarter-note units
Tempo Tempo information

Removing a Tempo Change

  1. Locate the tempo change in the list.
  2. Check its Delete box.
  3. Click OK to apply the deletion.

This list is intended for reviewing and removing existing tempo changes.

Tempo

Controls the song's base playback tempo in beats per minute (BPM).

The slider supports the following range:

Setting Value
Minimum tempo 40 BPM
Maximum tempo 160 BPM
Slider interval 10 BPM

The dialog displays musical tempo indications such as:

  • Largo — Very slow
  • Andante — Walking pace
  • Moderate — Moderate speed
  • Allegro — Fast and lively

Move the slider to increase or decrease the playback tempo.

The currently selected BPM value is displayed next to the slider.

Tempo...

Click Tempo... to open the tempo picker dialog.

This provides an alternative way to select the tempo. After confirming the selection, the tempo slider is updated.

Duration

The estimated duration of the song is recalculated when the base tempo changes.

The displayed duration is expressed in seconds and is based on the song's beat count and the selected BPM:

Duration = 60 × Beats / BPM

This is a calculated estimate, not necessarily the exact duration of playback with tempo changes.

Statistics

The Statistics tab displays information about the current song.

These values are informational and cannot be edited directly.

Notes

Displays the total number of notes in the song.

Beats

Displays the total number of beats calculated for the song.

Duration

Displays the estimated duration in seconds.

The duration is calculated using the song's beat count and the selected base tempo.

Zoom factor

Displays the current scale or zoom factor of the score.

This value reflects the song's current display scaling.

Saving and Canceling Changes

OK

Click OK to accept the changes and close the dialog.

The application applies the edited song information and layout settings, including:

  • Title
  • Author
  • Version
  • Description
  • Open Read Only
  • Bars in boxes
  • Normalize bar size
  • Avoid splitted bars
  • Visual quantization
  • Selected time signature deletions
  • Selected tempo change deletions

Changes to the base tempo are applied when the tempo control is adjusted.

Cancel

Click Cancel to close the dialog without applying the other pending edits.

The original base tempo is restored.

Note: The time signature and tempo change entries marked for deletion are only removed when OK is clicked.

Tips

  • Use a descriptive Title and Author to identify your compositions.
  • Add performance instructions and background information in Description.
  • Enable Bars in boxes when you want clearer visual separation between measures.
  • Use Normalize bar size to achieve a more consistent layout.
  • Select Avoid splitted bars when you want to keep measures together.
  • Experiment with Visual quantsize to to improve the visual spacing of the notation.
  • Adjust Tempo to practice difficult passages at a slower speed.
  • Review the Statistics tab to check the number of notes, beats, and estimated duration.

Related Help Pages

Source Code

Clone this wiki locally