Text Window has four configuration sections:

Window
Text
Context Menu
Frozen Mode

 

Window

Enable text window  - Check this box to enable the text window.
 
Borderless  - Check this box to display the text window as a borderless window. When the window is borderless, it cannot be resized by dragging its edges.
 
Start buttonized  - If checked, window will start in its buttonized state when Now Playing is first loaded.
 
Hide when not playing  - If checked, the text window will be hidden when QCD is not playing. If gray, the text window will be hidden when the playlist is empty.
 
Auto resize to text  - If checked, the text window will be automatically resized to fit the displayed text. The text will scroll (if scrolling is enabled) if the displayed text is wider than the maximum value, or if the active window (plus the left margin and distance from active window right) is smaller than the text width. The window will not be shown if its designated size is smaller than the minimum value, or if the active window is too small to fit the text and scrolling is disabled. Note 1: to avoid constant (and annoying) window resizing, auto resize changes window dimensions only when text string length changes (for instance, at track change). Note 2: if the active window is the text window itself or the taskbar when auto resizing is needed, the window will resize only when focus changes. 
 
Width & height  - Window dimensions.
 
Color  - Window background color.
 
Distance from active...  - The text window stays "glued" to the active window by maintaining a constant distance from its top right corner. These settings define distance from top and from right.
 
Buttonized width & color  - Window width and color when it is buttonized (buttonizing the window is done by double-clicking it).
 
Left margin  - Minimum distance the window will keep from the active window left, thus stopping the text window from following small windows such as dialog boxes. If the active window is smaller than left margin + width + distance from active window right, the text window will not be shown. In "auto resize" mode, active window must be smaller than left margin + min. width + distance from active window right for the text window not to be shown. 
 
Use default position  - If this box is checked, the text window will be placed in the default position (in regular mode only), in some cases where it would otherwise be hidden: when the active window is too small for the text window, or when there is no active window. The position is determined by the X,Y settings, where X is the left or right edge (as determined by the "anchor" setting) and Y is the top edge. The default position can be set here or via the right-click menu, where pressing "set default position" sets the current window position as the default position.

 

Text

Text properties button  - This button opens a dialog box for selecting font, size and style.
 
Color  - Text color.
 
Text alignment  - Text alignment in window.
 
Scroll  - Checked: always scroll; unchecked: never scroll; gray: auto scroll.
 
Scroll speed  - Speed of scrolling text, from 1 to 50. Note: from a certain speed value and up, there may be no difference in scroll speed when the value is changed; this is because the time it takes to process the text window (depends on processor power, RAM and display adapter) may be greater then the desired speed.
 
Vertical offset  - If the text appears too low or too high in the window, this setting (in pixels) allows for proper vertical positioning. A positive value raises the text, while a negative value lowers the text.
 
Text strings  - If enable text window is checked, these are the strings that will be displayed in the text window for each media type, and for all media types when stopped. The "playing" strings are also used for QuickTrack.

Many tags can be used to display real time data from QCD:

%art - artist
%aar - album artist1  [v2.0 and up]
%uta - unique track artist1  [v2.0 and up]
%alb - album
%trk - track
%fmt - format

%srt - sample rate (Hz)  [v2.0 and up]
%srk - sample rate (kHz)  [v2.0 and up]
%brt - bitrate (kbps)  [v2.0 and up]
%chn - mono/stereo/x-channel  [v2.0 and up]

%num - track number
%ptr - playlist tracks

%tet - track elapsed time
%trt - track remaining time
%ttt - track total time
%pet - playlist elapsed time
%prt - playlist remaining time
%ptt - playlist total time
%dst - display time

%cn* - conditional2  [v2.0 and up]
%qts - QuickTrack stop/start3  [v2.0 and up]

 
1 %aar displays artist name only if the playlist does not include various artists, otherwise an empty string. %uta displays artist name only if the playlist does include various artists, otherwise an empty string.
 
2 The '*' can be replaced with any character; whenever this tag is encountered, Now Playing checks the two adjacent tags (while skipping other conditionals), and only if both are not empty strings, the aforementioned character is displayed. If there is no tag in a certain direction, the character will be printed if the other direction has a non-empty string. If there are no other tags, the character will be printed.
 
3 The playing strings are used for the QuickTrack in addition to their use as templates for the text window. Sometimes we will not want all the text window info to appear in QuickTrack (for example, bitrate, which cannot be computed for tracks other than current). The %qts tag can appear twice in each playing string, and anything in between (including the %qts tag itself) will be ignored when processing for QuickTrack. If only one %qts tag is used in a string, processing for QuickTrack will stop at that point.


 Context menu

This section determines properties of the text window context (right-click) menu.
QuickTrack formatting is based on the "playing" strings.
The qLib link opens the qLib Track Editor, if the qLib plugin exists on the system.

 

Frozen mode

Freeze window position  - Check this box to freeze the text window in its current position, so it doesn't follow the active window; the window can still be dragged around the screen. This setting affects when the window is visible (see the overview page).
 
Snap to desktop  - When moving the window by dragging it with the left mouse button, the window will "snap" to the edges of the desktop as it is approached. The setting determines the maximum distance between the text window and the desktop for the window to be "snapped".
 
Anchor  - This setting determines which edge of the text window remains static during auto resize and buttonize (double-clicking). This setting is only relevant in frozen mode and when default position is being used, since when following active window, the anchor is always the right edge.
 
Always on top  - Check this box for the text window to be always on top, even when QCD is not. When QCD is always on top or when text window is not frozen, the text window will always be on top regardless of this setting.

 

General buttons

Defaults  - Fill all dialog fields with their default values (this does not save the values; OK or apply must be pressed afterwards).
 
Web Help  - Open Now Playing web help in the default browser.
 
Cancel  - Discard changes and close dialog.
 
Apply  - Accept changes and leave dialog open (pressing cancel afterwards will not undo these changes).
 
OK  - Accept changes and close dialog.