TOOGS-TOOGS USER GUIDE
======================

Welcome to Toogs-Toogs, an accessible live DJ and audio performance
program designed for blind, screen-reader and low-vision users, while
remaining useful and professional for sighted DJs.

This guide explains everything about the program, step by step.  Read
the sections you need.  If you are new to the program, start at the
beginning.

This program was originally created by Yukie Nobuharu using BGT
scripting.  It has been continued, modernized, expanded and improved
by John Carlo Amog.  This is Version 2.0.1, written in Python 3 using
PySide6 / Qt 6 and a dedicated low-latency audio engine.

Copyright (c) John Carlo Amog. All rights reserved.  See LICENSE.txt.

Note for screen-reader users: Toogs-Toogs speaks every important state
change through standard Windows UI Automation notifications.  NVDA,
JAWS and Windows Narrator announce these automatically.  You do not
need to move focus around to hear what the program is doing.


CONTENTS
========

1.  What Toogs-Toogs is
2.  What Toogs-Toogs is used for
3.  Installation
4.  First launch
5.  Basic navigation
6.  The two workspaces
7.  Adding media
8.  Assigning sound effects
9.  The sound effect assignments list
10. Playing sound effects
11. Multiple simultaneous sound effects
12. Stopping sound effects
13. Sound effects volume
14. Music and background music
15. Music playback
16. The music queue
17. Loop
18. Pause
19. Stopping music
20. Removing music from the list
21. Music volume
22. Pitch control
23. Pitch-down fade behavior
24. Fade in and fade out
25. Crossfade
26. Ducking
27. Cue and preview
28. Master and monitor routing
29. Headphones and monitor output
30. Sound cards, USB interfaces and mixers
31. Virtual audio devices and online streaming
32. Input configuration
33. Output configuration
34. Audio profiles
35. Hot cue and intro/outro markers
36. Search, sorting and recently played
37. Performance mode and library/setup mode
38. Session recovery
39. Activity log
40. Backup and recovery
41. Updating the application
42. Keyboard shortcuts (complete reference)
43. The application menu bar
44. Safe shutdown
45. Song actions
46. Separate next queue
47. Hot cue points
48. Microphone
49. Talkover / ducking
50. Emergency stop
51. Audio system / backend
52. Troubleshooting
53. NVDA, JAWS and Windows Narrator operation
54. Low-vision operation


1. WHAT TOOGS-TOOGS IS
======================

Toogs-Toogs is a live performance program for DJs, podcasters,
streamers, radio hosts, theatre technicians and anyone who needs to
play sound effects and background music quickly and reliably while
performing.

The program was designed from the beginning for people who cannot see
the screen.  Everything can be done from the keyboard, and every
important change is announced aloud through your screen reader.  At
the same time, the program looks like a normal professional
application, so sighted users feel right at home.


2. WHAT TOOGS-TOOGS IS USED FOR
===============================

Toogs-Toogs is used for live audio work such as:

- Playing sound effects instantly from a soundboard.
- Playing background music during a show.
- Previewing music in your headphones before the audience hears it.
- Running a queue of songs that plays automatically.
- Adjusting the pitch, volume and fades of the music live.
- Crossfading between tracks.
- Lowering the music automatically while you talk or play effects.
- Running your sound through virtual audio devices for streaming.

Toogs-Toogs works completely offline for normal local DJ operation.
Online and streaming use is possible through your own audio routing
and virtual audio devices, but no internet connection is required for
basic playback.


3. INSTALLATION
===============

The compiled package is a folder containing Toogs-Toogs.exe plus the
files it needs to run.

1. Copy the whole Toogs-Toogs folder to your computer.
   A good place is your Documents folder or your Desktop.  You can
   put it anywhere you like.

2. To start the program, open the folder and press Enter on
   Toogs-Toogs.exe.

3. If Windows shows a SmartScreen warning the first time you run the
   program, choose "More info" and then "Run anyway".  This happens
   because the program is not digitally signed.  You only need to do
   this once.

4. The program creates its own settings files in your AppData folder.
   Nothing is installed into the Windows system folder, and no
   administrator rights are needed.

To make the program easier to start, you can create a shortcut:

1. Press the Applications key on Toogs-Toogs.exe (or press Shift+F10
   with it selected).
2. Choose "Create shortcut".
3. Move the shortcut to your Desktop or your Start menu.

Uninstalling is simply deleting the Toogs-Toogs folder.  Your
settings and music list are stored separately, so your work is not
lost when you delete the program folder.


4. FIRST LAUNCH
===============

When the program starts:

1. The audio engine connects to your default sound card.
2. Toogs-Toogs announces "Toogs-Toogs ready" and tells you how many
   sound effects and music tracks were loaded from your previous
   session.
3. The Sound Effects workspace is active.

You can start using the program right away.  There is no setup wizard.
If you have no sound card or the audio device fails, the program
announces the problem and still lets you set up your music library.


5. BASIC NAVIGATION
===================

Toogs-Toogs has two workspaces, like two separate windows:

- The Sound Effects workspace, a live soundboard.
- The Music and Background Music workspace, a track list.

To move between them:

- Press Tab to move to the next workspace.
- Press Shift+Tab to move to the previous workspace.

The screen reader announces which workspace is active, for example:

- "Sound Effects window."
- "Music and Background Music window. Track list."

Inside the Music workspace there is also a separate playback-control
area.  Tab moves between the track list and the playback controls.
The active context is always announced, so the arrow keys always do
the right thing (see section 22).

Pressing F1 at any time opens the complete User Manual, which
includes keyboard shortcuts and full documentation.


6. THE TWO WORKSPACES
=====================

SOUND EFFECTS WORKSPACE

This is your live soundboard.  It has 36 slots, one for each of these
keys:

- Number row: 1 2 3 4 5 6 7 8 9 0
- Top row: Q W E R T Y U I O P
- Home row: A S D F G H J K L
- Bottom row: Z X C V B N M

You decide which sound is on each key.  Pressing a key plays its
sound instantly.  Several sounds can play at the same time.

MUSIC WORKSPACE

This is your music list.  Tracks you add appear in a list.  You can
play, stop, queue, loop, preview and adjust the music from here.


7. ADDING MEDIA
===============

You can add two kinds of media: background music and sound effects.

1. Press Alt+P.  The Add Media menu opens.
2. Choose "Background Music / Music" to add songs.
3. Choose "Sound Effects" to add sound effects.

You can also open the Add Media menu from the File menu.

Supported audio formats include WAV, MP3, OGG, FLAC, AIFF, AAC and M4A.

ADDING MUSIC

1. Press Alt+P and choose "Background Music / Music".
2. Browse to your music folder.
3. Select one or more files and press Open.

After the files are added, Toogs-Toogs returns you to the Music
workspace - never to Sound Effects - selects the newly added track,
and announces it, for example "Music added: Song. Song, selected."
You can press Enter immediately to play it.  (If you pressed Alt+P
from the Sound Effects workspace instead, you return to the Sound
Effects workspace when the operation finishes or is cancelled.)

Each track is added to the end of the music list.  Nothing is deleted
or moved; Toogs-Toogs only remembers where your files are.  You can
add as many tracks as you like, from any folder or drive.

ADDING SOUND EFFECTS

1. Press Alt+P and choose "Sound Effects".
2. Browse to your sound effects folder.
3. Select one or more files and press Open.

You are then asked which slot to assign the sound to.  See the next
section.


8. ASSIGNING SOUND EFFECTS
==========================

When you add a sound effect, Toogs-Toogs asks you to choose a slot:

1. A dialog lists all 36 slots.
2. Press the key you want to use directly, or move through the list
   with the arrow keys and press Enter.
3. Toogs-Toogs announces your choice, for example "Key 1".

If the slot is empty, Toogs-Toogs says "Slot 1 is empty." and assigns
the sound.

If the slot already has a sound, Toogs-Toogs tells you, for example:

"Key 1 is already assigned to Applause.wav."

You then choose one of three options:

- Replace: the new sound takes over the slot.
- Choose Another Slot: go back and pick a different key.
- Cancel: do nothing.

Toogs-Toogs never overwrites an existing assignment silently.

When a sound is assigned, Toogs-Toogs loads it into memory so it can
play instantly later.  The program announces, for example:

"Applause assigned to Key 1."

To change or remove assignments later, open the assignments list
(section 9).


9. THE SOUND EFFECT ASSIGNMENTS LIST
====================================

1. Press Alt+P, or open the Edit menu and choose "Sound Effect
   Assignments".

A list shows every slot, for example:

- Key 1 - Applause - Assigned
- Key 2 - Laughter - Assigned
- Key 4 - Empty.

To clear a slot:

1. Select the slot with the arrow keys.
2. Press Delete, or press the "Clear Selected Slot" button.
3. Confirm with Yes.

Only the assignment is removed.  The sound file on your computer is
not deleted.


10. PLAYING SOUND EFFECTS
=========================

Make sure the Sound Effects workspace is active (press Tab until the
program says "Sound Effects window").

Press the key of the slot you want.  The sound plays immediately.

- If the slot is empty, the program announces "Key X is empty."
- If the sound file is missing, the program tells you.

Sound effects are loaded into memory when the program starts or when
you assign them, so there is no delay while the computer reads the
disk.


11. MULTIPLE SIMULTANEOUS SOUND EFFECTS
=======================================

You can play several sounds at once.  Pressing a new key does not stop
sounds that are already playing.

Example:

1. Press 1.  Applause starts.
2. Press Q.  An air horn starts while the applause continues.
3. Press A.  A third sound starts over the first two.

All sounds mix together.  The number of sounds that can play at the
same time is called the voice limit.  By default 16 sounds can play
simultaneously.  You can change this in the Sound Effects settings
(section 33).  If you trigger more sounds than the limit, the oldest
sound is stopped to make room for the new one.


12. STOPPING SOUND EFFECTS
==========================

Press the Right Control key to stop ALL sound effects at once.

The program announces "All sound effects stopped."

This only stops sound effects.  Music keeps playing.


13. SOUND EFFECTS VOLUME
========================

With the Sound Effects workspace active:

- Press the comma key (,) to decrease the sound effects volume by
  exactly 1 percent.
- Press the period key (.) to increase the sound effects volume by
  exactly 1 percent.

The range is 0 to 100 percent.  The program announces the new volume,
for example: "Sound Effects volume: 74 percent."


14. MUSIC AND BACKGROUND MUSIC
==============================

Press Tab until the program says "Music and Background Music window.
Track list."

Every track you add appears in the list, numbered:

1. Song A
2. Song B
3. Song C

New tracks are always added to the end.  The list is saved with your
session, so your tracks are still there next time you start the
program.

Move through the list with the Up and Down arrow keys.  The screen
reader reads each track name as you move.


15. MUSIC PLAYBACK
==================

1. Select a track with the Up and Down arrow keys.
2. Press Enter to play it.

The program announces "Playing: Song A."

FORCED NEXT: WHAT HAPPENS WHEN YOU PRESS ENTER ON ANOTHER SONG

If a song is already playing and you select another song and press
Enter, Toogs-Toogs does NOT wait for the current song to finish and
does NOT cut it off abruptly.  The new song starts IMMEDIATELY, and
the engine runs both tracks at the same time during the changeover:

- The current song fades out smoothly.
- The new song fades in smoothly.
- The two overlap during the transition, so there is no silence gap
  and no sudden loud start.

You never need to press Stop first, and the new song is never held
back by the old one - even if the old song is looping, pressing Enter
on another track always switches to it.

Example:

Song A is playing.  You select Song B and press Enter.

- With Default Fade-Out enabled: Song A fades out.
- With Default Fade-In enabled: Song B fades in.
- With both enabled: Song A fades out while Song B smoothly fades in
  over the same period - a classic DJ-style changeover.

Even when the default fades are off, the transition is never a harsh
cut: Toogs-Toogs uses a short smooth fade so nothing clicks or cracks.

Remember the difference between the two commands:

- Enter: play the selected track NOW (switches to it immediately).
- Q: queue the selected track for later, without interrupting the
  current song.

See section 24 for how to turn the default fades on and set their
durations.

The "Now playing" line at the bottom of the Music workspace shows the
current track.


16. THE MUSIC QUEUE
===================

You can build a queue of tracks that play automatically one after
another.

TO QUEUE A TRACK

1. Select a track in the list.
2. Press Q.

The program announces "Song D queued as next."

The queue is announced after every change, for example:
"Queue: 2 tracks - next: Song D."

HOW THE QUEUE PLAYS

When the current track finishes, the first track in the queue starts
automatically.  When it finishes, the next one starts, and so on.

The program announces each automatic start, for example:
"Now playing: Song D. 1 track in the queue."

If a track is already in the queue, pressing Q again announces
"Song D is already in the queue."

If you remove a queued track from the list, it is also removed from
the queue.


17. LOOP
========

Press L to loop the current track.

- Loop OFF (default): the track plays to the end and stops.
- Loop ON: when the track reaches the end, it restarts automatically
  and keeps playing.

Press L again to turn looping off.  The program announces "Loop
enabled." or "Loop disabled."

Looping also works with the queue: a looping track repeats until you
stop it or start another track.

If you have set intro and outro markers (section 35), looping repeats
the section between the markers.


18. PAUSE
=========

Press P to pause the current track.  Press P again to resume.  The
program announces "Paused." or "Resumed."

Pause keeps your place in the track.  Use S to stop completely.


19. STOPPING MUSIC
==================

Press S to stop the music immediately.  Sound effects are not
affected.  The program announces "Music stopped."

Press Shift+S to stop the music with a short reverb tail.  This
produces a natural, smooth ending instead of an abrupt cutoff.
The program announces "Music stopped with reverb tail."

Press Shift+S from the menu: Playback > Stop Music with Reverb Tail.


20. REMOVING MUSIC FROM THE LIST
================================

1. Select a track in the list.
2. Press Delete.

Toogs-Toogs removes the track from its list.  The audio file on your
computer is NEVER deleted.

- If the track is playing, it is removed from the list but playback
  continues.  Press S to stop it when you are finished.  The program
  announces "removed from the list. Playback continues."
- If the track is queued, it is also removed from the queue, and the
  program tells you.


21. MUSIC VOLUME
================

With the Music workspace active (either the track list or the playback
controls):

- Press the comma key (,) to decrease the music volume by exactly
  1 percent.
- Press the period key (.) to increase the music volume by exactly
  1 percent.

The range is 0 to 100 percent.  The program announces, for example:
"Music volume: 74 percent."

The workspace you are in decides which volume the comma and period
keys control.  In the Sound Effects workspace they change the sound
effects volume; in the Music workspace they change the music volume.


22. PITCH CONTROL
=================

Pitch lets you play a track faster and higher, or slower and lower,
without changing the original file.  This is a temporary change.

Pitch can be adjusted from either the track list or the playback
controls in the Music workspace:

1. With the Music workspace active, press Page Down to lower the
   pitch, or Page Up to raise the pitch.

2. Alternatively, press Tab to move into the playback controls and
   use Page Up / Page Down there.

Both work identically.  Arrow Up and Arrow Down always navigate
the track list and are never used for pitch.

Each press changes the pitch by one semitone by default.  You can
change the step to 0.5, 1 or 2 semitones in the settings (section 33).

The program announces every change, for example:

- "Pitch: minus 2 semitones."
- "Pitch: 0 semitones."

Examples:

- Start: pitch 0 semitones.
- Down: minus 1 semitone.
- Down: minus 2 semitones.
- Down: minus 3 semitones.
- Up: minus 2 semitones.
- Up: minus 1 semitone.
- Up: 0 semitones.  The original pitch is restored.

The pitch always returns to 0 when a new track starts.  The original
audio file is never modified.

Note: Arrow Up and Arrow Down always navigate the track list.
Pitch is controlled by Page Up and Page Down, which work from
both the track list and the playback controls.


23. PITCH-DOWN FADE BEHAVIOR
============================

Lowering the pitch a long way can be used as a DJ-style "brake"
effect.  When the pitch goes below a configurable threshold (default
minus 4 semitones), the volume gradually decreases while the pitch
keeps going down.  The effect is smooth, never an abrupt cut.

Example with the default settings:

- Pitch minus 1: normal volume.
- Pitch minus 2: normal volume.
- Pitch minus 3: normal volume.
- Pitch minus 4: volume starts to decrease.
- Pitch minus 5: volume lower.
- Pitch minus 6: volume much lower.
- Pitch minus 7: volume reaches zero and the track stops.

If you press Page Up during the effect, the pitch rises again and the
volume recovers smoothly.

All of this is configurable in the Music settings (section 33):

- Pitch step: 0.5, 1 or 2 semitones per press.
- Maximum pitch up: how far up you can go.
- Maximum pitch down: how far down you can go.
- Fade threshold: the pitch at which fading starts.
- Fade duration: how quickly the volume changes.
- Stop on pitch fade: whether the track stops when volume reaches
  zero.
- Recover on pitch up: whether pressing Page Up restores the volume.


24. FADE IN AND FADE OUT
========================

A fade-in starts a track quietly and raises the volume.  A fade-out
lowers the volume smoothly before stopping.

DEFAULT FADE-IN AND DEFAULT FADE-OUT

Toogs-Toogs has two default fade settings, each with an on/off switch
and a duration:

- Default Fade-In: when switched on, every new music track fades in
  when it starts.  This applies to normal playback, queued playback,
  forced next and automatically started tracks.
- Default Fade-Out: when switched on, every track fades out when it is
  supposed to end or transition - when the track finishes naturally,
  when you press Enter on another song (forced next), and during queue
  changes.
- Each setting has a duration you can choose: 0, 1, 2, 3, 5 or 10
  seconds (values up to 30 are accepted).  The example settings use
  3 seconds.

HOW TO TURN THEM ON AND SET THE DURATION

1. Press Alt, open the Settings menu and choose "Fade".  (Or open the
   Audio menu, choose "Audio Settings", and open the Fade tab.)
2. Tick "Default Fade-In" to fade every new track in, and set its
   duration with "Default Fade-In Duration".
3. Tick "Default Fade-Out" to fade tracks out when they end or
   transition, and set its duration with "Default Fade-Out Duration".
4. Press Apply.

The controls are standard checkboxes and duration boxes, so screen
readers announce them normally, for example "Default Fade-In,
checked" and "Default Fade-In Duration, 3 seconds."

WHAT THE SETTINGS MEAN IN PRACTICE

- Default Fade-In ON, Default Fade-Out OFF: new songs fade in.  When
  you press Enter on another song, the current song stops normally and
  the new one fades in.
- Default Fade-In OFF, Default Fade-Out ON: new songs start normally.
  When a song finishes or is replaced, the outgoing song fades out.
- Both ON: every new song fades in, every outgoing song fades out, and
  a forced next becomes a smooth crossfade between the two songs.
- Both OFF: songs start and finish normally.  A forced next still
  avoids a harsh cut with a short smooth fade, but no default fades
  are applied.

You can also set fade-in and fade-out separately for one track:

1. Select the track.
2. Open the Edit menu and choose "Track Settings".
3. Enter the fade-in and fade-out in seconds and press Save.

A per-track fade overrides the default fade for that track.  A fade-in
is applied when a track starts; a fade-out is applied when you use
Shift+S, at the end of the track, or during a transition.


25. CROSSFADE
=============

A crossfade smoothly mixes the end of one track into the beginning of
the next: the old track fades out while the new one fades in, and both
are heard together in the middle.

Crossfading is used when:

- You press Enter on a track while another is playing.
- A queued track starts after the current one finishes.

The crossfade duration is configurable: 0, 1, 2, 3, 5 or 10 seconds.
A value of 0 disables crossfading (the new track starts immediately).
The default is 2 seconds.


26. DUCKING
===========

Ducking automatically lowers the music while something else is
sounding, so your voice or your sound effects are always clear.

When ducking is on:

- The music plays at its normal volume when nothing else is sounding.
- While a sound effect plays, or while the microphone is active, the
  music is lowered by the ducking amount.
- When the sound effect ends, the music smoothly returns to its normal
  volume.

Ducking settings (Music tab of the settings):

- Ducking on/off.
- Ducking amount: how far the music is lowered (0 to 90 percent).
- Recovery time: how many seconds it takes for the music to return to
  full volume.


27. CUE AND PREVIEW
===================

Cue lets you preview a track in your headphones before the audience
hears it.  This is a standard DJ technique.

1. Select a track in the music list.
2. Press C.

The program announces "Cue preview on: Song 12. Audio routing: Monitor
only."

The selected track starts playing through the monitor/cue bus only.
The master output is not affected, so the audience hears nothing.

Press C again to turn the preview off.  The program announces "Cue
preview off."

The cue preview is separate from normal playback.  You can preview a
track while another track is playing to the audience.


28. MASTER AND MONITOR ROUTING
==============================

Toogs-Toogs has two audio buses:

- The Master bus, which goes to your main output (your speakers or
  your streaming feed).
- The Monitor bus, which goes to your headphones or monitor output.

Each cue preview is routed through one of three modes.  Press
Shift+C to cycle between them:

- "Audio routing: Monitor only."  The preview is heard only in your
  headphones.
- "Audio routing: Master and Monitor."  The preview is heard in both.
- "Audio routing: Master only."  The preview is heard by the audience.

The routing does not physically move audio between devices.  The
routing engine decides which buses receive the signal, which is how
the separation works with virtual audio devices and mixers (section
31).

Normal music and sound effects go to both the master and monitor
buses, so you always hear what the audience hears plus your previews.


29. HEADPHONES AND MONITOR OUTPUT
=================================

You can use headphones for cue previews in two ways.

USING THE SAME SOUND CARD

If your sound card has both speakers and a headphone jack, the master
and monitor signals are mixed together on the same output.  The
routing mode (section 28) decides what you hear.  For example, with
"Monitor only" cue routing, a cue preview is only audible through your
headphones if your headphones are connected to the same device but
physically separated (for example a headphone amp fed by a separate
virtual cable).

USING A SEPARATE MONITOR DEVICE

For a true DJ setup, connect your headphones to a second sound device
(a USB headset, a second interface, or a headphone amp):

1. Open the Settings menu and choose "Audio" (or open the Audio
   menu and choose "Audio Settings").
2. In the Audio tab, choose your main speakers as the "Main output
   device".
3. Choose your headphones as the "Monitor / headphone device".
4. Press Apply.

Now the monitor bus (cue previews) plays through your headphones and
the master bus plays through your speakers, completely separated.


30. SOUND CARDS, USB INTERFACES AND MIXERS
==========================================

SOUND CARDS

Toogs-Toogs uses your default sound card automatically.  You can pick
a specific device in the Audio settings.

USB AUDIO INTERFACES

Professional USB audio interfaces (for example Focusrite, Behringer,
PreSonus or Yamaha models) usually appear as their own devices in
Windows.  Choose the interface in the Audio settings for the lowest
latency and best sound quality.

If you use an interface with its own hardware mixer software, set
Toogs-Toogs to output to the interface, and use the mixer to route
the sound.

MIXERS

If you mix your sound through a physical or software mixer:

1. Route Toogs-Toogs output to the mixer channel.
2. Route your microphone to another channel.
3. Use the mixer to control what the audience hears.

Toogs-Toogs can also duck the music automatically while you talk
(section 26), which is very useful with any mixer setup.


31. VIRTUAL AUDIO DEVICES AND ONLINE STREAMING
==============================================

Toogs-Toogs does not need the internet, but you can route it into
streaming programs such as OBS, Discord, Zoom or a radio broadcast
client using virtual audio devices.

WHAT IS A VIRTUAL AUDIO DEVICE?

A virtual audio device (for example VB-CABLE, VoiceMeeter, or a
streaming software's virtual microphone) is a fake sound card.  A
program can play into it, and another program can read from it, as if
they were connected by a cable.

STREAMING SETUP

1. Install a virtual audio device such as VoiceMeeter or VB-CABLE.
2. Open Toogs-Toogs Audio settings.
3. Choose the audio system "Windows DirectSound" or "Windows WASAPI"
   (section 51), then set the main output device to the virtual
   device's input (for example "CABLE Input").
4. In your streaming program, set the audio input to the virtual
   device's output (for example "CABLE Output").
5. Optionally set the monitor device to your real headphones so you
   still hear everything yourself.

Now the audience hears exactly what plays through the master bus, and
you hear your headphones through the monitor bus.

If you want your voice on the stream too, enable the microphone
(section 32) or use the streaming program's own microphone input.


32. INPUT CONFIGURATION
=======================

Toogs-Toogs can mix your microphone into the audio.

1. Open the Settings menu and choose "Audio" (or open the Audio
   menu and choose "Audio Settings").
2. In the Audio tab, choose your microphone as the "Microphone input
   device".
3. In the Microphone tab, tick "Enable microphone input".
4. Set the microphone gain (0 to 100 percent).
5. Press Apply.

The microphone is mixed into both the master and monitor buses.  You
can mute the microphone with the "Mute microphone" option.

When the microphone is enabled and a new audio device is selected,
Toogs-Toogs restarts the audio engine automatically.  The program
announces when this happens.

Tip: combine the microphone with ducking (section 26) so the music
lowers automatically while you speak.


33. OUTPUT CONFIGURATION AND AUDIO SETTINGS
===========================================

The Settings menu is the central place for configuration.  Press Alt,
open the Settings menu, and choose the section you want; the settings
dialog opens directly on that section.  You can also open the Audio
menu and choose "Audio Settings" to reach the same dialog.

The settings dialog is a standard window with tabs.  Each tab is a
logical group:

GENERAL TAB

- Performance mode (F8).

AUDIO TAB

- Main output device: where the master sound goes.  "System default"
  uses Windows' default device.
- Monitor / headphone device: optional second device for cue previews.
- Microphone input device: the device used when the microphone is
  enabled.
- Sample rate: 44100 or 48000 Hz.  Use 44100 unless your interface
  prefers 48000.
- Buffer size: 128, 256, 512 or 1024 samples.  Smaller buffers mean
  lower latency but need a faster computer.  Start with 256.
- Audio Diagnostics: a live readout of the audio engine's health
  (see below).

MICROPHONE TAB

- Enable or mute the microphone.
- Microphone gain.

SOUND EFFECTS TAB

- Sound effects volume (0 to 100 percent).
- Maximum simultaneous sound effects (1 to 64 voices).

PLAYBACK TAB

- Music volume (0 to 100 percent).
- Pitch step in semitones.
- Maximum pitch up and down.
- Pitch-down fade threshold and duration.
- Stop on pitch fade, and recover on pitch up.

FADE TAB

- Default Fade-In on/off and duration.
- Default Fade-Out on/off and duration.

CROSSFADE TAB

- Crossfade duration in seconds.

DUCKING TAB

- Ducking on/off, amount and recovery time.

CUE AND MONITOR TAB

- The default cue preview routing mode.

ACCESSIBILITY TAB

- Interface font size (applied immediately on Apply).

PROFILES TAB

- Save, load and delete audio profiles (section 34).

After changing settings, press Apply.  Toogs-Toogs announces
"Settings applied."  Fade, ducking and font settings take effect
immediately for subsequent playback.  If the audio devices changed,
the audio engine restarts and the program tells you.

UNDERSTANDING SAMPLE RATE, BUFFER SIZE AND LATENCY

Sample rate is the number of sound samples the audio engine handles
per second (44100 or 48000).  Every file plays at its original speed,
pitch and duration: if a file uses a different sample rate from the
engine, Toogs-Toogs converts it with a high-quality resampler so it
still sounds exactly like the original.  There is no reason to change
the sample rate unless your audio interface manual specifically says
it prefers 48000 Hz.

Buffer size is the amount of audio the engine prepares ahead of time
in each block.  A smaller buffer means less delay between pressing a
key and hearing the sound (lower latency), but the computer must do
its work faster.  A larger buffer is more stable and forgiving, but
adds a little delay.

- 128: lowest latency, needs a fast computer.
- 256: the recommended default, a good balance.
- 512: more stable, a little more delay.
- 1024: the most stable, the most delay.  Use this on old or busy
  computers.

Latency is the delay between triggering a sound and hearing it.
Sound effects are preloaded into memory, so pressing a slot key
starts them immediately; the buffer size mainly affects music and
the overall system delay.

RECOMMENDED SETTINGS

- Normal DJ use: 44100 Hz, buffer 256.
- If you hear crackling or dropouts: buffer 512, then 1024.
- For the lowest trigger delay on a fast computer: buffer 128.
- If your USB interface manual says it prefers 48000 Hz: use 48000.

AUDIO DIAGNOSTICS

The Audio tab of the settings shows an "Audio Diagnostics" readout.
It tells you which devices are in use, the sample rate, the buffer
size, and whether the audio buffer has had underruns or overruns
(small gaps in the sound caused by the computer being too slow).
Press "Refresh Audio Diagnostics" to update it.

If the readout reports buffer underruns, increase the buffer size and
press Apply.  Toogs-Toogs also announces this automatically when it
detects ongoing underruns.

HOW TO TEST THE MASTER OUTPUT

1. Add a track and play it with Enter.  You should hear it at normal
   speed and pitch, with no crackling.
2. Check the volume: press period several times to make sure the
   music volume is above 0 percent.
3. If you use a mixer or an audio interface, check that the
   Toogs-Toogs channel is not muted.

HOW TO TEST THE MONITOR OUTPUT

1. Open Audio settings and set the "Monitor / headphone device" to
   your headphones.
2. Select a track and press C.  You should hear the track in the
   headphones at normal speed and pitch.
3. Press Shift+C and try the three routing modes:
   - "Monitor only": the track plays only in the headphones.
   - "Master and Monitor": the track plays in the headphones and the
     main speakers.
   - "Master only": the track plays only through the main speakers.
4. Press C again to stop the preview.


34. AUDIO PROFILES
==================

An audio profile saves your audio-related settings under a name:
devices, sample rate, buffer size, cue routing and microphone
settings.

This is useful when you use different setups, for example:

- "Home": speakers and a headset.
- "Club": a USB interface.
- "Stream": virtual audio devices for broadcasting.

TO SAVE A PROFILE

1. Set up the audio settings the way you want them.
2. Open the Profiles tab of the settings.
3. Type a name and press "Save Current Settings as Profile".

TO LOAD A PROFILE

1. Open the Profiles tab.
2. Choose the profile in the list.
3. Press "Load Selected Profile", then press Apply.

Profiles are stored with your other settings and survive restarts.


35. HOT CUE AND INTRO/OUTRO MARKERS
===================================

These markers are stored with each track and are useful for live
work.

HOT CUE

A hot cue is a memorable position inside a track.

1. Start playing the track.
2. Move to the playback controls (Tab).
3. When you reach the position you want, press H.  The program
   announces "Hot cue set at 1:23 for Song A."
4. Later, press Shift+H while the track plays to jump straight to the
   hot cue.  The program announces "Jumped to hot cue at 1:23."

INTRO AND OUTRO MARKERS

Intro and outro markers define the loop region of a track.

- Intro: where the interesting part of the track begins.
- Outro: where the interesting part ends.

TO SET THEM

1. Start playing the track.
2. Move to the playback controls.
3. At the intro position press I.  The program announces "Intro marker
   set at 0:30 for Song A."
4. At the outro position press O.  The program announces "Outro marker
   set at 3:10 for Song A."

TO CLEAR A MARKER

- Press Shift+I to clear the intro marker.
- Press Shift+O to clear the outro marker.

HOW THEY ARE USED

- When looping is enabled and both markers are set, the track loops
  between the intro and outro positions.
- When looping is disabled and an outro is set, the track fades out
  smoothly when it reaches the outro position.

You can also type exact marker positions with the Edit menu "Track
Settings" command (section 24).


36. SEARCH, SORTING AND RECENTLY PLAYED
=======================================

SEARCH

1. Press Ctrl+F in the Music workspace.
2. Type part of a track name.  The list is filtered as you type.
3. Press Escape to close the search and show the full list.

SORTING

Press F6 to cycle the sort order of the music list:

- Default order (the order you added the tracks).
- Sort by name.
- Sort by date added.

The program announces the sort order.

RECENTLY PLAYED

Open the Edit menu and choose "Recently Played".  A list shows the
tracks you played most recently.  Select one and press Enter to play
it.  This is handy when a song was played earlier in the night and the
audience wants it again.


37. PERFORMANCE MODE AND LIBRARY/SETUP MODE
===========================================

Toogs-Toogs has two working modes.

LIBRARY/SETUP MODE (default)

The full menu bar is visible, confirmations are enabled, and the
search box is available.  This is the mode for setting up your music,
assigning sound effects and changing settings.

PERFORMANCE MODE

Press F8 to toggle performance mode on or off.  The program announces
"Performance mode on." or "Performance mode off."

In performance mode:

- The search box is hidden so the screen stays uncluttered.
- The application menu bar stays available, and pressing Alt always
  opens it, so every menu command remains reachable even mid-show.
- All keyboard shortcuts keep working, so you can still do everything
  from the keyboard.

Performance mode is for the middle of a live performance.  Use
Library/Setup mode to prepare, then press F8 to perform.  All the
important announcements stay on, because accessibility is never
compromised.


38. SESSION RECOVERY
====================

Toogs-Toogs remembers your work between sessions automatically:

- Your sound effect assignments.
- Your music list.
- Your queue.
- Your per-track settings and markers.
- Your audio settings and profiles.
- Your recently played list.

When you start the program again, everything is restored and the
program tells you how many sound effects and tracks were loaded.

There is nothing to save manually.  The session is stored in your
AppData folder.


39. ACTIVITY LOG
================

Toogs-Toogs keeps a detailed log of what happened:

- When the program started and stopped.
- Tracks added, played, queued and removed.
- Sound effect assignments.
- Audio device changes.
- Settings and profile changes.

To view the log:

1. Open the View menu.
2. Choose "Activity Log".

The log is also saved as a file named activity.log inside the
Toogs-Toogs folder in your AppData.  This can be very useful when
you need help with a problem.


40. BACKUP AND RECOVERY
=======================

To back up your settings, music list and log:

1. Open the File menu.
2. Choose "Backup Session".
3. Choose a folder and press OK.

Toogs-Toogs copies your configuration, your library and your log into
that folder.  The program announces "Backup saved to...".

To recover from a backup:

1. Open the Tools menu and choose "Restore Session from Backup".
2. Choose the folder that contains your backup and press OK.
3. Toogs-Toogs copies the files back, reloads your configuration and
   library, and announces "Session restored from backup."

You can also copy the backed-up config.json and library.json into the
Toogs-Toogs folder in your AppData manually, replacing the existing
files.  Your music list and settings are restored either way.

The safest backup of all is your music and sound files themselves:
keep copies of those folders too, because Toogs-Toogs only remembers
their locations.


41. UPDATING THE APPLICATION
============================

Toogs-Toogs updates itself from filtalk.org.

- When Toogs-Toogs starts it checks quietly for a new version (you can
  turn this off in Settings, General).  You only hear something when a
  new version is available.
- Help > Check for Updates checks at any time and tells you if you
  already have the latest version.

When a new version is found, Toogs-Toogs tells you what is new and asks
whether to install it.  If you choose Yes, it downloads the update
(announcing the progress), checks that the download is complete and
undamaged, closes, replaces its files and opens again by itself.

You can also download the newest Toogs-Toogs zip from the Software
section of filtalk.org and replace the program folder with it.

Your settings and music list are stored separately in AppData, so
updating never deletes your assignments or your music list.  To be
extra safe, run a backup (section 40) before updating.


42. KEYBOARD SHORTCUTS (COMPLETE REFERENCE)
===========================================

GLOBAL

- Tab: move to the next workspace (or the next area inside the Music
  workspace).
- Shift+Tab: move to the previous workspace or area.
- Alt+P: open the Add Media menu.
- Right Control: stop all sound effects.
- F1: open the complete User Manual.
- F5: toggle Microphone ON / OFF.
- F8: toggle performance mode.
- Alt+F4: exit with safe shutdown.
- Application Key: open Song Actions menu (when a track is selected).

SOUND EFFECTS WORKSPACE

- 1,2,3,4,5,6,7,8,9,0: play the sound in that slot.
- Q,W,E,R,T,Y,U,I,O,P: play the sound in that slot.
- A,S,D,F,G,H,J,K,L: play the sound in that slot.
- Z,X,C,V,B,N,M: play the sound in that slot.
- Comma: sound effects volume down 1 percent.
- Period: sound effects volume up 1 percent.

MUSIC WORKSPACE - TRACK LIST

- Up/Down Arrow: move through the track list.
- Home/End/Page Up/Page Down: jump through the track list.
- Enter: play the selected track now.  If another song is already
  playing, this switches to the selected track immediately (forced
  next).
- S: stop the music (sound effects keep playing).
- Shift+S: stop the music with a reverb tail (smooth ending).
- Q: queue the selected track as next.
- L: toggle looping.
- C: toggle cue preview for the selected track.
- Shift+C: cycle cue routing (monitor only / master and monitor /
  master only).
- P: pause or resume.
- Delete: remove the selected track from the list.
- Page Up: increase pitch (works from track list too).
- Page Down: decrease pitch (works from track list too).
- Comma: music volume down 1 percent.
- Period: music volume up 1 percent.
- Ctrl+F: search the track list.
- F5: toggle Microphone ON / OFF.
- F6: cycle sort order.
- Application Key: open Song Actions menu.

MUSIC WORKSPACE - PLAYBACK CONTROLS

- Page Up: raise the pitch by one step.
- Page Down: lower the pitch by one step.
- H: set a hot cue at the current position.
- Shift+H: jump to the hot cue.
- I: set the intro marker at the current position.
- Shift+I: clear the intro marker.
- O: set the outro marker at the current position.
- Shift+O: clear the outro marker.
- Comma: music volume down 1 percent.
- Period: music volume up 1 percent.

All transport keys (S, Q, L, C, P and the volume keys) also work from
the playback controls.


43. THE APPLICATION MENU BAR
============================

The application menu bar is a standard Windows menu bar, fully
accessible with the keyboard and with screen readers (NVDA, JAWS and
Windows Narrator).  It is always available, even in performance mode.

The menu bar has these menus:

- File: Add Media (Alt+P), Backup Session, Exit.
- Edit: Add Background Music, Add Sound Effect, Remove Selected
  Track, Sound Effect Assignments, Recently Played, Track Settings.
- View: Sound Effects Window, Music Window, Performance Mode (F8),
  Activity Log.
- Playback: play, stop, fade stop, queue, loop, cue, cue routing,
  stop all sound effects, stop everything.
- Audio: Audio Settings, Audio Diagnostics.
- Tools: Keyboard Shortcuts (F1), Restore Session from Backup.
- Settings: General, Audio, Microphone, Sound Effects, Playback,
  Fade, Crossfade, Ducking, Cue and Monitor, Accessibility, Profiles.
  Each item opens the settings dialog directly on that section.
- Help: About.

USING THE MENU BAR WITH THE KEYBOARD

1. Press Alt.  The first menu (File) is selected and announced, for
   example "File, menu".
2. Press Left or Right Arrow to move between the menus.  The screen
   reader announces each menu name.
3. Press Down Arrow or Enter to open the selected menu.
4. Press Up or Down Arrow to move through the menu items.
5. Press Enter to activate the selected item.
6. Press Escape to close the menu and return focus to where you were.

You can also open a menu directly with Alt plus the underlined
letter, for example Alt+F opens File and Alt+S opens Settings.

OPENING SETTINGS

1. Press Alt, press Right Arrow until you reach Settings, and press
   Down Arrow or Enter.
2. The menu lists every settings section: General, Audio, Microphone,
   Sound Effects, Playback, Fade, Crossfade, Ducking, Cue and Monitor,
   Accessibility, Profiles.
3. Choose "Fade" to configure Default Fade-In and Default Fade-Out
   (section 24).  The settings dialog opens on the Fade tab.
4. Choose any other section to open the settings dialog on that tab.

The settings dialog is a normal dialog: Tab and arrow keys move
through the controls, every checkbox announces its state ("Default
Fade-In, checked" or "unchecked"), every duration box announces its
value ("Default Fade-In Duration, 3 seconds"), and Escape closes the
dialog.


44. SAFE SHUTDOWN
=================

To close the program:

1. Press Alt+F4, or use the File menu "Exit".
2. Toogs-Toogs stops the audio, saves your session and announces
   "Toogs-Toogs shutting down."

Always close the program this way.  If the power fails or the program
is closed forcefully, your session is still safe because Toogs-Toogs
saves as it goes, but a clean shutdown is best.


45. SONG ACTIONS (VERSION 2.000)
================================

When a track is selected in the Music / Background Music list, press
the Application key (also called the Menu key) to open the Song
Actions menu.

Song Actions provides:

- Play on Main Output:  Play the song through the main speakers.
- Play on Monitor / Headphones:  Preview the song on headphones only.
  The audience hears nothing.
- Add to Next Queue:  Add the song to the separate Next Queue.
- Remove from Next Queue:  Remove the song from the Next Queue.
- Monitor & Queue as Next:  Start the song on Monitor AND add it to
  the Next Queue.  The DJ can preview it, and it will play on Main
  when it reaches its position.
- Open Next Queue:  View and manage the Next Queue.
- Cue Points:  Set, preview, or play up to 4 cue points per song.
- Loop:  Toggle loop for this track.
- Delete:  Remove the track from the music list.
- Song Information:  View the track's name, file path and markers.
- Emergency Stop:  Stop ALL audio immediately (at the bottom).


46. SEPARATE NEXT QUEUE (VERSION 2.000)
=======================================

The Next Queue is separate from the main music list.  You can add
any song from anywhere in the list, in any order.  Songs in the Next
Queue play in order after the current track finishes.

To add a song to the Next Queue:
  Select the song and press the Application key.
  Choose "Add to Next Queue".

To view the Next Queue:
  Press the Application key and choose "Open Next Queue...".

The Next Queue dialog shows:
  - All songs in queue order
  - Move Up / Move Down buttons
  - Remove button
  - Play on Main button
  - Clear Queue button

The main music list order is NOT changed by the Next Queue.


47. HOT CUE POINTS (VERSION 2.000)
==================================

You can save up to 4 cue points per song.  Cue points remember exact
playback positions.

To set a cue point:
  1. Play or preview a song.
  2. Press the Application key.
  3. Choose Cue Points > Set Cue 1 Here (or 2, 3, 4).
  The current playback position is saved.

To preview a cue on Monitor/Headphones:
  Application key > Cue Points > Cue 1 > Preview on Monitor.

To play a cue on Main Output:
  Application key > Cue Points > Cue 1 > Play Cue on Main.

To clear a cue:
  Application key > Cue Points > Cue 1 > Clear Cue 1.

Cue points are saved per song and survive restarts.


48. MICROPHONE (VERSION 2.000)
==============================

To toggle the microphone ON or OFF:
  Press F5.
  The screen reader announces "Microphone ON" or "Microphone OFF".

Detailed microphone settings are in Settings > Microphone:

- Enable microphone input
- Mute microphone
- Microphone gain
- Route microphone to Main Output
- Route microphone to Monitor Output


49. TALKOVER / DUCKING (VERSION 2.000)
=======================================

When talkover is enabled, the music automatically lowers when the
microphone picks up audio, then smoothly returns when you stop
speaking.

To enable talkover:
  Open Settings > Microphone.
  Check "Enable automatic talkover".

Configure:
- Duck Level:  How low the music goes during talkover (e.g., 30%).
- Attack Time:  How quickly the music lowers (e.g., 0.1 seconds).
- Release Time:  How quickly the music returns (e.g., 0.5 seconds).


50. EMERGENCY STOP (VERSION 2.000)
==================================

Emergency Stop stops ALL audio immediately:
  - Background music
  - Monitor playback
  - Sound effects
  - Active loops
  - Reverb tails
  - Active transitions

To use Emergency Stop:
  - Application key > Emergency Stop (at the bottom of the menu)
  - Or: Playback menu > Emergency Stop

No confirmation dialog appears.  The stop is immediate.
Screen reader announces: "Emergency stop. All audio stopped."

Emergency Stop does NOT delete any songs, cue points, queue entries,
or settings.


51. AUDIO SYSTEM / BACKEND (VERSION 2.000)
==========================================

Windows offers the same sound card through several audio systems.
In Settings > Audio, choose the "Audio system" first:

- MME: the most compatible; device names longer than 31 letters are
  shortened.
- Windows DirectSound: full device names; a good choice for virtual
  audio cables.
- Windows WASAPI: the modern Windows audio system, lowest delay.
  Toogs-Toogs lets Windows convert the sample rate, so it works even
  when the card or cable runs at 48000 Hz.

The device lists then show only that audio system's devices:

- Main Output Device and Monitor Output Device list only OUTPUT
  devices (speakers, headphones, "CABLE Input").
- Microphone Input Device lists only INPUT devices (microphones,
  "CABLE Output").

The microphone runs separately from the outputs, so it may be any
input device.  "System default" uses the default device of the chosen
audio system.  If a chosen device is missing or cannot be opened,
Toogs-Toogs says so and plays through the system default instead, so
you never lose all sound.


52. TROUBLESHOOTING
===================

NO SOUND AT ALL

1. Check that your speakers are on and connected.
2. Check the Windows volume mixer: open the volume mixer and make
   sure Toogs-Toogs is not muted.
3. Open Toogs-Toogs Audio settings and check the main output device.
4. Try the system default device.
5. Try a different buffer size (256 is a good default).

THE WRONG DEVICE IS USED

1. Open the Settings menu and choose "Audio" (or the Audio menu,
   "Audio Settings").
2. In the Audio tab, choose the correct main output device.
3. Press Apply.

HEADPHONE MONITORING DOES NOT WORK

1. Check the cue routing with Shift+C: it must say "Monitor only" or
   "Master and Monitor" to hear previews in the headphones.
2. If you use a separate headphone device, check the "Monitor /
   headphone device" setting.
3. Check that your headphones are connected to the device you chose.

USB INTERFACE PROBLEMS

1. Check that the interface is switched on and recognized by Windows.
2. Choose the interface in the Audio settings.
3. If the interface uses its own driver software, update the driver.
4. Try a larger buffer size (512) if you hear crackling.

DEVICE SWITCHING WHILE THE PROGRAM RUNS

If you unplug a device while Toogs-Toogs is playing, audio may stop.
Open the Audio settings, choose the new device and press Apply.  The
program restarts the audio engine automatically.

AUDIO LATENCY (DELAY BETWEEN PRESSING A KEY AND HEARING THE SOUND)

1. Open Audio settings.
2. Choose a smaller buffer size: 128 for the lowest latency, 256 as a
   good balance.
3. If you hear crackling or dropouts, increase the buffer size
   instead: 512 or 1024.
4. Close other programs that use audio heavily.

CRACKLING OR STUTTERING

1. Increase the buffer size.
2. Close background programs.
3. Make sure your USB interface has its own power supply if it has
   one.

AUDIO SOUNDS CRACKLY OR CHOPPY

1. Open Audio settings and increase the buffer size to 512, press
   Apply, and test again.
2. If it is still crackly, try 1024.
3. Close other programs that use audio heavily.
4. If you use a USB interface, update its driver and check its power
   supply.
5. Check the Audio Diagnostics readout: if it reports underruns, a
   larger buffer is the answer.

AUDIO PLAYS TOO SLOWLY OR AT THE WRONG PITCH

1. This is almost always a device or buffer configuration issue, not
   a problem with the audio file.
2. Open Audio settings and press Apply even if you changed nothing.
   This restarts the audio engine cleanly.
3. Check the sample rate: if your interface prefers 48000 Hz, choose
   48000 and apply.
4. If the problem continues, restart Toogs-Toogs.
5. If a track plays at the wrong speed only after you used pitch
   controls, press Page Up or Page Down until the announcement says
   "0 semitones".

AUDIO SOUNDS DISTORTED OR GARBLED

1. Make sure the buffer size is not too small: try 512.
2. Check that the correct device is selected and press Apply.
3. Close background programs that could overload the computer.
4. If many sounds play together and the result sounds harsh, lower
   the sound effects volume or the music volume a little.  Toogs-
   Toogs keeps the level safe with a soft limiter, but very loud
   combinations can still sound busy.
5. Restart Toogs-Toogs.

SOUND EFFECTS HAVE A DELAY

1. Sound effects are preloaded into memory, so they should play
   instantly.
2. If you just assigned a long sound effect, the preload can take a
   moment; wait for the announcement before pressing the slot key.
3. Choose a smaller buffer size (128 or 256) for the lowest delay.

MULTIPLE SOUND EFFECTS CAUSE DROPOUTS

1. Many simultaneous sound effects need more processing power.
2. Increase the buffer size (512 or 1024).
3. If needed, reduce the maximum simultaneous sound effects in the
   Sound Effects tab of the settings.
4. Close other programs.

A TRACK WILL NOT PLAY

1. Check that the audio file still exists on your computer.
2. If it was moved or renamed, remove it from the list and add it
   again.

SOUND EFFECTS DO NOT PLAY WHEN THE MUSIC IS LOUD

This is probably ducking doing its job (section 26).  If you do not
want it, turn ducking off in the Music settings.

I NEED MORE HELP

Press F1 to open the complete User Manual inside Toogs-Toogs.
This manual explains every feature in detail.

You can also find it in the Help menu: Help > User Manual.

For technical support, open the View menu, choose "Activity Log",
and read the log.  It shows exactly what happened.  Include the log
when you ask for help.


53. NVDA, JAWS AND WINDOWS NARRATOR OPERATION
=============================================

Toogs-Toogs works with NVDA, JAWS and Windows Narrator.  There is
nothing special to install.  Start your screen reader first, then
start Toogs-Toogs.

Because Toogs-Toogs announces everything through Windows UI
Automation notifications, you hear volume changes, track names, cue
states and all other announcements automatically, even while focus is
somewhere else.

Some tips:

- Use the Tab and Shift+Tab keys to move between the workspaces, and
  inside the Music workspace between the list and the playback
  controls.
- When you need to type (for example searching or renaming), the
  search field automatically receives focus.
- If NVDA is in browse mode and the arrow keys do not control the
  music list, press NVDA+Space to switch to focus mode.
- The keyboard reference (F1) is always available.

NVDA USERS

- NVDA reads the workspace announcements and the track list natively.
- The slot keys play sounds immediately; you do not need to move
  focus to a slot.

JAWS USERS

- JAWS reads the workspace announcements and the track list natively.
- Use the virtual cursor keys on the track list as you would in any
  list.

WINDOWS NARRATOR USERS

- Narrator announces all program announcements.
- Turn on "Narrator" before starting Toogs-Toogs.


54. LOW-VISION OPERATION
========================

Toogs-Toogs uses a high-contrast dark theme with large text so it is
easy to see.

- The Sound Effects workspace shows a large grid of slot keys with
  the assigned sound names, and the word "Empty" for free slots.
- The Music workspace shows the track list, the now-playing line and
  the queue status in large text.
- The status bar at the bottom shows every announcement as text.
- Font size can be changed in Settings, Accessibility, "Interface font
  size" (applied when you press Apply).  Try 14 or 16 for larger text.

If you cannot see the screen at all, the screen-reader operation in
section 53 covers everything you need.


THANK YOU
=========

Thank you for using Toogs-Toogs.  Have a great show!

Toogs-Toogs was originally created by Yukie Nobuharu using BGT
scripting, and was continued, modernized, expanded and improved by
John Carlo Amog.

Copyright (c) John Carlo Amog. All rights reserved.
