Guayadeque — Full Manual

Auto-generated from the Guayadeque wiki.

Guayadeque, The Linux Music Player

Source: Home.md

Guayadeque

Guayadeque is a music management program designed for all music enthusiasts. It is Full Featured Linux media player that can easily manage large collections and uses the Gstreamer media library.

Some of Guayadeque Features

For a full list of features, please see our Features page.

Installing

For instructions to how install Guayadeque, visit our Installing page.

Manual

The complete Guayadeque Music Player manual is available here.

PDF Manual

Downloadable manuals in PDF format are available in the Downloads page.

Download

To get Guayadeque, visit our Downloads page.

Some other pages that may interest you: Abouts Us, Development, Screen Shots,

Wikipedia English, Deutsch, Français, Português

Guayadeque Music Player Manual

Source: manual.md

Table of Contents

Source: features.md

Back to the Overview | Back to the Manual

Features

This page lists the many features of Guayadeque.

Supported File Types

Supported Playlist Types

Back to the Overview | Installing

Source: installing.md

Features | Preferences

Installing

You can install Guayadeque from different sources. You can install from source code directly or from your distribution package. We are going to cover only the ones we support :

From Codeberg

Why install from git? Because the git provides the most up to date version with the latest corrections and improvements made by the developer. This way you can help by testing and providing bug reports to the ongoing project. However, be aware that this is a bleeding-edge version that can sometimes introduce new bugs.

The first step we need to do is install the development tools we will use to build the executable. To do so, open a terminal and type

sudo apt-get install git build-essential cmake gettext

Once this have been installed we need to install the development dependencies needed by Guayadeque.To install them you need to run

sudo apt-get install libwxgtk3.2-dev libtag1-dev libwxsqlite3-3.2-dev libsqlite3-dev sudo apt-get install libcurl4-openssl-dev libdbus-1-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libgpod-dev libindicate-dev libflac-dev

Now we can grab the source code and start building the project. To do so run in the terminal:

cd
git clone https://github.com/thothix/guayadeque.git
cd guayadeque
./build "" -j$(nproc)
sudo make install

Note: If you want to build a debug version instead of run ./build you need to run ./buildd

From time to time you may want to update the git code to the latest version in development. To do it you must do :

cd ~/guayadeque
git pull
./build "" -j$(nproc)
sudo make install

If you want to know what changes have been done in the git repository you can do :

cd ~/guayadeque
git log

From Source Code

The process to install it from source code is almost the same as the svn method, but you have to obtain the source code from the Guayadeque downloads page and save it somewhere in your hard disk.

Once the file is on your hard disk you need to decompress the file. For that you can use

tar xfvz guayadeque-x.x.x.tar.gz

Note: Need to replace x.x.x with the correct version.

Before you can build it you need to install the dependencies. To do so just run from your command line

sudo apt-get install build-essential cmake gettext
sudo apt-get install libwxgtk3.2-dev libtagc0-dev libsqlite3-dev libcurl4-openssl-dev libdbus-1-dev
 libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libflac-dev libgpod-dev libwxsqlite3-2.8-dev

Now it is time to compile the code. To do it go to the directory where the source code was extracted and run

./build "" -j$(nproc)
sudo make install

Debian / Ubuntu

Install the build dependencies, then build from source as above. See INSTALL.md in the source tree for the exact list per release:

Ubuntu 24.04 (noble) / Linux Mint 22:

sudo apt install libgdk-pixbuf2.0-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev
 libgstreamer-plugins-good1.0-dev libwxsqlite3-3.2-dev libtag1-dev libcurl4-gnutls-dev libdbus-1-dev
 libjsoncpp-dev libicu-dev gettext cmake g++ binutils git

Debian 13 (trixie):

sudo apt install libgdk-pixbuf-2.0-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev
 gstreamer1.0-plugins-good libwxsqlite3-3.2-dev libtag-dev libcurl4-gnutls-dev libdbus-1-dev
  libjsoncpp-dev libicu-dev cmake git

Arch Linux

Guayadeque is not currently in the official Arch repositories. You have to install it from the AUR by running the following from terminal:

yaourt -S guayadeque

To install from SVN

yaourt -S guayadeque-svn

To remove Guayadeque run this in terminal

yaourt -R guayadeque

or

yaourt -R guayadeque-svn

You can find Guayadeque in the AUR here

Gentoo Linux

Guayadeque is available in the main portage tree. For installation you first have to unmask the package.

echo "media-sound/guayadeque ~*" >> /etc/portage/package.accept_keywords

Now we are ready for installation:

emerge -av guayadeque

If you want the latest SVN you first have to check if layman is already installed:

emerge -av layman

Now you can add the overlay which contains an ebuild for the SVN-version:

layman -a dauleet

Installation as above by:

emerge -av guayadeque

For IPod support add the appropriate useflag before emerging:

echo "media-sound/guayadeque ipod" >> /etc/portage/package.use

Mageia

Go to the package manager & install.

Fedora Linux

Guayadeque is available in the Fedora repositories.

OpenSuse Linux

Guayadeque is available in the OpenSuse repositories.

Now we have Guayadeque built and installed in our system. To start it go to Applications > Sound & Video > Guayadeque Music Player.

Languages

Currently, Guayadeque is translated and supports 29 languages:

Bulgarian, Catalan, Croatian, Czech, Danish, Dutch, English, French, Georgian, German, Greek, Hungarian, Icelandic, Italian, Japanese, Lithuanian, Malay, Norwegian Bokmal, Polish, Portuguese, Portuguese Brazilian, Russian, Serbian, Slovak, Spanish, Swedish, Thai, Turkish and Ukrainian.

To use them, you need to select one available language in Preferences -> General -> Languages.

From Guayadeque v0.7.6 on, unavailable locales in the system will be warned when selected.

If you need to use an unavailable language, you need to generate it in your system as shown in the next section.

How to install an unavailable language

First you need to enable the desired locales in "/etc/locale.gen".

You can edit it manually uncommenting the lines for the locales that you want to generate. Then you can generate them by running the command:

sudo locale-gen

Or you can use the command:

sudo dpkg-reconfigure locales

and select the locales you want to install/generate.

You can check which locales you currently have generated using:

locale -a

Features | Preferences

Source: preferences.md

Installing | Using Guayadeque

Preferences

When the app. starts you will get a screen like the next one:

Preferences

First of all you’ll need to edit the preferences to tell Guayadeque where your music library is. We’ll look at all the other configuration options too. In order to do this just go to the menu Library > Preferences where you can access the sections:

Installing | Using Guayadeque

Source: pref_general.md

Preferences | Installing | View

General

General Preferences

The options of this page are grouped in On Start, Behaviour and On Close. They cover how Guayadeque starts, a few behaviours of the main window and what happens when the program is closed.

On Start

Language is the language of the interface. 'Default' follows the language of your desktop; the other entries force one language. As the note beside the list says, the new language is only used after a restart. The translations are installed by the language packs of your distribution, so if the language you picked is not available a warning is shown and the program falls back to the system default language.

Show splash screen shows the start-up window with the logo while the collections are loaded. It is enabled by default.

Start minimized starts with the main window minimized in the task bar. When the system tray icon and 'Close minimizes to system tray icon' (see below) are both enabled, the main window is not shown at all and the program starts directly in the tray. It is disabled by default.

Keep daily backups: how many days of backups are kept (7 by default, from 1 to 365). It applies to the daily configuration copies and to the Layouts/Collections day snapshots in Backups (see Backups). The per-startup configuration rotation always keeps the last 7 executions.

Load default layout makes the next start ignore the saved layout and open the panels at their initial positions, which is how you recover from a layout you moved into a place you can no longer fix. The program turns the option off again when it loads the default layout, so it only happens once.

Behaviour

Prevents the system from suspending while playing audio asks the desktop, through D-Bus, not to start the screensaver and not to blank the screen while a track is being played. The request is released as soon as playback pauses or stops. It is enabled by default.

Activate system tray icon puts a Guayadeque icon in the system tray, with a menu to play, pause and stop and to show the main window again. Clicking the icon while the window is hidden brings it back. It is disabled by default.

Close minimizes to system tray icon is only available while the tray icon is active. With it, closing the main window hides it instead of ending the program, so the music keeps playing; without it, closing the window still exits. It is disabled by default.

Enqueue as default action changes what double-clicking a track does in the library, album browser, play queue and the other lists: instead of replacing the tracks being played, the tracks are added to the end of the play queue. It is disabled by default.

Drop files clear play queue (previously called 'Drop files clear playlist') clears the play queue before the files are added, so only the dropped tracks remain. When it is off, the dropped tracks are inserted in the position where you drop them. It is disabled by default.

Instant text search shows the results as soon as you type the first letters in the search box, and narrows them down while you keep typing, instead of waiting for you to start the search. Turning it off makes the search cheaper on slow machines, at the cost of having to launch it yourself. It is enabled by default.

When searching, pressing enter queues the result is only available while instant text search is on. With it, the enter key after a text search sends everything the search found to the play queue, replacing the queue or adding the tracks at its end when 'Enqueue as default action' is also on; without it, the search only selects. It is disabled by default.

Show album cover in the player shows the cover of the track being played in the player panel. Uncheck it when you already have the cover panel visible and need more room for the track information. The change applies as soon as you accept the preferences. It is enabled by default.

Show CD cover frame in the cover editor draws the CD case frame around the covers in the Cover Editor. It is enabled by default.

On Close

Save play queue on close (previously called 'Save playlist on close') saves the play queue and the track being played when Guayadeque is closed, and restores both at the next start. It is enabled by default; with it off, every start begins with an empty queue.

Ask confirmation on exit asks for confirmation before closing the program. The confirmation dialog has a 'Don't ask again' box that turns this option off. It is enabled by default.

Preferences | Installing | View

Source: pref_view.md

Preferences | General | Library

View

View

View Menu

Save Layout is a way to save and name the actual Layout.

Load Layout allows you to load and display a previously saved Layout from the list.

Delete Layout allows you to delete a previously saved Layout from the list.

The other click buttons are self explained, nevertheless you may notice that the Cover click button allows to display the Album cover on the left side of the main display, like shown on this page... if you click on this cover it will be shown full screen.

View Full Screen Cover

If you click on this full screen cover you come back to the main display.

Preferences | General | Library

Source: pref_library.md

Preferences | View | Playback

Collections

Collections Preferences

This page tells Guayadeque where your music is. The program works with one or more Collections, each one an independent library with its own folders, cover words and options, while the settings at the bottom of the page apply to all of them.

Collections is the list on the left. Use the buttons beside it to add a collection (you are asked for its name), to move the selected one up or down and to delete it; double-click a collection to rename it. Names must be unique. The collections of connected portable devices and iPods also appear in this list, but they cannot be edited here.

Deleting a collection now asks for confirmation and warns that all its data will be lost — tracks, covers, ratings, play counts and the static playlists of that collection. The delete button stays disabled while the selected collection is the only one.

Paths are the root folders of the selected collection, where all the music of that collection is. You can add as many as you need, for example different external drives. Use the buttons on the right to add a folder (chosen in a folder dialog) and to remove the selected one, and double-click a path to change it to another folder; a folder already in the list is not added twice. Leaving the mouse over the list shows the collection name, its id and the date of its last update.

Adding, removing or changing a path marks that collection to be scanned. When the preferences are closed with OK after a path was edited, Guayadeque asks 'Do you want to scan the edited collections now?'. Answering Yes rescans only the collections whose paths were edited, and No leaves the scan to be started later from the Library menu.

Words to detect covers are the words used to find the cover images in the album folders of the selected collection. An image whose file name contains one of these words is taken as a cover, and so is an image whose name carries the album name. Use the buttons to add a word, edit it (or double-click it), move it up or down and remove it; the words are stored in lower case. The first word of the list is the name used for the covers downloaded from the web or extracted from the audio files. By default the list carries 'cover', 'front' and 'folder', and a new collection copies the list of the first one.

Options holds the settings of the selected collection:

Separators between multiple artists chooses which signs inside an artist field mean that several artists are credited: &, ;, |, +, feat. and featuring. A track by 'Artist 1 & Artist 2' then appears under both artists. Only & is checked in a new configuration. A / always separates and is not in the list, because it is also the form used to join the names. The separators only decide how the library groups and lists the tracks: the artist name itself is kept exactly as the file stores it, so ticking or unticking a box does not rewrite any tag. When a box is changed, OK asks if the artists of the library should be re-split right away; answering No leaves the splitting of the existing tracks as it is until the next update or rescan of the collection, and it can be applied later by changing a box again and accepting the prompt.

Single artists lists the artist names that must stay as one artist even when they contain one of the separators, like AC/DC, Simon & Garfunkel or Earth, Wind & Fire. The comparison ignores upper and lower case. Add, edit (or double-click) and remove the names with the buttons. A name is only kept in one piece while it is in this list, so removing an entry splits it again on the next library update or rescan; the names shipped by default can all be changed or removed. The list is shared by all collections.

Write ID3v1 tag also keeps an ID3v1 tag beside the ID3v2 one when the tags of an MP3 file are saved, for very old players. When it is unchecked, an existing ID3v1 tag is removed from the file on its next save. This option also applies to all collections.

Preferences | View | Playback

Source: pref_playback.md

Preferences | Library | Crossfader

Playback

Playback Preferences

Here you set how the tracks are played and what is added to the play queue.

Play random ... when play queue is empty: when the play queue is empty and you press Play, or when the last track ends and the player asks for the next one, Guayadeque adds random music by itself instead of stopping (repeat is turned off for this). The choice to its right decides whether whole albums or single tracks are added, and the amount added is 'Tracks added each time' below, still obeying the allow and deny filters of Player Filters. It is disabled by default.

Delete played tracks from play queue removes a track from the play queue once it has been played. It is disabled by default. While it is on, 'Max played tracks kept in play queue' below is unavailable, since no played tracks are kept.

Show notifications shows a desktop notification with the cover, the track name, the length, the rating and the artist and album every time a new track starts. It is enabled by default.

Enable equalizer activates the equalizer (see Equalizer). It is enabled by default.

Enable volume and fader keeps the volume control and the crossfader in the player. Unchecking it hides both controls and takes the volume and fader processing out of the audio chain: the music then plays at full volume (adjust it in the system mixer) and the tracks are always played gapless. It is enabled by default.

Select in the library the track currently playing selects and reveals the track in the library songs panel every time the player starts a new track. It is disabled by default.

Start playing the last track starts the playback automatically when Guayadeque opens, resuming the track that was playing when it was closed (see 'Save play queue on close' in General). It is disabled by default.

Restore the last position in the track resumes the restored track from the position where it was left. The two options are independent: without autoplay, the saved position is used the first time you play the track yourself. It is disabled by default.

ReplayGain mode levels the loudness of the music, using the information stored in the files by the ReplayGain scanner. It can be 'Disabled' (the default), 'Track' to level every track by itself, or 'Album' to keep the relative loudness of the tracks of an album. Guayadeque reads this information but does not write it. The PreAmp slider (-20 to +20 dB, +6 dB by default) applies an extra gain on top of it, which is useful when the levelled music sounds too quiet. Both controls are disabled while the mode is 'Disabled'. For an in-depth explanation about ReplayGain see this document online.

The Random / Smart play modes group below controls how tracks are added by the random picks and by Smart Mode.

Minimum number of tracks to play required to add new ones (4 by default, 0 to 10) is when Guayadeque starts looking for new tracks: with 4, the search is launched when only 4 tracks are left to play in the queue. Tracks added each time (3 by default, 1 to 10) is how many tracks each smart mode query or random pick adds to the queue.

Max played tracks kept in play queue (20 by default, 0 to 999) is how many played tracks stay in the queue, so you can go back to recent tracks easily.

To keep Smart Mode from repeating itself, 'Don't repeat last ... artists or ... tracks' decides how many recently suggested artists (20 by default, up to 70) and tracks (100 by default, up to 300) are excluded from the new suggestions.

Genre similarity evaluation makes Smart Mode accept only tracks of the same genre as the seed track. Tracks or seeds without genre always pass, so untagged files are still suggested. The indented Strict evaluation option (only available with the former) requires the exact same genre; when it is unchecked sub-genres also match, so "Rock" accepts "Progressive Rock". Both options are disabled by default.

Some tracks have a long silence at the end, but most players only move to the next track when the file ends. With the Silence detector group you can make Guayadeque skip that silence. 'Skip at' enables the detector and sets the silence level (from -65 to 0 dB); 'In the last ... seconds' (45 by default, 5 to 360) limits the detection to the end of the track so the quiet parts of the music are not taken for silence. The level, the length and the seconds are disabled until 'Skip at' is checked, which is the default.

Output device is the audio output Guayadeque asks GStreamer to use: 'Automatic' (the default) lets the player pick the best available one, 'GConf Defined' uses the device configured in the desktop, and 'Alsa', 'PulseAudio', 'OSS' and 'CoreAudio' force that plugin. The text field beside the list is the device itself for these four, for example hw:1,0 for Alsa or a PulseAudio sink name. For 'Other' the field takes a GStreamer pipeline instead, which is how you use a sink that is not in the list.

Preferences | Library | Crossfader

Source: pref_crossfader.md

Preferences | Playback | Record

Crossfader

Crossfader Preferences Guayadeque can play tracks in two modes : Gapless or Crossfading

To select Gapless play mode just set the Out length option to 0

Out Length : is the time in seconds the current playing track will take to finish In Length : is the time in seconds the next track will take to be at full volume In Vol. Start : is the percentage of the volume at which the next track starts. For example, a value of 8.0 means at 80% In start : determines the point at which both songs are mixed. It gives the actual amount of overlap between tracks.

The drawing shows how the songs are mixed when cross fading.

Crossfader Drawing

Out Length determines the length of the black line, In Length controls the slope of the purple line, In Vol. Start is the height of the yellow line and In start is the length of the red line.

With 'Filter crossfade by track labels' checked, tracks carrying one of the system labels #NoCrossFade#, #NoCrossFadeIn# or #NoCrossFadeOut# skip the crossfade ramps: a track labeled itself, through its artist or through its album, fades in at full volume (#NoCrossFadeIn#), plays to the end instead of being cut early (#NoCrossFadeOut#), or both (#NoCrossFade#). The three labels come pre-registered in every library; they are system labels, so they can be assigned to tracks, artists and albums but cannot be renamed or deleted. With the crossfader disabled nothing changes and no label lookup happens. Off by default.

Preferences | Playback | Record

Source: pref_record.md

Preferences | Crossfader | AudioScrobble

Record

Record Preferences

You can record when listening to radio streams. With these options you can configure where the recordings are stored and the recording format and quality. With Split tracks on (the default) each track announced by the stream is written to its own file, named after the tags; with it off the whole recording goes to one file named after the station and the time the recording started — see Record. Also Guayadeque has a unique feature allowing to delete tracks when the length is no longer than the specified. This allows you to automatically delete the ads.

See Record for how to record a station.

Encoding mode

Choose how the recording is encoded:

The default mode is Bitrate (CBR).

Quality

Eight levels are available, from top to bottom:

The meaning of each level depends on the Encoding mode selected above.

Other options

Preferences | Crossfader | AudioScrobble

Source: pref_audioscrobble.md

Preferences | Record | Lyrics

AudioScrobble

AudioScrobble Preferences

If you have an account with either Last.fm or Libre.fm you can active Audioscrobbling from here. You’ll need to enter your Username and Password. When it is enabled, the little icon in the down right corner will show in red. If disabled it will stay in grey.

Preferences | Record | Lyrics

Source: pref_lyrics.md

Preferences | AudioScrobble | Online

Lyrics

Lyrics Preferences Here you configure where the lyrics are looked up, where the lyrics found are saved, which genres are left out and how the lyrics text is shown in the lyrics panel.

Sources is the list of places Guayadeque searches for the lyrics, in the order they are tried. Uncheck a source to disable it, and use the buttons on the right to add a new one, edit the selected source (or double-click it), move it up or down and remove it. A source can read the lyrics from the audio file itself ('Embedded'), from a lyrics file ('File'), from a command ('Command') or from an internet site ('Download'). By default the lyrics already embedded in the file are used first, and the download sources are only asked when the file has none.

Providers that answer with lyrics carrying timestamps (synced lyrics, the '.lrc' format) are shown with the '(synced)' suffix, so a timed lyric is preferred over an untimed one when both are available. LRCLIB is included in the list as a synced source.

In the source editor you set the Name, the Type, the Source (an url, a file path pattern or a command) and, for a source that answers with timed lyrics, the 'Synced Lyrics' option ('This source returns synchronized lyrics (.lrc)'). The rules that turn the downloaded page into lyrics text (Replace, Extract, Exclude and Not Found) are edited in the same dialog. The synced option is not available for the Embedded source, which returns whatever the file holds.

Targets is the list of places where the lyrics are saved after being found or edited: 'Embedded' saves them inside the audio file, 'To file' writes a text file following the pattern of the target (Artist/Album/TrackName.lyric by default) and 'Command' runs a command. A lookup saves both the timed and the plain lyrics: MP3 files keep the timed one in the synchronized lyrics field and the plain one in the standard lyrics field, the other formats keep the timed one in their lyrics tag, and the file target writes a ".lrc" file for the timed lyrics beside the ".lyric" file of the plain ones. When only the timed lyrics are found, the plain words are taken from them. While no target is enabled nothing is written, even when a lyric is found.

Disabled Genres lists genres that are skipped by the lyrics lookup, so no lyrics are searched for the tracks of these genres. Use the buttons on the right to add and remove genres; the comparison ignores upper and lower case. 'Instrumental' is included by default.

The Font is the font used to show the lyrics in the lyrics panel, and 'Align' sets the text alignment (left, center or right). The font size can also be changed from the size control in the lyrics panel toolbar, and both places keep the same value.

Auto scroll scrolls the lyrics text along while the track plays. For lyrics that carry timestamps (synced lyrics, '.lrc'), the sung line jumps in bold, centred on the panel, as it is sung. For lyrics without timestamps, the lead-in and lead-out margins — where the vocals usually are not — can be set as a percentage of the track length (up to 5 % and 10 % by default), so the scrolling fits a median song of the style being played.

Preferences | AudioScrobble | Online

Source: pref_online.md

Preferences | Lyrics | Podcasts

Online

Online Preferences

Here you can specify filters for the online services requests like cover search. This way you can make better search and get the proper results.

The Language option will be used in order to choose your language for instances in Last.fm panel. In this case if you choose Spanish, all the results will be shown first in Spanish, in case no found in your language, the application will look in English. Also this option is used in the links when you use the {lang} option.

Also you can configure the browser command used when you click in any link.

When you add radio stations there are thousands of radio stations with very low quality. With the 'Radio Minimum Allowed Bitrate' you can filter that radios and are not added. If you specify 0 all radios will be added.

Preferences | Lyrics | Podcasts

Source: pref_podcasts.md

Preferences | OnLine | Magnatune

Podcasts

Podcasts Preferences

Guayadeque allow to download, listen and manage podcasts too. In this panel you can configure this service.

You can specify the directory where you want the podcasts to be stored. How often the podcast will be updated and how or when it will be deleted.

Preferences | OnLine / Magnatune

Source: pref_magnatune.md

Preferences | podcasts | Links

Magnatune

Magnatune Preferences Here you can select which genres you want to browse thought the Magnatune panel.

Also you can specify the format of the listening streams.

If you have a Magnatune membership you can enable it selecting the membership mode and entering the credentials.

Note: Right now as the developer hasn't get any account to test the membership so the support is very limited :

without membership you may only listen to the first seconds of a selected track.

Preferences | podcasts | Links

Source: pref_links.md

Preferences | Magnatune | Commands

Links Preferences

This is one of the most interesting features this program has. It allow to search online for information about artists, albums or tracks. You can specify any links you want. Take in mind that the {lang} is replaced by the language you have configured in Online Preferences and the {text} is replaced with the info you are looking for, an artist, album, track, etc.

You can sort the links in the way you want them to appear in the contextual menu.

For example in the Last.fm panel you can select the suggest artists or albums and ask for them in Wikipedia, Google, or any other link you have added... Select yourself the options.

If you want to know how to include your own search engines here is how. As an example we'll use 7digital

1-Go to http://www.7digital.com/ 2-Make a search, for example the ramones. Look at the address bar. This is what you get:

http://www.7digital.com/Search?search=**the+ramones**&searchtype=global&submit=Search

3-See your actual search highlithed. Substitute this for {text} so you have:

http://www.7digital.com/Search?search=**{text}**&searchtype=global&submit=Search

4-Copy and paste this as another Link in Preferences and call it 7digital 5-Done!!

Preferences | Magnatune | Commands

Source: pref_commands.md

Preferences | Links | Copy To

Commands

Commands Preferences Here you can specify the commands you can run related to the music items you have selected. For example the ones that comes by default opens a nautilus browser showing the items you have selected. Open for recording as Audio cd or as Data cd the tracks you have selected, open a terminal in the directory where the tracks are, etc

You can specify all the commands you want. The data you can pass to the commands are:

{bp} Will be replaced with the albums paths {bc} Will be replaced in the commands by the first album cover file selected {tp} Will be replaced with the tracks you have selected.

Guayadeque detects your desktop (GNOME/Cinnamon/Mate, KDE/Plasma, Xfce or LXQt, falling back to GNOME) and sets the proper default commands for it.

Guayadeque can convert your files to a different format and by default it uses SoundConverter to do this. To use just right-click on any album/tracks, go down to Commands sub-menu and choose Open with SoundConverter. This programs will open and you can then choose your format and where you want to save the new tracks. This is the command Guayadeque uses:

soundconverter {tp}

But if you are a KDE user you'll prefer to use SoundKonverter. For that use the command:

soundkonverter {tp}

Here is one of my favorites: to edit cover art Guayadeque uses The Gimp through the command

gimp {bc}

And there is obviously nothing wrong with that. But Shotwell opens REALLY FAST (it doesn't open the manager, just the editor), doesn't have an awful splash screen and opens only one window (and of course is more than enough for the kind of edit you are likely to need). I do recommend you to try it. This is what you need:

shotwell {bc}

Guayadeque has his own built-in Tag Editor and is a very powerful one. But if you are missing some of the features provided by the full-blown EasyTAG you can call it easily with this command:

easytag {tp}

If you use Guayadeque Recording Capabilities you could, with the command bellow, record your streaming stations while listening to your own music. You will need Streamripper installed in your system. Note that you'll have to change the path used as an example to your own.

xterm -e streamripper {tp} -d /media/storage/Music Temp

Gprename is a full-featured files and folders batch renamer. You can use it with Guayadeque be note that the name of a file is not the same as the tag track name. Install it from your repositories and add the following command to your ever-increasing commands library:

gprename {tp}

KDE users may want to use Krename:

krename {tp}

For burning your music onto CDs GNOME users have Brasero. To produce a data CD:

brasero {tp}

To produce an audio CD:

brasero -a {tp}

For burning your music onto CDs KDE users have K3b. To produce a data CD:

k3b --data {tp}

To produce an Audio CD :

k3b --audiocd {tp}

You can delete tracks for good from within Guayadeque or just remove them from you Library database. For a bit more of fine control you have two options (you will need to have installed gvfs and gvfs-bin). The one below will send to your wastebasket the tracks you select. Note that it will only delete the tracks but not the actual folder or any other files (cue sheets, covers, etc). If you want to delete an album that is in a folder with other albums/tracks these will NOT be deleted:

gvfs-trash {tp}

This one will send to your wastebasket the entire folder where your track/album is. It is useful for people who follow the policy of one folder=one album. If the album you want to delete is in a folder with other albums/tracks this command WILL delete them all, so use with care:

gvfs-trash {bp}

Copy To

Source: pref_copyto.md

Preferences | Commands | Visualizer

Copy To

Copy To Preferences

Here you can specify the format of the names you want to use when copying files to portable devices or directories.

This is a very flexible way to organize your collection and also a very nice tool if you want to tell the program how to copy the files of your PlayList to your mobile player.

You can specify as many patters as you like and it will be under the 'Copy To' option in the context menu.

Note: The options you can use in the Copy To function have been improved. Now you can use : {a} : Artist name {a1} : Artist first letter {aa} : Album Artist {aa1} : Album Artist first letter {A} : If Album Artist is not empty Album Artist or Artist otherwise {A1} : First letter of If Album Artist is not empty Album Artist or Artist otherwise {b} : Album {b1} : Album First letter {c} : Composer {c1} : Composer first letter {d} : Disk {f} : File name {g} : Genre {g1} : Genre first letter {n} : Track Number {t} : Track Title {y} : Year

Preferences | Record | Lyrics

Source: pref_visualizer.md

Preferences | Copy To | Using Guayadeque

Visualizer

In the Visualizer page

Visualizer Preferences

you can set the preset folder (empty means automatic), the frames per second and the preset duration;

Changes apply live to the open visualizer.

Run visualizer at startup opens it automatically with the application, optionally in full screen mode. All options are off by default.

See Visualizer for how to use it.

Preferences | Copy To | Using Guayadeque

Source: using_guayadeque.md

Preferences | How Tos

Using Guayadeque

The first thing you will want to do is find your preferred layout. Guayadeque allows you to re-arrange all the elements to fit your needs. You can drag and drop pretty much any of the User Interface elements. This allows you -for example- to have it configured like this

Using Guayadeque Layout

or this

Other Guayadeque Layout

You can enable or disable most of the interface elements from the View menu. If -for example- you want to show the Vumeter you can do this by checking the option View > Vumeter or to hide it by unchecking it. The same goes for the Player Filters window or the Play Queue, the Library, Radio, ...

Once you have the elements positioned the way you want them just save the layout by going to View > Save Layout. You can have many layouts saved and switch between them at anytime. To select a previously saved layout go to View > Load Layout > Saved Layout. You can delete any saved layout from View > Delete Layout > Saved Layout.

Once you have this out of the way lets take a look at all the elements within Guayadeque.

Preferences | How Tos

Source: using_playercontrols.md

Using Guayadeque | Preferences | Equalizer

Player Controls

Using Player Controls

Whatever view you choose you will always see -and be able to use- the player controls. From here you access all the usual functions you could expect: "previous track", "play pause", "next track", "stop"... plus

The Smart Mode button Player Smart Mode Button The Crossfader button Player Crossfader Button The Equalizer button Player Equalizer Button The Volume button Player Volume Button

The volume slider Player Volume Slider By they way, a little secret is that you can control the volume by scrolling with your mouse over the volume icon!

By default the Smart Mode is on.

The Smart Play Mode is a unique and powerful feature: it populates the Play Queue with tracks from your library that are similar to the one you are listening and have not been played recently. It uses Last.fm database and its suggestions system. By default it weeds out the last 100 tracks and 20 artists played in an attempt not to be too repetitive. With the optional Genre similarity evaluation (Preferences -> Playback, off by default) it only accepts tracks of the same genre as the seed track. The Strict evaluation option (off by default, only enabled with the former) requires the exact same genre; when off, sub-genres also match.

The player shows you the relevant information on the track being played: by double-clicking on any of the different elements you select them in the library. So, when you double-click on the artist name you select this artist in the library and so on. You have the same functionality from the context menu applied to tracks in the Play Queue.

If you stop the mouse over the little cover, a bigger cover will show up so you can see it in more detail.

Double-clicking on the time will toggle time played/remaining time for the current track.

You can rate the current playing track clicking the stars from 0 to 5.

The record button Player Record Button will appear between "stop" and Smart Mode buttons only if you have Recording enabled in Preferences and you are listening to a radio station.

Using Guayadeque | Preferences | Equalizer

Source: using_equalizer.md

Using Guayadeque | Player Controls | Play Queue

Equalizer

Equalizer

The equalizer can be accessed from the Player Controls. It allows you to select pre-configured settings or create and save your own. To create your own setting just move the sliders until you are happy with the result, then give the new mix a name and press Save. You can save as many settings as you want. If you need to reset all bars to 0 you can use the reload default button. If you need to delete any setup use the Clear button.

Using Guayadeque | Player Controls | Play Queue

Source: using_playqueue.md

Using Guayadeque | Equalizer | Player Filters

Play Queue

Using Play Queue

The Play Queue shows what tracks are going to be played after the blue track already playing. In the title you can see the current track position and the total number of tracks.

You can : rearrange the tracks and move a selected one to the desired position by using the Play Queue Toolbar buttons, remove a selected track with the Play Queue Erase Button button, shuffle the list with the Play Queue Shuffle Button button, and clean the playing list with the Play Queue Clean Button button. You can rate any selected track by clicking in the rating stars.

The toolbar Select button selects the current track in the library. With Ctrl+Click it selects the artist, with Shift+Click the album and with Ctrl+Shift+Click the genre instead.

If you Right click on a track you can see the contextual menu

Play Queue Context Menu

from where you can:

Edit Labels this will allow to select labels for the current selected tracks in the label editor.

Edit Songs this will open the selected songs in the track editor.

Search this will allow to search a track in the list. Useful when you have many tracks in it.

Select this opens a submenu where you can select in library the Track, Album, Artist, Year or Genre of the track you are pointing at.

Select->Track if the track is not inside the current filtered view (e.g. a directory filter is active on another folder), reveal it. When the track folder doesn't match the current directory selection, select the first directory level matching the track (the deepest level already expanded in the tree) and filter by that directory instead of the track album.

Select->Album shares the track-selection navigation logic, but selects the album in the Albums Panel instead of the track in the Songs Panel. Like "Select->Track", the tree is only moved when the album is not already visible in the current filtered view, and it stops at the deepest directory level already expanded in the tree when the current directory is not part of the album path.

Select->Artist same reveal behaviour as SelectTrack: if a directory filter hides this artist (fully or partially), point the library at the artist's folder first. An artist spread across unrelated roots has no common prefix: reset to ROOT so every album stays visible instead of leaving the old (wrong) filter in place. Always reveal the artist's folder in the tree, even if the artist is already fully visible under the current filter.

Play Queue Select Context Menu

Custom Field replaces the rating display on the second line of the tracks with the field you choose: None, Rating, Genre, Last Played, Added, Format, Play Count or Year. The selection is saved in the configuration.

Save to Playlist this allow to save the selected tracks to a playlist.

Shuffle PlayList this will shuffle all the tracks in the playlist.

Clear PlayList this will empty the playlist.

Remove selected songs this will remove the selected tracks from the playlist.

Remove from Library this will make the selected tracks not being listed in the library anymore.

Delete from Drive this will make the selected tracks being deleted from the disk.

Copy To this allows you to copy the selected tracks to the directory or device you select.

Links this allows to select the link you have configured in preferences.

Commands this allows to select the command you have configured in preferences.

Using Guayadeque | Equalizer | Player Filters

Source: using_playerfilters.md

Using Guayadeque | Play Queue | Library

Player Filters

Using Player Filters

this filters panel appears at the bottom of the playing list

The use of filters along with the Smart Play Mode is one of the most powerful features in Guayadeque. The Smart Play Mode chooses tracks according to the ones you have in your Play Queue. The way it chooses them is defined by rules of similarity: similar track and similar artist. It uses Last.fm extensive database for this. With the Deny and Allow filter you can further characterize the music as these filters are your own playlists (dynamic or static). You could -for example- allow only Jazz music and deny tracks played more than twice in the last 3 weeks. As the way you define your own playlists can be extremely flexible you could be highly creative in producing your own streams...

Using Guayadeque | Play Queue | Library

Source: using_library.md

Using Guayadeque | Player Filters | Radio

Library

Using Library

The Library is the place where you can access all your music collection. This will be organized according to the tags applied to the files. The main Library frame is composed of smaller windows that function as filters: Search, Directory, Label, Genre, Artist, Album Artist, Album, Composer, Rating, Year and Play Count. You can have as many or as few opened as you like. From any of these windows you can drag-and-drop, double click, or choose a contextual action for the elements selected.

Selecting an item in one of these windows, filters the values in all windows below it. For example, left-clicking on an artist in the Artists window shows his albums in the Album window (filter the albums) and shows only the tracks of all artist albums in the Songs window (filters all artist songs). And after left-clicking on one of his albums shows the tracks only for this album in the Songs window (filter the songs). You can also select more than one artist, album and song in its respective window.

A track credited to more than one artist lists one row per artist in the Artists panel, and its album appears under every credited artist without being duplicated. The songs lists show the artist name exactly as the file stores it (for example Artist 1 & Artist 2); which characters separate the artists, and which names must stay in one piece, is set in Preferences → Collections and changes only the Artists list, never the name displayed or saved.

The Songs window context menu has a Select option that selects the track's album, artist, album artist, genre, year or composer in the respective library window.

Library Songs Panel - Select Options

The Song views (Library, Tree and Playlists) support sorting by multiple columns: click further column headers to add them to the sort, each showing its sort priority beside the direction arrow on it. Sorting can be disabled per column back to the natural order. Right-clicking a column header opens the ** Select Columns** dialog, where columns can be shown, hidden or reordered.

Library Songs Panel - Select Columns

The leading Play Queue column marks the tracks of the Play Queue with the play icon; the tracks already behind the one being played show a disabled (stop) icon. The icons update live as tracks are added to or removed from the queue.

Use the LEFT and RIGHT keys to scroll the grids horizontally.

Directories panel

The Directories panel shows the collection's directory tree (collection → Library → Directories). Selecting a directory filters Genres, Artists, Albums and Songs to it, and restricts the library search to the selected directory.

The top folder is now the common ancestor of all collection paths — the real folders that hold the collection are shown, without the rest of the disk — instead of a fake collection root entry that carried the collection name (before v1.1.0). Selecting the top folder still means the whole collection.

Right-clicking the collection node and choosing Update updates every directory below the root, while Force Update re-reads every file, regardless of its modification date (but it's not a rescan. To do a full rescan you need to go to Source → Collection → Rescan or use the Collection → Rescan context menu option).

The Update and Force Update commands are also available in the context menu of the Artists, Albums and Songs panels: right-click the selected item and choose Update (only new or changed files) or Force Update (every file of the selection). Only the folders of the selected artist, album or tracks are scanned, without touching other folders.

Albums panel

The Albums panel Options submenu sets the cover display (hidden, small, medium or large) and the sort order; the selections are saved per collection.

Guayadeque searches as you type, unless Instant text search is unchecked in Preferences → General; in that case the search starts when you press Enter.

With the instant search on, Enter plays the search results, or enqueues them when "When searching, pressing enter queues the result" is checked — that option is only available while the instant search is on. Enqueue as Default Action, in the same page, applies to the lists themselves: opening an item enqueues it instead of playing it.

Marking the checkbox at the right end of the search bar ignores accented characters: it removes the accents from both the search text and the songs data before comparing them, so an unaccented text also finds accented words.

Library Accented Search

These buttons Library Buttons allow to choose the display inside the Library

From left to right:

Using Guayadeque | Player Filters | Radio

Source: using_radio.md

Using Guayadeque | Library | Record

Radio

Using Radio

  1. Here is where you can access the Shoutcast radio stations.

To get started you need to update the radio stations by right-clicking over the Shoutcast entry and selecting ‘Update Radio Stations’. This will populate all the genres with the respective radio stations. You can update a particular genre from its context menu or by simply double clicking it. To add a new Genre you have to right click over the Genre option and select ‘Add Genre’. This will bring up a new window where you can select the genres you want from all the currently available genres.

If you want to delete any genre you can right click over the genre and select ‘Delete Genre’.

Guayadeque also have the ability to search into all Shoutcast radio stations for a specific artist or track. For this you need to go right click over ‘Searches’ and select ‘New Search’. The search results can be updated anytime by double clicking over it.

You can specify in which fields you want to search from the Station Name, Genre or Now Playing info but also if you want to search in all the radio stations or only the stations you have added.

Note: if you are searching in the Now Playing info this information is lagged and can bring results of previously played tracks.

Note that you can apply labels to the radio stations as you can with your music collection. This bring you all the possibilities you have with your local music but this time with radio stations. You can catalog it by many different aspects using this feature.

  1. You can access the tunein radio stations too : Same procedure as for Shoutcast

  2. You may choose to add some User Defined stations

Radios Edit

This may be useful since some radio stations stopped to accept to be in the Shoutcast or tunein databases

  1. You may import a list of radio stations (with .xml extesnion) by clicking inside the display of user defined radios

User Defined Radio

A xml file of French National Radio Stations appears inside the display

If you have updated Guayadeque from a previous version, this xml file may have not been added inside /username/.guayadeque/Radios/ Nevertheless this xml file can be found inside /usr/share/guayadeque/Radios/ and used from there. When you have imported this xml file the French National Radio Stations appears inside User Defined Radios

User Defined Radios Imported

Using Guayadeque | Library | Record

Source: using_record.md

Using Guayadeque | Radio | Last.fm

Record

Guayadeque can record the radio station you are listening to, either as one file per track or as a single file for the whole session. It is not a general purpose recorder: the Record button is only enabled while a radio station is playing.

Before using it, open Preferences → Record and tick Enable recording. That page is also where you choose the folder the files are saved to, the format (mp3, ogg or flac), the encoding mode (Bitrate/CBR or Quality/VBR), the quality and the automatic deletion of short tracks. The button only appears in the Player Controls after recording is enabled.

To start, play a radio station and click the Record button once (it sits between Stop and the play mode button). Click it again to stop. The hover text of the button always describes the next click — “Record to file” or “Stop recording” — and names the file being written.

While a recording is running:

Files and splitting. How many files a recording produces is set by Split tracks in Preferences → Record, which is on by default.

With Split tracks on, each time the stream announces a different track the file being written is closed and a new one is opened, named from the tags that came with the stream:

<Save to>/<station>/<artist> - <title>.mp3

When the stream sends no artist, the name is just the title. The files are closed properly at every split, so their length and seeking information are correct and each one can be played, tagged or moved on its own.

With Split tracks off, the whole recording is a single file, named after the station and the moment the recording started:

<Save to>/<station>/<station> YYYYMMDD-HHMMSS.mp3

For example Radio Rock 20261029-213011.mp3, so two recordings of the same station never overwrite each other. That file holds many tracks, therefore it is tagged with the station and the genre only, without an artist or a title. If the stream announces no station, the folder and the name are taken from the stream address instead.

A split takes a fraction of a second and the audio of that instant is not recorded. A split while the playback is paused ends the recording, because the stream has to be running to complete the file being closed. Neither applies when Split tracks is off.

Deleting ads. With Delete tracks shorter than set in Preferences → Record, a file shorter than the given number of seconds is deleted as soon as it is closed — a convenient way to get rid of the ads and the small jingles between the tracks.

Notes. Stopping the playback also stops the recording: the file is closed and tagged with the last information received from the stream. Recording depends on the encoders of the chosen format, MP3 comes from gstreamer1.0-plugins-ugly and OGG/FLAC from gstreamer1.0-plugins-base/good.

Using Guayadeque | Radio | Last.fm

Source: using_lastfm.md

Using Guayadeque | Record | Lyrics

Last fm

Using Last.fm

This panel shows relevant information of the current playing track taken from the last.fm website. You can access to a biography of the artist, his top albums, top tracks, etc

This can be used easily to discover new music as shows albums that you may be missing. Also shows artists that are similar to the one you are listening so if that other artist is similar likely you will like it too.

Anytime you can uncheck the ‘Follow Player’ option and type any artist, track you want to show the info. You can navigate with the back and forward buttons thought the previously showed artists.

This pane also allow to see if you are missing something or not very easily as all the items are checked in your library. If its missing t will be in light colour and normal if its found.

For every item you can right clicking over it to have the ability to play or enqueue the selected item (track or album), search using your defined links, execute a defined command, ...

Using Guayadeque | Record | Lyrics

Source: using_lyrics.md

Using Guayadeque | Last.fm | Playlists

Lyrics

Using Lyrics

The lyrics panel allows you to view or edit the lyrics of the current playing track. Like the last.fm pane you can uncheck the ‘Follow player’ and query any specific track you want.

You have the search engine selector available to change fast different engines as usually one lyric is not found in one service but it is in other.

Artist and Track fields stay editable while following the player, so a manual lookup can be retried with corrected values through the search button. When online search finds nothing, Guayadeque retries once with the song title cut at the first ‘:’ or ‘** - **’, so for example “Unicorn: Carnage and Ice” is also looked up as “Unicorn”.

Auto scroll scrolls the lyrics text along while the track plays. With synced lyrics (.lrc) the sung line is centred and shown in bold as it is sung. Without timestamps, the lead-in and lead-out margins (up to 5 s / 5 % of the track by default) let you tune a median for the style of music being played.

Using Guayadeque | Last.fm | Playlists

Source: using_playlists.md

Using Guayadeque | Lyrics | Album Browser

Playlists

Using Playlists

Guayadeque supports the creation of static and dynamic playlists.

A static playlist is a collection of songs from your library that doesn't change unless you manually add or remove tracks. You can have as many static playlists as you want and these can be as big or small as you want them to be.

A dynamic playlist is a collection of songs from your library that satisfy certain rules that you specify. It is called dynamic because the list is updated automatically. For example, you can define a list of the songs that have not been played in the last week. A song that it is on this list will be removed after it is played, but it will be added again a week later. By default Guayadeque comes with 3 dynamic playlist: Last Played Tracks, Last Added Tracks and Most Rated Tracks.

To create a static playlist right-click on any track or selection of tracks and choose Save to playlist. Give your new playlist a name. To add tracks to an existing static playlist right-click on the track/tracks and choose Save to playlist. Select the name of the playlist from the drop-down menu.

A note of caution on static playlists!!: by default Guayadeque will create automatically static playlists from m3u and other playlists formats that are found in the music folders as they are scanned. What this means is that the first time you use Guayadeque you could easily end up with a lists of hundreds if not thousands of static playlists. To avoid this you need to uncheck the option Create Playlists on library scan.

To create a dynamic playlist right-click anywhere on the playlist window on the left and choose New Dynamic Playlist. This will bring this window:

Dynamic Playlist Editor

You then choose from the drop-down menu any of the filters you would like to apply to it (label, genre, composer, rating, ...). From the next drop-down menu you choose how the previous filter is going to define the playlist: is, is not, etc. You can use as many filters as you want. Once you've done this click OK and give the new playlist a name. You can also decide how the playlist is sorted: title, artist, random, ... Add tracks on any criteria option will make the conditions to be joined by OR instead of AND. From the moment you create a dynamic playlist Guayadeque will keep it updated.

Some examples of dynamic playlists

Smart playlists

From a track's context menu (library, browser or Play Queue) you can generate a smart playlist: Guayadeque asks Last.fm for tracks similar to it and keeps the ones found in your library, honouring the Allow/Deny playlist filters and the Limit to size. The result is saved as a static playlist with the name you choose.

Best of playlists

From an artist, album or track context menu, Create Best of Playlist builds a static playlist named The best of ... with that artist's top tracks from Last.fm that exist in your library.

Using Guayadeque | Lyrics | Album Browser

Source: using_albumbrowser.md

Using Guayadeque | Playlists | File Browser

Album Browser

Using Album Browser In the Album browser you can explore your music collection using basically the covers of the albums.

Clicking the button a magnifying glass opens a filter editor similar to the Dynamic Playlist editor, where you can define what albums you want to see. The Filter button toggles the filter and also invokes the filter editor if none is defined yet.

You can find any album quickly using the search feature which searches in the Artist, Album Name and Album Artist fields.

The combo box on the right of the search field can be used to filter the albums based on pre-defined filters or you can build your own custom filter.

The Options context submenu groups the view settings. The selections are saved per collection:

Right-clicking an album cover opens its context menu. Besides Play, Enqueue and Edit Songs, it offers Update and Force Update: Update re-reads only the new or changed files of the album, while Force Update re-reads every file of the album, refreshing its tags, rating and play count (if it's embedded).

Using Guayadeque | Playlists | File Browser

Source: using_filebrowser.md

Using Guayadeque | Album Browser | Podcasts

File Browser

Using File Browser

The file browser gives you a tree view of your music collection. From the context menu you can play, enqueue, or do most of the other things you would from the Library only that instead of albums you are using folders.You can also rename, move and delete files or folders or create new ones. At the bottom of the directory the three different icons give you the choice to toggle between displaying only recording location, only podcast location, only music directory or the whole file system.

To move a whole directory without losing its library data and statistics, copy it and then choose Move Here on the target folder: the library is updated to the new location.

If you want to rename files according to your tags you can use the file renaming tool. For this you need to select, from the files panel, the directory or files to rename, right click and select ‘Rename files’. This will open them in the Track Editor's Rename Files tab.

Using Guayadeque | Album Browser | Podcasts

Source: using_podcasts.md

Using Guayadeque | File Browser | Magnatune

Podcasts

Using Podcasts

From the Podcast panel you can manage all your Podcasts easily. There are three panels by default. You can filter by channel from the Channels panel. You can see all the information of the selected channel or episode in the Details panel.

To add a new podcast channel you need to right click over the channels list box and select ‘New Channel’ so the next dialog appears. This dialog shows a list of existing podcasts from the podcast directory. You can update the podcasts list pressing the reload button at the top right corner of the window. You can filter this list with the search feature so you can search for a specific word in all the directory and shows only the channels that match your criteria.

New Podcast Channel

Once you have selected one channel to add you will edit the Channel Properties. You can specify how Guayadeque will download the episodes for you. You can specify Manually, Only if Contains or Always.

Also you can control if Guayadeque can automatically remove episodes from this channel.

Warning: As some channels can eat a lot of disk space, we recommend to avoid the use of "Download Everything". Use preferably "Download manually", unless you know what you are doing, otherwise you can run out of disk space

Pocast Channel Editor

Using Guayadeque | File Browser | Magnatune

Source: using_magnatune.md

Using Guayadeque | Podcasts | Portable Media Devices

Magnatune

Using Magnatune

Guayadeque also offers access to Magnatune’s library.

You need to have an account to Magnatune to use it !

You can configure it from the Magnatune section of Preferences. There you can select the genres you are interested in, and set up you account if you have one. You can also specify whether you prefer ogg or mp3 format.

From the menu View you can open Magnatune’s tab and select which of it components you want to see. The context menu of the Magnatune’s library provides a submenu Magnatune from where you can edit its preferences or update the database.

Using Guayadeque | Podcasts | Portable Media Devices

Source: using_portabledevices.md

Using Guayadeque | Magnatune | Track Editor

Portable Media Devices

This feature is under development right now and bring you the posibility to move music from your main library to any portable drive or player in a very easy and flexible way.

When you plug any portable media device to the computer it will show up in the Main Menu under the option View -> Portable Media Devices from where you can select it to open or close.

If you select it to open it will show a library like pane with the same features but from where you can access the properties. To access the Properties of the device you need to right click on the device pane and go to Portable Media Device -> Properties that will bring you a properties editor like

Portable Media Properties - Audio

Here you can specify the pattern you want to use when copying the files to the device using the same elements as in the Copy to options in preferences. You can specify the folder or folders where the music is located. Which audio formats your device support so Guayadeque can know when the files needs transcoding and what format is your preferred one for the transcoding.

You can select the option to ‘Keep format’ so no file is transcoded in case you want to store the files in your device even when the format is not supported. If you select to transcode you can select if you want to do it for all formats or only for the not supported ones. Also you can specify the maximum bitrate that you want the files to be with the Quality option.

Quality mp3, ogg, m4a, mwa **flac ***
Very High 320kbps 8
High 256kbps 7
Very Good 192kbps 6
Good 160kbps 5
Normal 128kbps 4
Low 96kbps 3
Very Low 64kbps 1

When transcoding is set to always it will transcode the same format only when the quality of the files being transferred are higher quality than the quality you have set in the device properties.

Portable Media Properties - Playlists

For the playlists you can specify the ‘Playlist Folder’ where the playlists will be stored and the playlist formats supported by your device.

Note: At this point this feature is not supported

Portable Media Properties - Covers

Here you can specify the formats

Note: At this point this feature is not supported

Using Guayadeque | Magnatune | Track Editor

Source: using_trackeditor.md

Using Guayadeque | Portable Media Devices | Visualizer

Track Editor

Choose a track to edit

Track Editor Menu

Guayadeque powerful editor has six different tabs:

Track Editor Details

Track Editor Rename Files

Track Editor Lyrics

The song list shows file names only and accepts multiple selection; the directory of the reference track, relative to its collection root, is shown in the field above it, and its full file name goes to the status bar. The Copy buttons apply to the selected tracks. The Save button persists the edits without closing the editor (Ctrl+S also saves). File names are shown in bold while they have changes that still need to be saved, making it clear which songs are pending. The Track Total field is also filled when numbering tracks.

Extra tags are supported depending on the format: Encoder, Encoded by, Copyright and Url are shown when the format keeps them in a field of its own (for example Opus and Ogg Vorbis files). Encoded By and Encoder are read-only fields. Audio properties (Channels and Sample Rate) are also displayed. The "Encoder" row also shows the options the file was encoded with, whenever the format keeps them in a field of its own.

Using Guayadeque | Portable Media Devices | Visualizer

Source: using_visualizer.md

Using Guayadeque | Track Editor | Backups

Visualizer

Guayadeque includes a Milkdrop visualizer (projectM, experimental).

Open it with View -> Visualizer or (F9): it shows a dockable panel that can also float. Pressing F9 again hides it.

Using Visualizer

View -> Visualizer Full Screen (Shift+F9) opens it in a dedicated fullscreen window from any state; a second press, Esc, double-click or "Exit fullscreen" in the right-click menu docks it back, while F9 from the fullscreen window closes it and hides the panel. Both shortcuts are configurable in Preferences -> Shortcuts.

Visualizer Panel

While music plays, the playback pipeline feeds real audio to the visualizer (synthetic audio is used while nothing plays). Presets play in shuffle mode with automatic switching; the canvas context menu offers next/previous preset, fullscreen and close.

A subset of 50 projectM presets is shipped with Guayadeque, so the visualizer works out of the box. It builds against libprojectM 4, 3 and 2.1 (v4 preferred when several exist). Its options live in Preferences -> Visualizer.

Wayland note

The visualizer needs a X11 display and has no support to run under Wayland unless you use XWayland. On Wayland sessions without X11, it is unavailable and its menu entries stay disabled.

Run Guayadeque with env GDK_BACKEND=x11 guayadeque to use it through XWayland. We won't force XWayland in the .desktop file so as not to degrade the whole app on Wayland (scaling/integration) or break sessions without XWayland.

Native Wayland support waits for a newer wxWidgets with EGL canvas support (version 3.4).

Using Guayadeque | Track Editor | Backups

Source: using_backups.md

Using Guayadeque | Cover Downloader | Visualizer

Backups

Guayadeque keeps automatic backups of your configuration, collections and layouts under ~/.guayadeque/Backups/. A wait notice stays on screen while the daily snapshots run.

Configuration files

Every startup saves a per-execution copy (guayadeque.exec-YYYYMMDD-HHMMSS.conf, the last 7 startups) plus one daily copy (guayadeque.daily-YYYYMMDD.conf). If the main configuration file is missing or corrupt, the newest valid backup is restored automatically, and saves are atomic (temporary file plus rename).

Layouts and collections

At most once per day, the Layouts folder is snapshotted to Backups/Layouts/YYYYMMDD/ and the Collections folder to Backups/Collections/YYYYMMDD/, keeping the relative tree with each database compressed as *.db.tar.gz. These are backup-only copies; nothing is ever restored from them automatically.

Preferences -> General -> Keep daily backups (7 by default) sets how many daily copies and day snapshots are kept; the per-execution rotation always keeps the last 7.

Using Guayadeque | Cover Downloader | Visualizer

Source: using_coverdownloader.md

Using Guayadeque

Cover Downloader

Cover Downloader

From Albums context menu or from the Songs Editor you can invoke the Cover Editor to search the album cover on the Web. In the Cover Editor you can redefine the name of the artist or the album name to make refine the search. You can select the online cover search engine (Apple or Last.fm). The Search again button repeats the cover search with the current texts (same as pressing Enter in them).

Once you have found a cover you like, to save it you can double click it or press ‘OK’. If the Cover Editor was invoked from the context menu, the cover will be saved on the album directory using as name the first entry on ‘Words to detect covers’ from the Library section of the Preferences. But If it was invoked from the Track editor, it will be embedded into the file instead.

Label Editor

Source: using_labeleditor.md

Using Guayadeque | Cover Downloader | Save to Playlist

Label Editor

Using Label Editor

Labels are general purpose tags that allow you to filter your collection in a very flexible way. A label is like the genre of a track but you can set as many labels as you want to any track, album or artist. For example you can have labels for Live Music, Female Singer, Ballad, Oldies, Favourites, 80s, ... You can have a track with all those labels.

In the library you can use the Labels list box to filter all the songs with a particular label. Labels can also be used to define playlists and filters. For instance, suppose there are songs that you don’t want to be played on Smart Mode or added randomly when the playlist is empty, if you have those options enabled. Then you can add a label to those songs, then create a dynamic playlist of the songs with that label and choose that list in the Deny filter.

From the label editor you can set a label to a Track, Artist or Album. From it you can create new labels using the + or delete it using - buttons. At the left panel you will see all elements you selected to apply the labels. You can set the labels to each element individually but if you prefer to set the same labels to all the elements you can just set the appropriate selection and then press the Replace button and all elements will get the same label selection, or the Merge button to add the checked labels to every item without removing the labels they already have.

The #NoCrossFade#, #NoCrossFadeIn# and #NoCrossFadeOut# labels are system labels used by the crossfader label filter: they can be assigned to any item but cannot be renamed or deleted. They are hidden from the list unless you check Show system labels (which follows the crossfader option by default).

Using Guayadeque | Cover Downloader | Save to Playlist

Source: using_savetoplaylist.md

Using Guayadeque | Label Editor | How-Tos

Save to Playlist

Using Save to Playlist

The save to Play List dialog allow you to save a selection of tracks and add it to a new or existing Play List. You have the option to type the new Play List name or select from the list any of the already existing ones. Also you can select the position of the new tracks to be added. It can be on top or at the bottom of the playlist.

Using Guayadeque | Label Editor | How Tos

Source: howtos.md

Using Guayadeque | Save to Playlist | About Us

How Tos

In this section there's some documentation for specific subjects about configuration, troubleshooting and other import informations.

Using Guayadeque

Using Guayadeque | Save to Playlist | About Us

Source: multimediakeys.md

Back to the Manual

Multimedia Keys

Guayadeque supports multimedia keys out of the box. Refer to the documentation of your distribution/desktop Environment for instructions on how to set up your multimedia keys and keyboard shortcuts. Normally this can be easily done via GUI in Gnome or KDE.

Ubuntu: https://help.ubuntu.com/community/KeyTouch ArchLinux: https://wiki.archlinux.org/index.php/Extra_Keyboard_Keys Gentoo: http://en.gentoo-wiki.com/wiki/Multimedia_Keys (instructions for different desktop environments)

You can also define the actions for your multimedia keys independently via xbindkeys. Instructions on how to set up xbindkeys can be found here:

https://help.ubuntu.com/community/KeyboardShortcuts#Text_Entry_Shortcuts https://wiki.archlinux.org/index.php/Xbindkeys http://en.gentoo-wiki.com/wiki/Multimedia_Keys#Non_window_manager_specific_-_xbindkeys

If you use this approach you need to specify the appropriate dbus-commands as follows...

Either rewinds to the beginning of the track (if playing) or starts playing:

dbus-send --print-reply --type=method_call --dest=org.mpris.guayadeque /Player org.freedesktop.MediaPlayer.Play

Pause or unpause:

dbus-send --print-reply --type=method_call --dest=org.mpris.guayadeque /Player org.freedesktop.MediaPlayer.Pause

self-explaining:

dbus-send --print-reply --type=method_call --dest=org.mpris.guayadeque /Player org.freedesktop.MediaPlayer.Stop
dbus-send --print-reply --type=method_call --dest=org.mpris.guayadeque /Player org.freedesktop.MediaPlayer.Next
dbus-send --print-reply --type=method_call --dest=org.mpris.guayadeque /Player org.freedesktop.MediaPlayer.Prev

It is also possible to change the guayadeque-volume with hotkeys (not the system volume). We need some custom scripts for that:

volumeplus.sh

#!/bin/bash
a=$(echo $(dbus-send --print-reply --type=method_call --dest=org.mpris.guayadeque /Player org.freedesktop.MediaPlayer.VolumeGet) | awk '{print $8}')
b=$(($a+8))
dbus-send --print-reply --type=method_call --dest=org.mpris.guayadeque /Player org.freedesktop.MediaPlayer.VolumeSet int32:$b

volumeminus.sh

#!/bin/bash
a=$(echo $(dbus-send --print-reply --type=method_call --dest=org.mpris.guayadeque /Player org.freedesktop.MediaPlayer.VolumeGet) | awk '{print $8}')
b=$(($a-8))
dbus-send --print-reply --type=method_call --dest=org.mpris.guayadeque /Player org.freedesktop.MediaPlayer.VolumeSet int32:$b

This will increase/lower volume by 8%. Now we can bind those scripts with xbindkeys to any hotkey.

Another feature someone could think of is an application-key which will start guayadeque or minimize/maximize it depending on the window-state; all with a single key. This can be achieved with a simple python-script: click here

Copy the code to a file like "guayadequetoggle.py", make it executable and bind it to a key via the configuration-tools of your desktop environment or xbindkeys. To use it for another application you just have to change line 15 and 29. Keep in mind that you need the appropriate python bindings. For me libwnck-python was missing. Because this script just reads the titles of any given window, names can be ambigous. Sometimes it helps to change line 15 to something like this:

if window.get_name().endswith('Mozilla Firefox'):

Here is an example of an ~/.xbindkeysrc file with guayadeque-hotkeys defined:

// Guayadeque hotkeys
// Pause/Play
"dbus-send --print-reply --type=method_call --dest=org.mpris.guayadeque /Player org.freedesktop.MediaPlayer.Pause"
	m:0x10 + c:172
// previous track
"dbus-send --print-reply --type=method_call --dest=org.mpris.guayadeque /Player org.freedesktop.MediaPlayer.Prev"
	m:0x10 + c:173
// next track
"dbus-send --print-reply --type=method_call --dest=org.mpris.guayadeque /Player org.freedesktop.MediaPlayer.Next"
	m:0x10 + c:171
// increase guayadeque-volume
"exec /home/jule/.volumeplus.sh"
	m:0x10 + c:86
// decrease guayadeque-volume
"exec /home/jule/.volumeminus.sh"
	m:0x10 + c:82
// toggle/start guayadeque
"exec /home/jule/.guayadequetoggle.py"
        m:0x10 + c:81

Back to the Manual

Source: backtrace.md

Back to the Manual

Getting a Backtrace

If you need to get a backtrace you must compile guayadeque from codeberg, see the instructions above, But once you have the code to be compiled you need to do

cd guayadeque
./buildd "" -j$(nproc)
gdb ./guayadeque
from gdb type run [enter]

This will compile guayadeque with debug information and will run it from console being debuged using the debuger gdb Once you get the crash at some point you must get back to the console and type

bt

and this will show a few lines of code calls and numbers. This is the information you need to post on the discussion forums for support.

Source: aboutus.md

How Tos | Development

About Us

Guayadeque started on August 2008 and went into public early 2009. Since then has gained a large user base and strong community. Guayadeque is slowly becoming the preferred media player for the Linux operating system.

What does Guayadeque Mean?

Guayadeque is, beside a Linux Music Player, a ravine on the Canary island in Gran Canaria. See this wikipedia page for more information.

The Team

Standing on the Shoulders of Giants

Guayadeque is a part of the FOSS movement, we respect and acknowledge every contribution to this movement, even if it consists of different ideas and pathways to achieve common goals. With that said, guayadeque would like to thank the giants that make the media player you've grown to love possible

How Tos | Development

Source: development.md

About Us | Guayadeque Donors

Development

Currently we are using Codeberg to host the Guayadeque development project:

codeberg.org/thothix/guayadeque

About Us | Guayadeque Donors

Source: donors.md

Development | Downloads

Guayadeque Donors

Thanks to whom contributed with a donation to Thothix recently!

And thanks to the first who contributed with a donation to Anonbeat for this project:

And all the rest that decided to not appear in this list.

If you love Guayadeque, and want to ensure it continues to be developed, please show your gratitude by making a meaningful donation. You can contribute directly via Paypal to thothix@protonmail.com.

Development | Downloads

Source: downloads.md

Guayadeque Donors | Screenshots

Downloads

Get Guayadeque

You can visit Codeberg for the releases page.

For install instructions please see the Guayadeque Installation in the Manual.

If you know of packages for other distributions and want them to appear here please open an issue so we can add it. Thanks.

PDF Manual

You can download the current manual (v1.1.0) in pdf format here

Guayadeque Donors | Screenshots

Source: screenshots.md

Downloads | Back to the Overview

Screenshots

1.0.2

Library

Guayadeque Library

Albumbrowser

Guayadeque Album Browser

Treeview

Guayadeque Treeview

Playlists

Guayadeque Playlist

Downloads | Back to the Overview