<chapter id="advanced-features"><title>Advanced Amarok features</title><sect1 id="keybd-shortcuts"><title>Keyboard Shortcuts</title><para>&amarok; uses keyboard shortcuts like most other applications, below is a listing of those shortcuts and there respective actions. The global shortcuts can be configured by right clicking the Player window and selecting <guimenuitem>Configure Global Shortcuts...</guimenuitem> The &amarok; shortcuts can be configured by right clicking the Player window and selecting <guimenuitem>Configure Shortcuts...</guimenuitem></para><tip><para>You can assign you multimedia keys to work as &amarok; shortcuts making your keyboard an &amarok; control center.</para></tip><para>The global shortcuts are:</para><informaltable><tgroup cols="2"><thead><row><entry>Key Combination</entry><entry>Action</entry></row></thead><tbody><row><entry><keycombo><keycap>Win</keycap><keycap>X</keycap></keycombo></entry><entry>Play</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>C</keycap></keycombo></entry><entry>Pause</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>V</keycap></keycombo></entry><entry>Stop</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>B</keycap></keycombo></entry><entry>Next Track</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>Z</keycap></keycombo></entry><entry>Previous Track</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>KP_Add</keycap></keycombo></entry><entry>Increase Volume</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>KP_Subtract</keycap></keycombo></entry><entry>Decrease Volume</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>Shift</keycap><keycap>KP_Add</keycap></keycombo></entry><entry>Seek Forward</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>Shift</keycap><keycap>KP_Subtract</keycap></keycombo></entry><entry>Seek Backward</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>A</keycap></keycombo></entry><entry>Add Media</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>P</keycap></keycombo></entry><entry>Toggle Playlist</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>O</keycap></keycombo></entry><entry>Show OSD</entry></row><row><entry><keycombo><keycap>Win</keycap><keycap>M</keycap></keycombo></entry><entry>Mute Volume</entry></row></tbody></tgroup></informaltable><para>The &amarok; shortcuts are:</para><informaltable><tgroup cols="2"><thead><row><entry>Key Combination</entry><entry>Action</entry></row></thead><tbody><row><entry><keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo></entry><entry>Copy</entry></row><row><entry><keycombo><keycap>Ctrl</keycap><keycap>KP_Enter</keycap></keycombo></entry><entry>Goto Current</entry></row><row><entry><keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo></entry><entry>Queue Selected Tracks</entry></row><row><entry><keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo></entry><entry>Quit</entry></row><row><entry><keycombo><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>Z</keycap></keycombo></entry><entry>Redo</entry></row><row><entry><keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo></entry><entry>Save Playlist</entry></row><row><entry><keycombo><keycap>Ctrl</keycap><keycap>A</keycap></keycombo></entry><entry>Select All</entry></row><row><entry><keycombo><keycap>Ctrl</keycap><keycap>M</keycap></keycombo></entry><entry>Show Menubar</entry></row><row><entry><keycombo><keycap>Ctrl</keycap><keycap>H</keycap></keycombo></entry><entry>Shuffle</entry></row><row><entry><keycombo><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo></entry><entry>Undo</entry></row></tbody></tgroup></informaltable><para>The Playlist Browser shortcuts are:</para><informaltable><tgroup cols="2"><thead><row><entry>Key Combination</entry><entry>Action</entry></row></thead><tbody><row><entry><keycap>Space</keycap></entry><entry>Load Playlist</entry></row><row><entry><keycap>F2</keycap></entry><entry>Rename Playlist</entry></row><row><entry><keycap>Backspace</keycap></entry><entry>Remove Playlist</entry></row></tbody></tgroup></informaltable></sect1><sect1 id="the-dcop-interface"><title>The DCOP Interface</title><para>The Amarok DCOP interface provides you with an easy way to control Amarok with your own custom scripts.</para><para>The DCOP interface for Amarok has many generic calls that may be found in other KDE applications. This section is divided into six tables and is intended to describe the DCOP calls of the collection, contextbrowser, player, playlist, playlistbrowser and scripts. An example of the <quote>pause</quote> dcop call would look like:</para><para><prompt>&percnt;</prompt>dcop amarok player pause</para><sect2 id="dcop-collection"><title>dcop amarok collection</title><informaltable><tgroup cols="2"><thead><row><entry>DCOP Call</entry><entry>Action</entry></row></thead><tbody><row><entry>int totalAlbums()</entry><entry>Returns the total of albums in the collection.</entry></row><row><entry>int totalArtists()</entry><entry>Returns the total of artists in the collection.</entry></row><row><entry>int totalCompilations()</entry><entry>Returns the total of compilations in the collection.</entry></row><row><entry>int totalGenres()</entry><entry>Returns the total of genres in the collection.</entry></row><row><entry>int totalTracks()</entry><entry>Returns the total of tracks in the collection.</entry></row><row><entry>QString query( QString sql)</entry><entry>Queries the database via SQL.</entry></row><row><entry>QStringList similarArtists( int artists )</entry><entry>Return similar artists of the current tracks, limit to int artists.</entry></row><row><entry>void migrateFile( QString oldURL, QString newURL )</entry><entry>Move a file in the collection, keeping stats intact.</entry></row><row><entry>void scanCollection()</entry><entry>Scan the collection.</entry></row><row><entry>void scanCollectionChanges()</entry><entry>Scan the collection for changes only.</entry></row></tbody></tgroup></informaltable></sect2><sect2 id="dcop-context"><title>dcop amarok contextbrowser</title><informaltable><tgroup cols="2"><thead><row><entry>DCOP Call</entry><entry>Action</entry></row></thead><tbody><row><entry>void showCurrentTrack()</entry><entry>Show the current track in the context browser.</entry></row><row><entry>void showLyrics()</entry><entry>Show the lyrics tab in the context browser.</entry></row><row><entry>void showWiki()</entry><entry>Show the wikipedia tab in the context browser.</entry></row></tbody></tgroup></informaltable></sect2><sect2 id="dcop-player"><title>dcop amarok player</title><informaltable><tgroup cols="2"><thead><row><entry>DCOP Call</entry><entry>Action</entry></row></thead><tbody><row><entry>bool dynamicModeStatus()</entry><entry>Return dynamic mode status.</entry></row><row><entry>bool equalizerEnabled()</entry><entry>Return the equalizer status.</entry></row><row><entry>bool isPlaying()</entry><entry>Return true if something is playing now.</entry></row><row><entry>bool randomModeStatus()</entry><entry>Return random mode status.</entry></row><row><entry>bool repeatPlaylistStatus()</entry><entry>Return repeat playlist status.</entry></row><row><entry>bool repeatTrackStatus()</entry><entry>Return repeat track status.</entry></row><row><entry>int getVolume()</entry><entry>Return volume in range 0-100%.</entry></row><row><entry>int sampleRate()</entry><entry>Return the sample rate of the currently playing track.</entry></row><row><entry>int score()</entry><entry>Return the score of the currently playing track.</entry></row><row><entry>int status()</entry><entry>Return playback status: 0 - stopped, 1 - paused, 2 - playing.</entry></row><row><entry>int trackCurrentTime()</entry><entry>Return current play position in seconds.</entry></row><row><entry>int trackPlayCounter()</entry><entry>Return play counter for current song.</entry></row><row><entry>int trackTotalTime()</entry><entry>Return track length in seconds.</entry></row><row><entry>QString album()</entry><entry>Return the album of the currently playing track.</entry></row><row><entry>QString artist()</entry><entry>Return the artist of the currently playing track.</entry></row><row><entry>QString bitrate()</entry><entry>Return the bitrate of the currently playing track (XX kbps).</entry></row><row><entry>QString comment()</entry><entry>Return the comment of the currently playing track.</entry></row><row><entry>QString coverImage()</entry><entry>Return the encoded URL of the current track's cover image </entry></row><row><entry>QString currentTime()</entry><entry>Return the position of the currently playing track ([h:]mm:ss format).</entry></row><row><entry>QString encodedURL()</entry><entry>Return the encoded URL of the currently playing track.</entry></row><row><entry>QString engine()</entry><entry>Return the current sound engine.</entry></row><row><entry>QString genre()</entry><entry>Return the genre of the currently playing track.</entry></row><row><entry>QString lyrics()</entry><entry>Return the lyrics of the currently playing track.</entry></row><row><entry>QString lyricsByPath( QString path )</entry><entry>Return the lyrics of a track by path.</entry></row><row><entry>QString nowPlaying()</entry><entry>The title of now playing media.</entry></row><row><entry>QString path()</entry><entry>Return the unencoded path of the currently playing track.</entry></row><row><entry>QString setContextStyle( QString )</entry><entry>Set the CSS style for the context browser.</entry></row><row><entry>QString title()</entry><entry>Return the title of the currently playing track.</entry></row><row><entry>QString totalTime()</entry><entry>Return the total length of the currently playing track ([h:]mm:ss format).</entry></row><row><entry>QString track()</entry><entry>Return the track number.</entry></row><row><entry>QString type()</entry><entry>Return the file type.</entry></row><row><entry>QString year()</entry><entry>Return the year of the currently playing track.</entry></row><row><entry>void configEqualizer()</entry><entry>Toggle equalizer config dialog.</entry></row><row><entry>void enableDynamicMode(bool enable)</entry><entry>Switch Dynamic Mode on or off.</entry></row><row><entry>void enableOSD(bool enable)</entry><entry>Switch OSD display on or off.</entry></row><row><entry>void enableRandomMode(bool enable)</entry><entry>Switch Random Mode on or off.</entry></row><row><entry>void enableRepeatPlaylist(bool enable)</entry><entry>Switch Repeat Playlist on or off.</entry></row><row><entry>void enableRepeatTrack(bool enable)</entry><entry>Switch Repeat Track on or off.</entry></row><row><entry>void mediaDeviceMount()</entry><entry>Sets the command used for mounting media device.</entry></row><row><entry>void mediaDeviceUmount()</entry><entry>Sets the comment used for umounting media device.</entry></row><row><entry>void mute()</entry><entry>Toggle mute.</entry></row><row><entry>void next()</entry><entry>Equivalent to pressing "Next" button.</entry></row><row><entry>void pause()</entry><entry>Equivalent to pressing "Pause" button.</entry></row><row><entry>void play()</entry><entry>Equivalent to pressing "Play" button.</entry></row><row><entry>void playPause()</entry><entry>Toggle play/pause state (good for mm keyboard users) </entry></row><row><entry>void prev()</entry><entry>Equivalent to pressing "Prev" button.</entry></row><row>