1.. _Queue:
2
3The Queue
4=========
5
6As described in the :ref:`Overview <Queue_Overview>`, the queue is used to
7queue up songs to be played. In recent versions of Quod Libet, some new
8features have been introduced to the queue, which is described below.
9
10Ignore and Keep Songs
11---------------------
12
13With :ref:`release 4.2.0 <release-4.2.0>`, the queue was updated with
14two new checkboxes: *Ignore* and *Keep Songs*.
15
16When the *Keep Songs* checkbox is checked, songs won't be consumed from the
17queue anymore when played. In this way, the queue can function as a kind of
18temporary playlist.
19
20With the *Ignore* checkbox checked, the queue won't have priority anymore.
21This means that if a song is played from the song list, then songs from the
22song list will continue playing even if the queue is not empty.
23
24If both *Keep Songs* and *Ignore* are enabled, songs will be kept in the queue
25while one at the same time is free to switch between playing songs from the
26queue and the song list. If a song in the queue is selected, songs will keep
27playing from the queue, while if a song in the song list is selected, then
28songs from the song list will be played instead.
29
30Disable and Mode Selection
31--------------------------
32
33With :ref:`release 4.3.0 <release-4.3.0>`, the *Ignore* and *Keep Songs*
34checkboxes were replaced with a *queue disable* button and a *mode selection*
35menu.
36
37The queue can be disabled by clicking the padlock in the queue header. When
38disabled, the queue cannot be played from - but you can still add songs to it.
39
40The queue also has two different modes, that can be changed in the queue
41preferences.
42
43In the *Ephemeral* mode, the queue consumes songs as described in the
44:ref:`Overview <Queue_Overview>`. This is the default behavior.
45
46The other mode is the *Persistent* mode. In this mode, songs will be kept in
47the queue even after being played. Furthermore, the queue won't have precedence
48over the song list unless it is explicitly being played from by first
49double-clicking on a song in it. This allows switching between the queue and
50the song list without having to clear or disable the queue.
51