Chord Beats - Revision history

Marekpalka at 11:43, 31 July 2026

2026-07-31T11:43:08Z

← Older revision		Revision as of 13:43, 31 July 2026
Line 20:		Line 20:
	#* '''Timeline''' — chords are laid out on a horizontal timeline bar.		#* '''Timeline''' — chords are laid out on a horizontal timeline bar.
	# For '''Stacks''', '''Pills''', and '''Timeline''' styles you can also set '''Bars per line''' to control how many bars fit on one row.		# For '''Stacks''', '''Pills''', and '''Timeline''' styles you can also set '''Bars per line''' to control how many bars fit on one row.

			You can also override this setting per song from the song's '''Song-Specific Preferences''' panel (the '''Chord Beats''' toggle under song overrides).

			== Editing Beat Counts ==

			Assign beats to chords using the [[SongEditor]]'s Chord Beats mode.

			# Open the song and tap '''Edit'''.
			# In the top toolbar, switch the syntax picker from ''ChordPro'' or ''Chords Over Lyrics'' to '''Chord Beats'''.
			# The editor renders every chord in the song with its current beat count. A style picker appears next to the syntax picker so you can preview a different display style while editing.
			# Tap a chord to select it.
			# Use the bottom toolbar to adjust the selected chord:
			#* '''Previous''' — <code>⌘ ←</code>
			#* '''Minus''' — <code>⌘ ↓</code> (decrease beats, minimum 0)
			#* '''Plus''' — <code>⌘ ↑</code> (increase beats)
			#* '''Next''' — <code>⌘ →</code>
			# Switch syntax or close the editor — beat values are written back into the song automatically.

			== Tips ==

			* Beat counts are stored per chord, so they survive transposition and capo changes.
			* Setting '''Beats = 0''' hides the beat indicator for that chord while keeping the chord itself.
			* Chord Beats data is also used by '''Chord Beats Sync''' (Settings → Chord Beats Sync) to drive MIDI clock / AUv3 transport, send chords as MIDI notes, and auto-scroll the song in real time.

Marekpalka at 11:41, 31 July 2026

2026-07-31T11:41:14Z

← Older revision		Revision as of 13:41, 31 July 2026
Line 1:		Line 1:
	'''Chord Beats''' show the duration of each chord in your song. Each chord is ~~followed by small dots (•) indicating how many beats it lasts~~, so musicians can see at a glance when to change chords~~. Chords longer than 8 beats are shown as a number followed by a single dot (e.g. <code>12•</code>)~~.		'''Chord Beats''' show the duration of each chord in your song. Each chord is annotated with its beat count, so musicians can see at a glance when to change chords.
	<gallery>		<gallery>
	File:chordBeats0.png		File:chordBeats0.png
Line 12:		Line 12:

	# Open '''Settings → Song View'''.		# Open '''Settings → Song View'''.
	# Scroll to the ~~chord display section.~~		# Scroll to the '''Chord Beats''' section.
	~~# Turn on~~ '''~~Show~~ Chord Beats'''.		# Turn on '''Show'''.
	# ~~(Optional)~~ Turn on '''~~Hide full measures (dots)'~~'' ~~to suppress dots for chords that already last a full measure (i.e. their beat count matches the song~~'~~s time signature). Only non-default durations will be drawn~~.		# Choose a '''Style''':
			#* '''Dots''' — each chord is followed by small dots (•) for each beat; chords longer than 8 beats show a number (e.g. <code>12•</code>).
	~~You can also override this setting per song from the song~~'s '''~~Song-Specific Preferences~~''' ~~panel (the~~ ''~~'Chord Beats~~''' ~~toggle under song overrides~~).		#* '''Stacks''' — beats are stacked vertically below each chord.
			#* '''Pills''' — beat count shown as a compact pill badge on each chord.
	~~== Assigning Beats to Chords ==~~		#* '''Timeline''' — chords are laid out on a horizontal timeline bar.
			# For '''Stacks''', '''Pills''', and '''Timeline''' styles you can also set '''Bars per line''' to control how many bars fit on one row.
	~~Once Chord Beats are visible, use the [[SongEditor]] to set the duration of each chord~~.

	# ~~Open the song and tap~~ '''~~Edit~~'''.
	# ~~In the editor, switch the syntax picker from~~ ''~~ChordPro~~'' / ''~~Chords Over Lyrics'' to '''Chord Beats'''.~~
	~~# The editor renders every chord in the song with its current~~ beat count ~~drawn~~ as ~~dots underneath.~~
	~~# Tap~~ a ~~chord to select it — an orange underline marks the active~~ chord.
	~~# Use the bottom toolbar to adjust:~~
	#* '''~~◁ Previous chord~~''' — ~~<code>⌘ ←</code>~~
	#* '''~~− Decrease beats~~''' ~~— <code>⌘ ↓</code>~~
	~~#* '''+ Increase beats''' — <code>⌘ ↑</code>~~
	#* '''~~▷ Next chord~~''' ~~— <code>⌘ →</code>~~
	~~# Leave the Chord Beats editor (or switch syntax) and the new beat values are written back into the song.~~

	~~== Tips ==~~

	* Beat counts are stored per chord, ~~so they survive transposition~~ and ~~capo changes.~~
	* Setting '''~~Beats = 0~~''' ~~hides the dot for that chord while keeping the chord itself.~~
	* Chord Beats data is also ~~used by~~ '''~~Chord Beats Sync~~''' ~~(Settings → Chord Beats Sync)~~ to ~~drive MIDI clock / AUv3 transport, send chords as MIDI notes, and auto-scroll the song in real time~~.

Marekpalka at 11:38, 31 July 2026

2026-07-31T11:38:33Z

← Older revision		Revision as of 13:38, 31 July 2026
Line 1:		Line 1:
	# Chord Beats		'''Chord Beats''' show the duration of each chord in your song. Each chord is followed by small dots (•) indicating how many beats it lasts, so musicians can see at a glance when to change chords. Chords longer than 8 beats are shown as a number followed by a single dot (e.g. <code>12•</code>).
			<gallery>
			File:chordBeats0.png
			File:chordBeats1.png
			File:chordBeats2.png
			File:chordBeats3.png
			</gallery>

	Chord Beats show the duration of each chord in your song. Each chord is followed by small dots (•) indicating how many beats it lasts, so musicians can see at a glance when to change chords. Chords longer than 8 beats are shown as a number followed by a single dot (e.g. `12•`).		== Enabling Chord Beats ==

	~~## Enabling~~ Chord Beats		Chord Beats are hidden by default. Enable them in the [[SongViewer]] settings before assigning beats to chords.

	Chord Beats ~~are hidden by default~~. ~~Enable them in the Song Viewer settings before assigning beats~~ to chords.		# Open '''Settings → Song View'''.
			# Scroll to the chord display section.
			# Turn on '''Show Chord Beats'''.
			# (Optional) Turn on '''Hide full measures (dots)''' to suppress dots for chords that already last a full measure (i.e. their beat count matches the song's time signature). Only non-default durations will be drawn.

	~~1. Open Settings →~~ Song ~~View.~~		You can also override this setting per song from the song's '''Song-Specific Preferences''' panel (the '''Chord Beats''' toggle under song overrides).
	~~2. Scroll to~~ the ~~chord display section.~~
	~~3. Turn on Show~~ Chord Beats.
	~~4. (Optional) Turn on Hide full measures (dots) to suppress dots for chords that already last a full measure (i.e. their beat count matches the~~ song~~'s time signature~~)~~. Only non-default durations will be drawn~~.

	~~You can also override this setting per song from the song's Song-Specific Preferences panel (the Chord~~ Beats toggle under song overrides).		== Assigning Beats to Chords ==

	~~## Assigning~~ Beats to ~~Chords~~		Once Chord Beats are visible, use the [[SongEditor]] to set the duration of each chord.

	~~Once~~ Chord Beats ~~are visible, use~~ the ~~Song Editor~~ to ~~set~~ the ~~duration of each~~ chord.		# Open the song and tap '''Edit'''.
			# In the editor, switch the syntax picker from ''ChordPro'' / ''Chords Over Lyrics'' to '''Chord Beats'''.
			# The editor renders every chord in the song with its current beat count drawn as dots underneath.
			# Tap a chord to select it — an orange underline marks the active chord.
			# Use the bottom toolbar to adjust:
			#* '''◁ Previous chord''' — <code>⌘ ←</code>
			#* '''− Decrease beats''' — <code>⌘ ↓</code>
			#* '''+ Increase beats''' — <code>⌘ ↑</code>
			#* '''▷ Next chord''' — <code>⌘ →</code>
			# Leave the Chord Beats editor (or switch syntax) and the new beat values are written back into the song.

	~~1. Open the song and tap Edit.~~		== Tips ==
	~~2. In the editor, switch the syntax picker from ChordPro / Chords Over Lyrics to Chord Beats.~~
	~~3. The editor renders every chord in the song with its current beat count drawn as dots underneath.~~
	~~4. Tap a chord to select it — an orange underline marks the active chord.~~
	~~5. Use the bottom toolbar to adjust:~~
	~~- ◁ Previous chord — `⌘ ←`~~
	~~- − Decrease beats — `⌘ ↓`~~
	~~- + Increase beats — `⌘ ↑`~~
	~~- ▷ Next chord — `⌘ →`~~
	~~6. Leave the Chord Beats editor (or switch syntax) and the new beat values are written back into the song.~~

	~~## Tips~~		* Beat counts are stored per chord, so they survive transposition and capo changes.
			* Setting '''Beats = 0''' hides the dot for that chord while keeping the chord itself.
	- Beat counts are stored per chord, so they survive transposition and capo changes.		* Chord Beats data is also used by '''Chord Beats Sync''' (Settings → Chord Beats Sync) to drive MIDI clock / AUv3 transport, send chords as MIDI notes, and auto-scroll the song in real time.
	- Setting Beats = 0 hides the dot for that chord while keeping the chord itself.
	- Chord Beats data is also used by Chord Beats Sync (Settings → Chord Beats Sync) to drive MIDI clock / AUv3 transport, send chords as MIDI notes, and auto-scroll the song in real time.

Marekpalka at 11:37, 31 July 2026

2026-07-31T11:37:26Z

← Older revision		Revision as of 13:37, 31 July 2026
Line 1:		Line 1:
	Chord Beats		# Chord Beats

	~~'''~~Chord Beats~~'''~~ show the duration of each chord in your song. Each chord is followed by small dots (•) indicating how many beats it lasts, so musicians can see at a glance when to change chords. Chords longer than 8 beats are shown as a number followed by a single dot (e.g. ~~<code>~~12•~~</code>~~).		Chord Beats show the duration of each chord in your song. Each chord is followed by small dots (•) indicating how many beats it lasts, so musicians can see at a glance when to change chords. Chords longer than 8 beats are shown as a number followed by a single dot (e.g. `12•`).
	~~<gallery>~~
	~~File:chordBeats1.png~~
	~~File:chordBeats2.png~~
	~~File:chordBeats3.png~~
	~~</gallery>~~

	== Enabling Chord Beats ==		## Enabling Chord Beats

	Chord Beats are hidden by default. Enable them in the ~~[[SongViewer]]~~ settings before assigning beats to chords.		Chord Beats are hidden by default. Enable them in the Song Viewer settings before assigning beats to chords.

	Open ~~'''~~Settings → Song View~~'''~~.		1. Open Settings → Song View.
	Scroll to the chord display section.		2. Scroll to the chord display section.
	Turn on ~~'''~~Show Chord Beats~~'''~~.		3. Turn on Show Chord Beats.
	(Optional) Turn on ~~'''~~Hide full measures (dots)~~'''~~ to suppress dots for chords that already last a full measure (i.e. their beat count matches the song's time signature). Only non-default durations will be drawn.		4. (Optional) Turn on Hide full measures (dots) to suppress dots for chords that already last a full measure (i.e. their beat count matches the song's time signature). Only non-default durations will be drawn.

	You can also override this setting per song from the song's ~~'''~~Song-Specific Preferences~~'''~~ panel (the ~~'''~~Chord Beats~~'''~~ toggle under song overrides).		You can also override this setting per song from the song's Song-Specific Preferences panel (the Chord Beats toggle under song overrides).

	== Assigning Beats to Chords ==		## Assigning Beats to Chords

	Once Chord Beats are visible, use the ~~[[SongEditor]]~~ to set the duration of each chord.		Once Chord Beats are visible, use the Song Editor to set the duration of each chord.

	Open the song and tap ~~'''~~Edit~~'''~~.		1. Open the song and tap Edit.
	In the editor, switch the syntax picker from ''ChordPro'' / ''Chords Over Lyrics'' to ~~'''~~Chord Beats~~'''~~.		2. In the editor, switch the syntax picker from ChordPro / Chords Over Lyrics to Chord Beats.
	The editor renders every chord in the song with its current beat count drawn as dots underneath.		3. The editor renders every chord in the song with its current beat count drawn as dots underneath.
	Tap a chord to select it — an orange underline marks the active chord.		4. Tap a chord to select it — an orange underline marks the active chord.
	Use the bottom toolbar to adjust:		5. Use the bottom toolbar to adjust:
	#* ~~'''~~◁ Previous chord~~'''~~ — ~~<code>~~⌘ ←~~</code>~~		- ◁ Previous chord — `⌘ ←`
	#* ~~'''~~− Decrease beats~~'''~~ — ~~<code>~~⌘ ↓~~</code>~~		- − Decrease beats — `⌘ ↓`
	#* ~~'''~~+ Increase beats~~'''~~ — ~~<code>~~⌘ ↑~~</code>~~		- + Increase beats — `⌘ ↑`
	#* ~~'''~~▷ Next chord~~'''~~ — ~~<code>~~⌘ →~~</code>~~		- ▷ Next chord — `⌘ →`
	Leave the Chord Beats editor (or switch syntax) and the new beat values are written back into the song.		6. Leave the Chord Beats editor (or switch syntax) and the new beat values are written back into the song.

	== Tips ==		## Tips

	* Beat counts are stored per chord, so they survive transposition and capo changes.		- Beat counts are stored per chord, so they survive transposition and capo changes.
	* ~~Setting '''~~Beats = 0~~'''~~ hides the dot for that chord while keeping the chord itself.		- Setting Beats = 0 hides the dot for that chord while keeping the chord itself.
	* Chord Beats data is also used by ~~'''~~Chord Beats Sync~~'''~~ (Settings → Chord Beats Sync) to drive MIDI clock / AUv3 transport, send chords as MIDI notes, and auto-scroll the song in real time.		- Chord Beats data is also used by Chord Beats Sync (Settings → Chord Beats Sync) to drive MIDI clock / AUv3 transport, send chords as MIDI notes, and auto-scroll the song in real time.

Marekpalka at 11:31, 31 July 2026

2026-07-31T11:31:38Z

← Older revision		Revision as of 13:31, 31 July 2026
Line 2:		Line 2:

	'''Chord Beats''' show the duration of each chord in your song. Each chord is followed by small dots (•) indicating how many beats it lasts, so musicians can see at a glance when to change chords. Chords longer than 8 beats are shown as a number followed by a single dot (e.g. <code>12•</code>).		'''Chord Beats''' show the duration of each chord in your song. Each chord is followed by small dots (•) indicating how many beats it lasts, so musicians can see at a glance when to change chords. Chords longer than 8 beats are shown as a number followed by a single dot (e.g. <code>12•</code>).
			<gallery>
			File:chordBeats1.png
			File:chordBeats2.png
			File:chordBeats3.png
			</gallery>

	== Enabling Chord Beats ==		== Enabling Chord Beats ==

Marekpalka at 06:09, 5 June 2026

2026-06-05T06:09:39Z

← Older revision		Revision as of 08:09, 5 June 2026
Line 31:		Line 31:
	== Tips ==		== Tips ==

	• Beat counts are stored per chord, so they survive transposition and capo changes.		* Beat counts are stored per chord, so they survive transposition and capo changes.
	• Setting '''Beats = 0''' hides the dot for that chord while keeping the chord itself.		* Setting '''Beats = 0''' hides the dot for that chord while keeping the chord itself.
	• Chord Beats data is also used by '''Chord Beats Sync''' (Settings → Chord Beats Sync) to drive MIDI clock / AUv3 transport, send chords as MIDI notes, and auto-scroll the song in real time.		* Chord Beats data is also used by '''Chord Beats Sync''' (Settings → Chord Beats Sync) to drive MIDI clock / AUv3 transport, send chords as MIDI notes, and auto-scroll the song in real time.

Marekpalka at 06:03, 5 June 2026

2026-06-05T06:03:42Z

← Older revision		Revision as of 08:03, 5 June 2026
Line 5:		Line 5:
	== Enabling Chord Beats ==		== Enabling Chord Beats ==

	Chord Beats are hidden by default. Enable them in the [[~~Song Viewing \| Song Viewer~~]] settings before assigning beats to chords.		Chord Beats are hidden by default. Enable them in the [[SongViewer]] settings before assigning beats to chords.

	Open '''Settings → Song View'''.		Open '''Settings → Song View'''.

Marekpalka: /* Assigning Beats to Chords */

2026-06-05T05:59:12Z

Assigning Beats to Chords

← Older revision		Revision as of 07:59, 5 June 2026
Line 16:		Line 16:
	== Assigning Beats to Chords ==		== Assigning Beats to Chords ==

	Once Chord Beats are visible, use the [[~~Song Editor~~]] to set the duration of each chord.		Once Chord Beats are visible, use the [[SongEditor]] to set the duration of each chord.

	Open the song and tap '''Edit'''.		Open the song and tap '''Edit'''.

Marekpalka at 05:58, 5 June 2026

2026-06-05T05:58:42Z

← Older revision		Revision as of 07:58, 5 June 2026
Line 5:		Line 5:
	== Enabling Chord Beats ==		== Enabling Chord Beats ==

	Chord Beats are hidden by default. Enable them in the [[Song Viewer]] settings before assigning beats to chords.		Chord Beats are hidden by default. Enable them in the [[Song Viewing \| Song Viewer]] settings before assigning beats to chords.

	Open '''Settings → Song View'''.		Open '''Settings → Song View'''.

Marekpalka at 05:57, 5 June 2026

2026-06-05T05:57:43Z

← Older revision		Revision as of 07:57, 5 June 2026
Line 5:		Line 5:
	== Enabling Chord Beats ==		== Enabling Chord Beats ==

	Chord Beats are hidden by default. Enable them in the Song Viewer settings before assigning beats to chords.		Chord Beats are hidden by default. Enable them in the [[Song Viewer]] settings before assigning beats to chords.

	Open '''Settings → Song View'''.		Open '''Settings → Song View'''.
Line 16:		Line 16:
	== Assigning Beats to Chords ==		== Assigning Beats to Chords ==

	Once Chord Beats are visible, use the Song Editor to set the duration of each chord.		Once Chord Beats are visible, use the [[Song Editor]] to set the duration of each chord.

	Open the song and tap '''Edit'''.		Open the song and tap '''Edit'''.