From c5d5c04f7af62b757b982bf1eb872e779e4c390a Mon Sep 17 00:00:00 2001 From: Ray-V Date: Tue, 13 Jul 2021 19:34:23 +0000 Subject: Removed CMakeLists.txt in doc and translations trees Set up common rules for doc and translations Moved doc/amarok to doc/en Signed-off-by: Ray-V --- CMakeLists.txt | 8 +- doc/CMakeLists.txt | 12 - doc/amarok/CMakeLists.txt | 12 - doc/amarok/Makefile.am | 3 - doc/amarok/add_dynamic.png | Bin 34586 -> 0 bytes doc/amarok/advanced.docbook | 1110 ----------------------------- doc/amarok/amarok_playlist.png | Bin 136228 -> 0 bytes doc/amarok/analyzer.png | Bin 6711 -> 0 bytes doc/amarok/buttons.png | Bin 8512 -> 0 bytes doc/amarok/collection.png | Bin 8083 -> 0 bytes doc/amarok/config.docbook | 252 ------- doc/amarok/config_appearance.png | Bin 55097 -> 0 bytes doc/amarok/config_collection.png | Bin 56076 -> 0 bytes doc/amarok/config_engine.png | Bin 68505 -> 0 bytes doc/amarok/config_general.png | Bin 57975 -> 0 bytes doc/amarok/config_osd.png | Bin 56660 -> 0 bytes doc/amarok/config_playback.png | Bin 42952 -> 0 bytes doc/amarok/config_scrobbler.png | Bin 56180 -> 0 bytes doc/amarok/coverman.png | Bin 206414 -> 0 bytes doc/amarok/dynamic_bar.png | Bin 8013 -> 0 bytes doc/amarok/dynamic_settings.png | Bin 15842 -> 0 bytes doc/amarok/equalizer.png | Bin 12616 -> 0 bytes doc/amarok/faq.docbook | 1038 --------------------------- doc/amarok/file_browser.png | Bin 19830 -> 0 bytes doc/amarok/index.docbook | 392 ----------- doc/amarok/logo.png | Bin 3554 -> 0 bytes doc/amarok/media_device.png | Bin 27339 -> 0 bytes doc/amarok/menubar.png | Bin 2927 -> 0 bytes doc/amarok/musicbrainz.png | Bin 1611 -> 0 bytes doc/amarok/pl_tip1.png | Bin 8139 -> 0 bytes doc/amarok/play_list.png | Bin 16391 -> 0 bytes doc/amarok/player_window.png | Bin 11811 -> 0 bytes doc/amarok/playlist_browser.png | Bin 27593 -> 0 bytes doc/amarok/playlist_window.png | Bin 67451 -> 0 bytes doc/amarok/queue_manager.png | Bin 16560 -> 0 bytes doc/amarok/quick.docbook | 85 --- doc/amarok/requirements.docbook | 40 -- doc/amarok/rmb_menu.png | Bin 24242 -> 0 bytes doc/amarok/script_manager.png | Bin 22626 -> 0 bytes doc/amarok/status_bar.png | Bin 6710 -> 0 bytes doc/amarok/tab_lyrics.png | Bin 17497 -> 0 bytes doc/amarok/tab_music.png | Bin 86717 -> 0 bytes doc/amarok/tab_wiki.png | Bin 141378 -> 0 bytes doc/amarok/using.docbook | 1270 ---------------------------------- doc/amarok/vis_window.png | Bin 11669 -> 0 bytes doc/da/CMakeLists.txt | 12 - doc/de/CMakeLists.txt | 12 - doc/en/Makefile.am | 3 + doc/en/add_dynamic.png | Bin 0 -> 34586 bytes doc/en/advanced.docbook | 1110 +++++++++++++++++++++++++++++ doc/en/amarok_playlist.png | Bin 0 -> 136228 bytes doc/en/analyzer.png | Bin 0 -> 6711 bytes doc/en/buttons.png | Bin 0 -> 8512 bytes doc/en/collection.png | Bin 0 -> 8083 bytes doc/en/config.docbook | 252 +++++++ doc/en/config_appearance.png | Bin 0 -> 55097 bytes doc/en/config_collection.png | Bin 0 -> 56076 bytes doc/en/config_engine.png | Bin 0 -> 68505 bytes doc/en/config_general.png | Bin 0 -> 57975 bytes doc/en/config_osd.png | Bin 0 -> 56660 bytes doc/en/config_playback.png | Bin 0 -> 42952 bytes doc/en/config_scrobbler.png | Bin 0 -> 56180 bytes doc/en/coverman.png | Bin 0 -> 206414 bytes doc/en/dynamic_bar.png | Bin 0 -> 8013 bytes doc/en/dynamic_settings.png | Bin 0 -> 15842 bytes doc/en/equalizer.png | Bin 0 -> 12616 bytes doc/en/faq.docbook | 1038 +++++++++++++++++++++++++++ doc/en/file_browser.png | Bin 0 -> 19830 bytes doc/en/index.docbook | 392 +++++++++++ doc/en/logo.png | Bin 0 -> 3554 bytes doc/en/media_device.png | Bin 0 -> 27339 bytes doc/en/menubar.png | Bin 0 -> 2927 bytes doc/en/musicbrainz.png | Bin 0 -> 1611 bytes doc/en/pl_tip1.png | Bin 0 -> 8139 bytes doc/en/play_list.png | Bin 0 -> 16391 bytes doc/en/player_window.png | Bin 0 -> 11811 bytes doc/en/playlist_browser.png | Bin 0 -> 27593 bytes doc/en/playlist_window.png | Bin 0 -> 67451 bytes doc/en/queue_manager.png | Bin 0 -> 16560 bytes doc/en/quick.docbook | 85 +++ doc/en/requirements.docbook | 40 ++ doc/en/rmb_menu.png | Bin 0 -> 24242 bytes doc/en/script_manager.png | Bin 0 -> 22626 bytes doc/en/status_bar.png | Bin 0 -> 6710 bytes doc/en/tab_lyrics.png | Bin 0 -> 17497 bytes doc/en/tab_music.png | Bin 0 -> 86717 bytes doc/en/tab_wiki.png | Bin 0 -> 141378 bytes doc/en/using.docbook | 1270 ++++++++++++++++++++++++++++++++++ doc/en/vis_window.png | Bin 0 -> 11669 bytes doc/es/CMakeLists.txt | 12 - doc/et/CMakeLists.txt | 12 - doc/fr/CMakeLists.txt | 12 - doc/it/CMakeLists.txt | 12 - doc/man/CMakeLists.txt | 9 - doc/nl/CMakeLists.txt | 12 - doc/pl/CMakeLists.txt | 12 - doc/pt/CMakeLists.txt | 12 - doc/pt_BR/CMakeLists.txt | 12 - doc/ru/CMakeLists.txt | 12 - doc/sv/CMakeLists.txt | 12 - translations/CMakeLists.txt | 12 - translations/messages/CMakeLists.txt | 12 - 102 files changed, 4196 insertions(+), 4393 deletions(-) delete mode 100644 doc/CMakeLists.txt delete mode 100644 doc/amarok/CMakeLists.txt delete mode 100644 doc/amarok/Makefile.am delete mode 100644 doc/amarok/add_dynamic.png delete mode 100644 doc/amarok/advanced.docbook delete mode 100644 doc/amarok/amarok_playlist.png delete mode 100644 doc/amarok/analyzer.png delete mode 100644 doc/amarok/buttons.png delete mode 100644 doc/amarok/collection.png delete mode 100644 doc/amarok/config.docbook delete mode 100644 doc/amarok/config_appearance.png delete mode 100644 doc/amarok/config_collection.png delete mode 100644 doc/amarok/config_engine.png delete mode 100644 doc/amarok/config_general.png delete mode 100644 doc/amarok/config_osd.png delete mode 100644 doc/amarok/config_playback.png delete mode 100644 doc/amarok/config_scrobbler.png delete mode 100644 doc/amarok/coverman.png delete mode 100644 doc/amarok/dynamic_bar.png delete mode 100644 doc/amarok/dynamic_settings.png delete mode 100644 doc/amarok/equalizer.png delete mode 100644 doc/amarok/faq.docbook delete mode 100644 doc/amarok/file_browser.png delete mode 100644 doc/amarok/index.docbook delete mode 100644 doc/amarok/logo.png delete mode 100644 doc/amarok/media_device.png delete mode 100644 doc/amarok/menubar.png delete mode 100644 doc/amarok/musicbrainz.png delete mode 100644 doc/amarok/pl_tip1.png delete mode 100644 doc/amarok/play_list.png delete mode 100644 doc/amarok/player_window.png delete mode 100644 doc/amarok/playlist_browser.png delete mode 100644 doc/amarok/playlist_window.png delete mode 100644 doc/amarok/queue_manager.png delete mode 100644 doc/amarok/quick.docbook delete mode 100644 doc/amarok/requirements.docbook delete mode 100644 doc/amarok/rmb_menu.png delete mode 100644 doc/amarok/script_manager.png delete mode 100644 doc/amarok/status_bar.png delete mode 100644 doc/amarok/tab_lyrics.png delete mode 100644 doc/amarok/tab_music.png delete mode 100644 doc/amarok/tab_wiki.png delete mode 100644 doc/amarok/using.docbook delete mode 100644 doc/amarok/vis_window.png delete mode 100644 doc/da/CMakeLists.txt delete mode 100644 doc/de/CMakeLists.txt create mode 100644 doc/en/Makefile.am create mode 100644 doc/en/add_dynamic.png create mode 100644 doc/en/advanced.docbook create mode 100644 doc/en/amarok_playlist.png create mode 100644 doc/en/analyzer.png create mode 100644 doc/en/buttons.png create mode 100644 doc/en/collection.png create mode 100644 doc/en/config.docbook create mode 100644 doc/en/config_appearance.png create mode 100644 doc/en/config_collection.png create mode 100644 doc/en/config_engine.png create mode 100644 doc/en/config_general.png create mode 100644 doc/en/config_osd.png create mode 100644 doc/en/config_playback.png create mode 100644 doc/en/config_scrobbler.png create mode 100644 doc/en/coverman.png create mode 100644 doc/en/dynamic_bar.png create mode 100644 doc/en/dynamic_settings.png create mode 100644 doc/en/equalizer.png create mode 100644 doc/en/faq.docbook create mode 100644 doc/en/file_browser.png create mode 100644 doc/en/index.docbook create mode 100644 doc/en/logo.png create mode 100644 doc/en/media_device.png create mode 100644 doc/en/menubar.png create mode 100644 doc/en/musicbrainz.png create mode 100644 doc/en/pl_tip1.png create mode 100644 doc/en/play_list.png create mode 100644 doc/en/player_window.png create mode 100644 doc/en/playlist_browser.png create mode 100644 doc/en/playlist_window.png create mode 100644 doc/en/queue_manager.png create mode 100644 doc/en/quick.docbook create mode 100644 doc/en/requirements.docbook create mode 100644 doc/en/rmb_menu.png create mode 100644 doc/en/script_manager.png create mode 100644 doc/en/status_bar.png create mode 100644 doc/en/tab_lyrics.png create mode 100644 doc/en/tab_music.png create mode 100644 doc/en/tab_wiki.png create mode 100644 doc/en/using.docbook create mode 100644 doc/en/vis_window.png delete mode 100644 doc/es/CMakeLists.txt delete mode 100644 doc/et/CMakeLists.txt delete mode 100644 doc/fr/CMakeLists.txt delete mode 100644 doc/it/CMakeLists.txt delete mode 100644 doc/man/CMakeLists.txt delete mode 100644 doc/nl/CMakeLists.txt delete mode 100644 doc/pl/CMakeLists.txt delete mode 100644 doc/pt/CMakeLists.txt delete mode 100644 doc/pt_BR/CMakeLists.txt delete mode 100644 doc/ru/CMakeLists.txt delete mode 100644 doc/sv/CMakeLists.txt delete mode 100644 translations/CMakeLists.txt delete mode 100644 translations/messages/CMakeLists.txt diff --git a/CMakeLists.txt b/CMakeLists.txt index 50a77ec4..9021519e 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -97,8 +97,12 @@ set( CMAKE_MODULE_LINKER_FLAGS "${CMAKE_MODULE_LINKER_FLAGS} -Wl,--no-undefined" ##### source directories ######################## add_subdirectory( ${PROJECT_NAME} ) -tde_conditional_add_subdirectory( BUILD_DOC doc ) -tde_conditional_add_subdirectory( BUILD_TRANSLATIONS po ) + + +##### other data ################################ + +tde_conditional_add_project_docs( BUILD_DOC ) +tde_conditional_add_project_translations( BUILD_TRANSLATIONS ) ##### write configure files ##################### diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt deleted file mode 100644 index a8b8de4b..00000000 --- a/doc/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# - -tde_auto_add_subdirectories() diff --git a/doc/amarok/CMakeLists.txt b/doc/amarok/CMakeLists.txt deleted file mode 100644 index d0098a22..00000000 --- a/doc/amarok/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# - -tde_create_handbook( DESTINATION amarok ) diff --git a/doc/amarok/Makefile.am b/doc/amarok/Makefile.am deleted file mode 100644 index 5996bada..00000000 --- a/doc/amarok/Makefile.am +++ /dev/null @@ -1,3 +0,0 @@ -KDE_LANG = en -KDE_LANG_C = en -KDE_DOCS = AUTO diff --git a/doc/amarok/add_dynamic.png b/doc/amarok/add_dynamic.png deleted file mode 100644 index 2442e8b3..00000000 Binary files a/doc/amarok/add_dynamic.png and /dev/null differ diff --git a/doc/amarok/advanced.docbook b/doc/amarok/advanced.docbook deleted file mode 100644 index 9f0908eb..00000000 --- a/doc/amarok/advanced.docbook +++ /dev/null @@ -1,1110 +0,0 @@ - -Advanced Amarok features - - - -Keyboard Shortcuts - -&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 Configure Global Shortcuts... The &amarok; shortcuts can be configured by right clicking the Player window and selecting Configure Shortcuts... - -You can assign you multimedia keys to work as &amarok; shortcuts making your keyboard an &amarok; control center. - -The global shortcuts are: - - - - - - -Key Combination -Action - - - - - -WinX -Play - - - -WinC -Pause - - - -WinV -Stop - - - -WinB -Next Track - - - -WinZ -Previous Track - - - -WinKP_Add -Increase Volume - - - -WinKP_Subtract -Decrease Volume - - - -WinShiftKP_Add -Seek Forward - - - -WinShiftKP_Subtract -Seek Backward - - - -WinA -Add Media - - - -WinP -Toggle Playlist - - - -WinO -Show OSD - - - -WinM -Mute Volume - - - - - - -The &amarok; shortcuts are: - - - - - - -Key Combination -Action - - - - - -CtrlC -Copy - - - -CtrlKP_Enter -Goto Current - - - -CtrlD -Queue Selected Tracks - - - -CtrlQ -Quit - - - -CtrlShiftZ -Redo - - - -CtrlS -Save Playlist - - - -CtrlA -Select All - - - -CtrlM -Show Menubar - - - -CtrlH -Shuffle - - - -CtrlZ -Undo - - - - - - - - -The Playlist Browser shortcuts are: - - - - - - -Key Combination -Action - - - - - -Space -Load Playlist - - - -F2 -Rename Playlist - - - -Backspace -Remove Playlist - - - - - - - - - -The DCOP Interface - -The Amarok DCOP interface provides you with an easy way to control Amarok with your own custom scripts. - -The DCOP interface for Amarok has many generic calls that may be found in other TDE 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 pause dcop call would look like: - -%dcop amarok player pause - - -dcop amarok collection - - - - - - -DCOP Call -Action - - - - - -int totalAlbums() -Returns the total of albums in the collection. - - - -int totalArtists() -Returns the total of artists in the collection. - - - -int totalCompilations() -Returns the total of compilations in the collection. - - - -int totalGenres() -Returns the total of genres in the collection. - - - -int totalTracks() -Returns the total of tracks in the collection. - - - -QString query( QString sql) -Queries the database via SQL. - - - -QStringList similarArtists( int artists ) -Return similar artists of the current tracks, limit to int artists. - - - -void migrateFile( QString oldURL, QString newURL ) -Move a file in the collection, keeping stats intact. - - - -void scanCollection() -Scan the collection. - - - -void scanCollectionChanges() -Scan the collection for changes only. - - - - - - - - - - -dcop amarok contextbrowser - - - - - - -DCOP Call -Action - - - - - -void showCurrentTrack() -Show the current track in the context browser. - - - -void showLyrics() -Show the lyrics tab in the context browser. - - - -void showWiki() -Show the wikipedia tab in the context browser. - - - - - - - - - -dcop amarok player - - - - - - -DCOP Call -Action - - - - - -bool dynamicModeStatus() -Return dynamic mode status. - - - -bool equalizerEnabled() -Return the equalizer status. - - - -bool isPlaying() -Return true if something is playing now. - - - -bool randomModeStatus() -Return random mode status. - - - -bool repeatPlaylistStatus() -Return repeat playlist status. - - - -bool repeatTrackStatus() -Return repeat track status. - - - -int getVolume() -Return volume in range 0-100%. - - - -int sampleRate() -Return the sample rate of the currently playing track. - - - -int score() -Return the score of the currently playing track. - - - -int status() -Return playback status: 0 - stopped, 1 - paused, 2 - playing. - - - -int trackCurrentTime() -Return current play position in seconds. - - - -int trackPlayCounter() -Return play counter for current song. - - - -int trackTotalTime() -Return track length in seconds. - - - -QString album() -Return the album of the currently playing track. - - - -QString artist() -Return the artist of the currently playing track. - - - -QString bitrate() -Return the bitrate of the currently playing track (XX kbps). - - - -QString comment() -Return the comment of the currently playing track. - - - -QString coverImage() -Return the encoded URL of the current track's cover image - - - -QString currentTime() -Return the position of the currently playing track ([h:]mm:ss format). - - - -QString encodedURL() -Return the encoded URL of the currently playing track. - - - -QString engine() -Return the current sound engine. - - - -QString genre() -Return the genre of the currently playing track. - - - -QString lyrics() -Return the lyrics of the currently playing track. - - - -QString lyricsByPath( QString path ) -Return the lyrics of a track by path. - - - -QString nowPlaying() -The title of now playing media. - - - -QString path() -Return the unencoded path of the currently playing track. - - - -QString setContextStyle( QString ) -Set the CSS style for the context browser. - - - -QString title() -Return the title of the currently playing track. - - - -QString totalTime() -Return the total length of the currently playing track ([h:]mm:ss format). - - - -QString track() -Return the track number. - - - -QString type() -Return the file type. - - - -QString year() -Return the year of the currently playing track. - - - -void configEqualizer() -Toggle equalizer config dialog. - - - -void enableDynamicMode(bool enable) -Switch Dynamic Mode on or off. - - - -void enableOSD(bool enable) -Switch OSD display on or off. - - - -void enableRandomMode(bool enable) -Switch Random Mode on or off. - - - -void enableRepeatPlaylist(bool enable) -Switch Repeat Playlist on or off. - - - -void enableRepeatTrack(bool enable) -Switch Repeat Track on or off. - - - -void mediaDeviceMount() -Sets the command used for mounting media device. - - - -void mediaDeviceUmount() -Sets the comment used for umounting media device. - - - -void mute() -Toggle mute. - - - -void next() -Equivalent to pressing "Next" button. - - - -void pause() -Equivalent to pressing "Pause" button. - - - -void play() -Equivalent to pressing "Play" button. - - - -void playPause() -Toggle play/pause state (good for mm keyboard users) - - - -void prev() -Equivalent to pressing "Prev" button. - - - -void queueForTransfer( KURL url ) -Queue file for transfer to Media Device. - - - -void seek(int s) -Seek track to seconds position. - - - -void seekRelative(int s) -Seek to a position relative to the current track position. - - - -void setEqualizer(int, int, int, int, int, int, int, int, int, int, int) -Set the equalizer bands - - - -void setEqualizerEnabled( bool active ) -Toggle equalizer. - - - -void setEqualizerPreset( QString name ) -Set the equalizer preset - - - -void setLyricsByPath( QString url, QString lyrics ) -Set the lyrics of a track by it's path. - - - -void setScore( int score ) -Set the score of the currently playing track. - - - -void setScoreByPath( QString url, int score ) -Set the score of a track by it's path. - - - -void setVolume(int volume) -Set volume in range 0-100%. - - - -void showBrowser( QString browser ) -Shows browsers in the playlist window - - - -void showOSD() -Show the OSD display on the screen. - - - -void stop() -Equivalent to pressing "Stop" button. - - - -void transferDeviceFiles() -Transfer files to media device. - - - -void volumeDown() -Decrease volume by a reasonable step. - - - -void volumeUp() -Increase volume by a reasonable step. - - - - - - - - - -dcop amarok playlist - - - - - - -DCOP Call -Action - - - - - -int getActiveIndex() -Return the index of the currently active track. -1 if none. - - - -int getTotalTrackCount() -Return number of tracks in playlist. 0 if none. - - - -QString saveCurrentPlaylist() -Saves the current playlist to current.xml and returns its path. - - - -void addMedia( KURL ) -Add audio media specified by the url. - - - -void addMediaList( KURL::List ) -Add some audio media specified by the url. - - - -void clearPlaylist() -Clears the playlist. - - - -void playByIndex(int) -Starts playing the track at the specified index. - - - -void playMedia( KURL ) -Add audio media specified by the url. - - - -void popupMessage( QString) -Shows a temporary popup message. - - - -void removeCurrentTrack() -Removes the current-track item from the playlist. - - - -void repopulate() -Repopulate the playlist with random tracks. - - - -void saveM3u( QString path, bool relativePaths) -Saves the current playlist as m3u. - - - -void setStopAfterCurrent( bool ) -Enables/disables the "Stop After Current Track" feature. - - - -void shortStatusMessage( QString) -Shows a temporary message on the statusbar. - - - -void shufflePlaylist() -Shuffles the playlist. - - - -void togglePlaylist() -Toggle the Playlist-window. - - - - - - - - - -dcop amarok playlistbrowser - - - - - - -DCOP Call -Action - - - - - -void addPodcast( QString ) -Add a podcast entry to the playlist browser. - - - -void scanPodcasts() -Scan all podcasts for updates. - - - -void addPlaylist( QString ) -Add a playlist to the playlist browser. - - - - - - - - - -dcop amarok script - - - - - - - -DCOP Call -Action - - - - - -bool runScript( QString name) -Starts the script with the given name. Returns true on success. - - - -bool stopScript( QString name) -Stops the script with the given name. Returns true on success. - - - -QStringList listRunningScripts() -Returns a list of all currently running scripts. - - - -void addCustomMenuItem(QString submenu, QString itemTitle ) -Enables and sets custom menu item title. - - - -void removeCustomMenuItem(QString submenu, QString itemTitle ) -Removes the custom menu item. - - - -QString readConfig( QString key) -Returns a AmarokConfig configuration entry value from the given key. - - - - - - - - - - - - -Command-line Options - -Amarok supports the use of the standard Qt and kde command line options. Amarok also has it's own application specific options. - -The Qt and kde options: - - - - - - -Option -Action - - - - - ---help -Show help about options. - - - ---help-qt -Show Qt specific options. - - - ---help-kde -Show KDE specific options. - - - ---help-all -Show all options. - - - ---author -Show author information. - - - --v, --version -Show version information. - - - ---license -Show license information. - - - - - - -The Amarok options: - -The &amarok; options are designed to be used while &amarok; is running. - - - - - - -Option -Action - - - - - --r, --previous -Skip to the previous track in the playlist. - - - --p, --play -Start playing current playlist. - - - --s, --stop -Stop playback. - - - ---pause -Pause playback. - - - --f, --next -Skip to the next track in the playlist. - - - --a, --append -Append Files/URLs into the playlist. - - - --e, --enqueue -See append, available for backwards compatability. - - - ---queue -Queue Files/URLs after the currently playing track. - - - --m, --toggle-playlist-window -Toggle the playlist window. - - - ---wizard -Launch the First-run wizard. - - - ---engine "name" -Start &amarok; with the "name" engine. - - - - - - - - - - -Script Writing - -Scripting allows you to extend &amarok; easily without changing the main codebase. Scripts are similar to plugins, but instead of a dedicated plugin API they use &amarok;'s DCOP interface for communication. This makes it possible to write scripts in almost any programming language, like Ruby, Python or PHP. Not only can you create scripts in classic scripting languages, but also in compiled languages like C++ or plain C. Additionally, &amarok; can notify the scripts on special events and make them react accordingly. This notification system will be explained later in this section. - - -Bindings - -It is possible to write simple scripts that do not need user interaction, and it's also possible to make scripts with comfortable GUIs that act like little applications of their own. For GUI programming one of the many bindings which KDE provides can be used, for instance RubyQt, a Qt library binding for Ruby. However, it is worth noting that not every user has all available bindings installed. If you decide to use a binding, try to use one of the relatively wide spread ones (e.g. RubyQt or PyQt). - -In order to provide some feedback when a script fails to run due to a missing dependency, please check in your script if the module you want to include really exists. If the dependency is missing, you should catch the error and show an information dialog using the "kdialog" command line tool, so that the user learns why the script fails to run. - -This example shows how to catch a missing dependency in Ruby: - - -begin - require 'Korundum' -rescue LoadError - error = 'Korundum (KDE bindings for ruby) from tdebindings v3.4 is required for this script.' - `kdialog --sorry '#{error}'` - exit -end - - - - - -Getting Started: The Templates - -&amarok; provides template scripts for several languages in the scripts/templates/ directory. You can use these scripts as a basis for your own scripts, and extend them with the functionality you need. You'll notice that scripting is actually quite straightforward; For instance if you know to program a bit in Python, making your own script won't take you long. - - - - -Controlling &amarok; With DCOP - -Scripts can control Amarok by calling some of its DCOP functions. The easiest way to invoke a DCOP function is by using the "dcop" command line utility, which is part of every KDE distribution. - -Here is an example for increasing the master volume: - -dcop amarok player volumeUp - -Most scripting languages allow to execute external programs, with a function like exec(). This way the "dcop" utility can be invoked easily. Here is a simple Python example: - - - import os - os.system("dcop amarok player volumeDown") - - - - - -Notifications - -&amarok; sends notifications to all running scripts by writing strings to their stdin channel. The script should therefore constantly monitor stdin, and react accordingly to each of the possible events. Scripts may also choose to ignore any event they don't have a use for. - -The following notifications are sent by &amarok;: - - -configure -Tells the script to show its configuration dialog. The script must handle the -storing and loading of configuration options by itself. When a script is -started, Amarok sets its working directory to the folder where all data -should be stored. - - - -engineStateChange:empty|idle|paused|playing -Signals a change in the engine's state. - - - -trackChange -Signals the start of a new track. The script may then use DCOP functions to -query further information about the track, e.g. metadata and the length. - - - -volumeChangenewVolume -Signals a change of the master volume level. The volume is an integer with a -range of 0-100. - - - -customMenuClicked:submenu itemTitle paths -Returns the paths to selected files in the playlist when the custom playlist -context menu item is clicked. The submenu and itemTitle are also returned for -identification purposes in case a script is listening for multiple notifications. -To insert an item into the context menu use the DCOP call -'dcop amarok script addCustomMenuItem( submenu itemTitle )'. To remove an -item from the context menu use the DCOP call -'dcop amarok script removeCustomMenuItem( submenu itemTitle )'. - - - - - -Script Termination - -Before &amarok; exits, or when the user stops a script with the Script Manager, &amarok; sends the SIGTERM signal to the script. This signal can be caught in order to do cleanup work, like saving data or configuration settings. - - - - -Packaging - -&amarok;'s Script Manager is able to install script packages that the user has downloaded from a web server. Packages are just normal tarballs (.tar), optionally compressed with bzip2 (.bz2). We strongly recommend using a filename like myscript.amarokscript.tar.bz2, so the user can easily identify the package as an Amarok script. - -&amarok; 1.3 will only accept script packages with the amarokscript extension, so it is better to use it right from the start. - -The tarball's content must be organized as follows: - - -myscript/ - README - myscript.py (executable) - somemodule.py - foo.data - ... - - - - - -File permissions - -The main script must have executable (+x) permissions set, while additional modules which the script loads should not be executable. To preserve the file permissions in the tarball, you should use tar with the -p flag: - -tar -cf myscript.amarokscript.tar -p myscript - -&amarok; will not be able to install the script if the permissions are not correctly set. - - - - -Distributing - -When the package is finished, you can upload it to www.kde-apps.org, and add the link to the &amarok; Wiki Scripts Page. For the kde-apps entry you should use the &amarok; Scripts category. - - - - - - - - diff --git a/doc/amarok/amarok_playlist.png b/doc/amarok/amarok_playlist.png deleted file mode 100644 index 447ba6aa..00000000 Binary files a/doc/amarok/amarok_playlist.png and /dev/null differ diff --git a/doc/amarok/analyzer.png b/doc/amarok/analyzer.png deleted file mode 100644 index b1a2721b..00000000 Binary files a/doc/amarok/analyzer.png and /dev/null differ diff --git a/doc/amarok/buttons.png b/doc/amarok/buttons.png deleted file mode 100644 index 44f461e9..00000000 Binary files a/doc/amarok/buttons.png and /dev/null differ diff --git a/doc/amarok/collection.png b/doc/amarok/collection.png deleted file mode 100644 index 7a0b4ee5..00000000 Binary files a/doc/amarok/collection.png and /dev/null differ diff --git a/doc/amarok/config.docbook b/doc/amarok/config.docbook deleted file mode 100644 index 5a43ce7d..00000000 --- a/doc/amarok/config.docbook +++ /dev/null @@ -1,252 +0,0 @@ - -Configuring &amarok; -&amarok; is easily configured from the configuration dialog. The configuration dialog has multiple tabs for setting up different functions of &amarok;. -The configuration dialog can be found by selecting Configure &amarok; in the player &RMB; menu, -or by selecting Settings Configure &amarok;.... - -General Options - - General Options Screenshot - - - - -The General Options tab is divided into two sections, General Options and Playlist Options. - - -General Options - -In the General Options section you can configure some basic &amarok; options. -Show splash-screen on startup: displays the splash screen when &amarok; starts. -Show tray icon: enables the display of the system tray icon. - -Flash tray icon: enables animation of the system tray icon. -Show player window (like XMMS): Turns on the XMMS-like Player Window. When un-checked, only the Playlist Window, which resembles a display mode similar to the Juk interface, is shown. -Use Moodbar: only visible when &amarok; is compiled with moodbar support. This turns on the experimental moodbar support. -Make Moodier: only visible when &amarok; is compiled with moodbar support. It changes the color scheme used for the moodbar. -Store Mood data files with music: only visible when &amarok; is compiled with moodbar support. When enabled, this option allows saving of .mood files in the same location as the corresponding audio file. When disabled, the .mood files are saved within the &amarok; settings directory; usually ~/.trinity/share/apps/amarok/moodbar/. -Default size of cover previews: allows adjusting the size of the album cover image in the Context Browser. -External web browser: allows choosing what &amarok; uses to open external links via a drop-down menu listing the installed browsers. -Use another browser: allows you to specify the location to a browser not listed in the above menu. - - - -Playlist-Window Options - -In the Playlist-Window Options section you can configure playlist behavior. -Remember current playlist on exit: check this if you want to save your current playlist when you exit &amarok; and reload it the next time. -Manually saved playlists use relative path: check this box to have &amarok; save playlists with the location of audio file with respect to the location of the playlist. When unchecked &amarok; will save the exact location to the audio files in the playlist. -Keep active song visible on track change: this option automatically scrolls the Playlist, when a track changes, to ensure that the currently playing track is always visible. -Switch to Context Browser on track change: used to change to the Context Browser tab if it isn't active when &amarok; starts playback of a new track. -Show statusbar: enables the &amarok; statusbar in the Playlist Window. - - - - - -Configure Appearance - - Configure Appearance Screenshot - - - - -The Appearance tab allows you to configure how &amarok; looks. The tab is divided into three sections. - - -Fonts - -The fonts section is used for selecting the fonts to be used with &amarok;. Selecting the Use custom fonts checkbox enables font selection buttons. The available choices are for the Player Window, the Playlist Window, and the Context Browser. By clicking the Choose... button you can select a font from the dialog. - - - -Color Scheme - -The color scheme section is used to choose the color scheme for &amarok;. -The current KDE color-scheme choice forces &amarok; use the current KDE color scheme. -The classic Amarok, "funky-monkey", theme choice uses &amarok;'s original color scheme. -Custom color scheme enables color selectors to choose custom foreground and background colors for &amarok;. - - - -Context Browser Style - -This section allows you to change, install and remove Context Browser styles (themes). The Select a style drop-down menu selection of installed styles for use. The Install New Styles... button opens a file selection dialog where you can browse to styles saved on your system and install them. The Download Styles... button opens a dialog that fetches new styles from kde-look.org. Finally, the Uninstall Style button shows a dialog which allows you to remove any manually installed styles. - - - - - -Configure Playback - - Configure Playback Screenshot - - - - -The Configure Playback tab provides an interface for configuring your audio playback characteristics. - - -Transition Behavior - -You can configure how &amarok; transitions from one song to the next. -No Crossfading: provides a silent gap between tracks, specified in milliseconds. -Crossfading: provides a nice fading effect. The crossfade period is also specified in milliseconds. - - - -Remaining Options - -The remaining checkbox configures the the following option: -Resume playback on start allows resuming playback of the last track that was playing when &amarok; was closed, from the last known position in the track. - - - - - -Configure On-Screen-Display - - Configure OSD Screenshot - - - - - - -Configure On-Screen-Display - -The Configure On-Screen-Display tab allows you to activate the On-Screen-Display. If the On-Screen-Display check box is selected an area is activated for configuring the look of the display. When the On-Screen-Display is activated a preview widget will also be displayed allowing you to see the effects of your changes to the look of the On-Screen-Display -The first option for the OSD is the Font. Clicking the Choose button will open a Font Selection dialog allowing you to choose the font used in the OSD. There is also a Draw shadow checkbox to enable or disable the use of Shadowed text in the OSD -The next option is for the OSD colors. Checking the Use custom colors checkbox enables the Text color: and Background color: buttons. Clicking the buttons opens a dialog to choose the color OSD Text or OSD Background. If the Use custom colors checkbox is disabled the OSD will follow your current &kde; color scheme. -The Display Text text input box is used for configuring the text shown in the OSD. By assigning variables you can customize the OSD to suit your needs. Below is a list of the variables and the text they represent. - - - - -Text -Variable - - - - -Title -%title - - -Album -%album - - -Artist -%artist - - -Genre -%genre - - -Bitrate -%bitrate - - -Year -%year - - -Track Length -%length - - -Track Number -%track - - -Filename -%file - - -Comment -%comment - - -Score -%score - - -Playcount -%playcount - - - - -The Duration spin box is used to adjust the time, in milliseconds, that the OSD is displayed on your desktop. -The Screen option is for xinerama users only. This option is used to determine what screen the OSD will be shown on in a multiple monitor setup. - - - - - -Configure Engine - - Configure Engine Screenshot - - - - -The Configure Engine tab allows you to select a sound engine from the list in the drop-down menu. Available options vary among the engines selected. See the "Requirements" section for different engines available. - - -Configure Collection - - Configure Collection Screenshot - - - - -The Collection settings tab is used for configuring all the collection options. These include the folders where you music is stored, and the database used for the collection. - - -Collection Folders - -This is where you choose the folders you want &amarok; to scan for music. Simply check the boxes next to the desired folders in the tree view of your filesystem. The Collection Folders section also has several check boxes to specify how the collection uses the selected folders. -Scan folders recursively: tells &amarok; to scan the selected folders and all of their sub-folders. -Watch folders for changes: allows &amarok; to watch the selected folders for filesystem changes (for example, added or deleted music files). An incremental scan is also performed to make the necessary changes to your collection. -Import Playlists: allows &amarok; to import any playlists (.pls and .m3u files) it finds while scanning for tracks to add to your collection. You will find these on the "Playlists" sidebar. - - - -Collection Database - -The Collection Database section is used to select a database to use for the collection. Use the Engine: combo box to select from either Sqlite or MySql. If MySql is selected, additional configuration is required in the MySql Configuration section. -The MySql Configuration section is for configuring what database &amarok; uses, and where it is located. First is the Hostname:, which is where the MySql database is located. Next is the Port:, which is the network port used when connecting to the database. The Name: option, is the actual database to connect to. -Use the Username: and Password: text input boxes to specify the username and password used for connecting to the MySql database. - - - - - -Configure Last.fm - - Configure last.fm Screenshot - - - - -The last.fm settings tab configures the last.fm support in &amarok;. Tracks played are submitted to the last.fm server, and if asked to, &amarok; will request recommendations based on your currently playing track. - - -last.fm Profile - -This is where you fill in the Username and Password for your last.fm profile. If you do not have a profile you can register at the last.fm website. - - - -last.fm Services - -Improve my profile by submitting the tracks I play: allows &amarok; to submit your played tracks to your last.fm profile. -Retrieve similar artists: this will cause &amarok; to request, from last.fm, a list of artists similar to the one you're listening to. These are also displayed in the Context Browser. Note: you do not need a last.fm profile to recieve similar artists - simply check this box. - - - - - \ No newline at end of file diff --git a/doc/amarok/config_appearance.png b/doc/amarok/config_appearance.png deleted file mode 100644 index 0204c05b..00000000 Binary files a/doc/amarok/config_appearance.png and /dev/null differ diff --git a/doc/amarok/config_collection.png b/doc/amarok/config_collection.png deleted file mode 100644 index a16911b7..00000000 Binary files a/doc/amarok/config_collection.png and /dev/null differ diff --git a/doc/amarok/config_engine.png b/doc/amarok/config_engine.png deleted file mode 100644 index 5309e2d4..00000000 Binary files a/doc/amarok/config_engine.png and /dev/null differ diff --git a/doc/amarok/config_general.png b/doc/amarok/config_general.png deleted file mode 100644 index 68c22907..00000000 Binary files a/doc/amarok/config_general.png and /dev/null differ diff --git a/doc/amarok/config_osd.png b/doc/amarok/config_osd.png deleted file mode 100644 index b64417bf..00000000 Binary files a/doc/amarok/config_osd.png and /dev/null differ diff --git a/doc/amarok/config_playback.png b/doc/amarok/config_playback.png deleted file mode 100644 index 11312bc1..00000000 Binary files a/doc/amarok/config_playback.png and /dev/null differ diff --git a/doc/amarok/config_scrobbler.png b/doc/amarok/config_scrobbler.png deleted file mode 100644 index ba03382e..00000000 Binary files a/doc/amarok/config_scrobbler.png and /dev/null differ diff --git a/doc/amarok/coverman.png b/doc/amarok/coverman.png deleted file mode 100644 index d18bcf4b..00000000 Binary files a/doc/amarok/coverman.png and /dev/null differ diff --git a/doc/amarok/dynamic_bar.png b/doc/amarok/dynamic_bar.png deleted file mode 100644 index 5431d1f5..00000000 Binary files a/doc/amarok/dynamic_bar.png and /dev/null differ diff --git a/doc/amarok/dynamic_settings.png b/doc/amarok/dynamic_settings.png deleted file mode 100644 index aa6cb431..00000000 Binary files a/doc/amarok/dynamic_settings.png and /dev/null differ diff --git a/doc/amarok/equalizer.png b/doc/amarok/equalizer.png deleted file mode 100644 index 61d2d175..00000000 Binary files a/doc/amarok/equalizer.png and /dev/null differ diff --git a/doc/amarok/faq.docbook b/doc/amarok/faq.docbook deleted file mode 100644 index 43e78113..00000000 --- a/doc/amarok/faq.docbook +++ /dev/null @@ -1,1038 +0,0 @@ - -Questions and Answers - - -What is &amarok;? - - - - - -What is &amarok;? - - - -&amarok; is a music player for Unix systems (eg. Linux). More information can be found in a summary of its features and the screenshot gallery. - - - - - - - - -Installation - - - - - - -Can I use &amarok; without KDE? - - - -&amarok; only requires KDElibs, none of the other KDE stuff. So you have to have KDElibs installed properly (including all the binaries that come with it, as &amarok; needs some of these to find plugins and for the script plugins). We have written an entry for how to compile a minimal KDElibs, which you may find useful. -For some features to work correctly, such as the on-screen display, require your window manager to support the relevant freedesktop.org standards. So GNOME will work well, but fluxbox will have some trouble. We are committed to supporting &amarok; on all platforms. We use KDElibs and Qt because they provide an excellent development environment. - - - - - - - - - -Troubleshooting - - - - - -&amarok; crashes during the Collection scan, always at the same point. What's happenning? - - - -It's likely that one file in your Collection triggers a bug in the TagLib library, and makes &amarok; crash. You can identify this file by looking at ~/.trinity/share/apps/amarok/collection_scan.log. You should report this crash to the TagLib bug database on bugs.kde.org and attach the broken file. Afterward you can remove the file from your Collection and repeat the scanning. - - - - - -&amarok; crashes when I play a certain track, everytime, what's wrong? - - - -This usually means TagLib is crashing while reading that track's tags. Report the bug against TagLib at bugs.kde.org. - - - - - - -&amarok; crashes often, what can I do? - - - -Upgrade your ALSA libs and utils to the latest version, or use OSS, or OSS emulation. -If you use MySQL as the database backend, try the SQLite one, it is slightly more mature (the &amarok; code, not the db itself) - Try a different audio-engine. -Make sure that all the libraries that &amarok; uses were compiled with the same GCC version as &amarok; itself. The situation when &amarok; is compiled using GCC 3.4.x and linked against taglib which was compiled using GCC 3.3.x can lead to crashes during tag editing. -If you're using KDE with artsd, try disabling "auto suspend if idle after..." in the sound system settings or at least don't use a value of 1 second since that will interfere every time amarok switches songs. -Otherwise, forward us the backtraces when the email pops-up (you'll see). If you get a crash often you will get it fixed for sure if you forward a really good backtrace to us. See the next sections for assistance there. - - - - - - -How can I obtain a decent backtrace? - - - -See the Debugging HowTo. - - - - - - -&amarok; is not using the tags I know are in my files! - - - -If Konqueror or other apps are displaying different Title, Artist, Album or Genre information than &amarok; is picking up when it creates your collection, it may be reading the older ID3v1 format tags rather than the newer ID3v2 tags. This can be due to your Encodings setting: Go to Settings Configure &amarok;, and then find the Encodings section of the Settings panel. Uncheck all checkboxes to "Do not decode the following as latin1". Rescan your collection to pick up the ID3v2 tags. - - - - - - -&amarok; is not displaying my utf-8 id3v2 tags properly! - - - -This is because most applications put utf8 data into id3v2 tags but do not specify the encoding as unicode. This perl script will fix that. - -#!/usr/bin/perl -die "File $ARGV[0] doesn't exist" unless -f $ARGV[0]; -use MP3::Mplib; -my $mp3 = MP3::Mplib->new($ARGV[0]); -my $v2tag = $mp3->get_v2tag; -print "Error writing tags of $ARGV[0]\n" unless $mp3->set_v2tag($v2tag,&UTF8); - -This script requires the perl module MP3::Mplib which can be installed by issuing this command -perl -MCPAN -e 'install MP3::Mplib' - - - - - -Why do my statusbar icons always look active? - - - -&amarok; statusbar icons(Random/Repeat/Append) look constantly Active on KDE 3.4.0. This is a known bug in KDE 3.4.0. The icon effects are sometimes forgotten. Simple fix kcontrol AppearanceIconsAdvanced, set disabled state to "Gray" and "Semi-transparent". Note that sometimes you must click on the icon 3 times before it has an effect after making this change. - - - - - - -Why does &amarok; complain about undefined symbols and then refuses to start? - - - -if you get this error : "amarokapp: symbol lookup error: amarokapp: undefined symbol: _ZN11KSystemTray9setPixmapERK7QPixmap", then check that amarokapp uses the correct libtqt (check with : ldd `which amarokapp` | grep qt). -To fix it, you might have to remove any conflicting libtqt and/or edit /etc/ld.so.conf so it pick up the correct version first. - - - - - - - - - -General Usage - - - - - - -Where can I get support for &amarok;? - - - -There are several options. Often times problems you have with the initial install of &amarok; are best answered by experts of your particular Unix or Linux distribution. You may seek help from fellow users and developers at the &amarok; forum and the IRC channel at irc.freenode.net channel #amarok. -Bugzilla is not a place to seek support. Please do enter a bug if you are serious about helping fix a bug in &amarok; itself. - - - - - - -When I start &amarok;, I see an empty playlist. How do I actually get tracks in there? - - - -Simple. Use the File Browser on the left side to navigate to the desired directory. Then drag the files into the Playlist part on the right. - - - - - - -Where is the"Home" tab? - - - -To avoid interface-clutter "Home" tab has been transformed into "Statistics" tool, available under ToolsStatistics. - - - - - - -Is there a way to set up amount of information that "Context" borwser shows? - - - -Yes, use the right mouse button menu anywhere on "Context" browser to modify it. - - - - - - -Why are the stars and numbers in the "Context" browser are out of sync? - - - -The meaning of those symbols has changed in Amarok 1.4 "Fast Forward": stars represents the user-defined rating, while numbers shows calculated score. - - - - - - -Clicking on stars in "Context" browser does not work! How do I rate a song? - - - -To rate a track you need a "Rating" column in playlist. Click with the &RMB; on playlist title, and choose Add ColumnRating. Click anywhere inside "Rating" column to set up rating for a track. You can also use shortcuts [Win]+[1-5] to quickly rate a song, with Amarok running in the background. - - - - - - -How do I remove tracks from the Playlist? - - - -Select the files you want to remove, and press Del key on your keyboard. Or right-click the selection and choose Remove Selected from pop up menu. - - - - - - -How can I load a playlist? - - - -Just drag and drop the playlist file into the Playlist, like you would do with any other file. It's that simple! - - - - - -How can I save the current playlist? - - - -The Save playlist button is next to Add Media button in the Playlist Toolbar. Just click it! - - - - - - -There are no visualizations in the visualizations dialog. - - - -You probably don't have xmms-config installed, reconfigure and build after installing the appropriate xmms-devel package. You also may want to install the latest version of libvisual, which has some ultra fancy visualizations. - - - - - - -Where's the equalizer? - - - -The Equalizer Window can be found in the right mouse button menu. You can also find it in the Menubar by selecting Tools Equalizer. - - - - - - - - - - -Playback - - - - - - -What media types does &amarok; support? - - - -None. Yes, that's right! None! We have a backend independent approach, so the question you should be asking is "What media types does GStreamer/xine/aRts/NMM/MAS/KDEmm support?" So as you can guess we pretty much support absolutely every audio format you can think of. GStreamer can even decode text and PNG! -For more information, have a look at Audio Engine Comparison. - - - - - - -Why can't &amarok; play MP3s? - - - -It can! Chances are you're using Fedora/RedHat linux, they don't ship with MP3 decoders by default (due to patenting issues). Solution: -Alt-F2, gg:redhat mp3 kde, ENTER - - - - - - -&amarok; won't play MP3's under SUSE Linux 9.3, what could I do? - - - -Open the "YaST Online Update" and install the 'Multimedia Option Pack 1' patch. Voila, &amarok; plays MP3's. - - - - - - -With GStreamer-engine I'm getting 100% CPU usage while playing. How can I fix it? - - - -When using GStreamer-engine with alsasink, &amarok; requires the device to provide a mixer. Mixing allows multiple applications to access the device at the same time, and output sound simultaneously. This can either be achieved by using a soundcard with hardware-mixing (e.g. SBLive), or by using the "dmix" plugin for alsa, which provides software-mixing. See Setting up Dmix for ALSA. -After installation you need to specify "dmix" as the sound device in the engine settings dialog. - - - - - - -I can't get any media to play in &amarok;, why not? - - - -You need to test the sound frameworks at the commandline: - -artsplay foobar.mp3 -gst-launch filesrc location=/home/foo/bar.mp3 ! spider ! audioscale ! audioconvert ! alsasink -xine-check - -The output from these commands should help you identify the problems you are having and how to fix them. Please note you may need to use a different sink to test GStreamer (eg. osssink). - - - - - - -Can &amarok; output directly to OSS/ALSA? - - - -We already do! Don't forget that the media must be decoded first! You can't just pipe an MP3 to ALSA, all you will get is white-noise. GStreamer is the best choice for most people who want a low-overhead decoding solution, it reads the file, decodes it and pipes the PCM data to ALSA. Exactly like XMMS. - - - - - - - -But! XMMS can output directly to ALSA! - - - -But it decodes it first! GStreamer can output directly to ALSA too! So can xine! - - - - - - -The sound stutters, is there anything I can do to improve it? - - - -You can either use the GStreamer engine (it's great!), or tweak aRts. Open Control Center Sound and Multimedia Sound System. Enable Run with highest possible priority, and increase the size of the Sound buffer: (warning, see the next FAQ!) You should also ensure that your artswrapper is suid: - -su -chmod a+rsx /path/to/kde/bin/artswrapper -killall -9 artsd - -With KDE 3.2.x there are issues with the KDEMultimedia codecs that can cause distorted playback, please see this bug report. -Also, increasing the size of the sound buffer in your .asoundrc alsa configuration file can help a great deal. - - - - - - -The CPU usage is high, is there anything I can do to improve it? - - - -Either don't use the aRts-engine, use the GStreamer or xine engines, or address the high CPU usage by installing KDEMultimedia in its entirety to get the faster aRts codecs (eg. libarts_mpeglib.so, etc.) - - - - - - -The &amarok; analyzers are really unresponsive! - - - -You are probably using the aRts-engine, either use another engine (the xine-engine has been seriously tweaked to give perfect analyzer-sync), or reduce the size of your aRts buffer in kcontrol, sound system. The lower the buffer the more responsive the visuals. Yes this is a bug, please help us fix it! - - - - - - -I have GStreamer installed but when I try to change to the GStreamer engine &amarok; crashes, what gives? - - - -After installing GStreamer you have register it's components, running `gst-register` (sometimes suffixed with a version, so gst-register-0.8) should take care of registering your GStreamer components. - - - - - - -I ran gst-register but I still have have GStreamer troubles, what can I do? - - - -You can try the GStreamer FAQ. If all else fails you can try the knowledgeable people at the #gstreamer IRC channel. - - - - - - -&amarok; says that the GStreamer engine cannot play MP3 files, although I have compiled/installed the mad plugin! - - - -Try this (make sure that &amarok; does not run): - - Download, compile and install the ffmpeg package - - Run gst-register (you may need to run it twice, as root and as your "normal" user) - - Go to your GStreamer plugin directory (you can find it with gst-config / gstreamer-config) - - Delete the ffmpeg files (or move them somewhere else) - - Run gst-register again - - Start &amarok; - - - - - - - - - - -Development - - - - - - -How do I get a cvs/svn version of &amarok;? - - - -How to obtain and build SVN &amarok; - - - - - - -I've found a bug / I've got a great idea for &amarok;! - - - -Please report it at bugs.kde.org, if you have a list of suggestions/wishes it may be best to send them to our mailing list: amarok-devel@lists.sourceforge.net - - - - - - -Do you accept patches? - - - -Happily! Your best course of action is to let us know what you plan to do before you do any work so we can discuss it, but don't fret we haven't turned down a patch yet! Discussion is mostly to help you patch the correct bits of &amarok;. Then either submit a patch to the mailing list, or commit if you have svn access. However, please let us know before you commit new features to svn! If you have a bug fix then just go ahead, this is open source after all :) - - - - - - -Why did you choose the name &amarok;? - - - -&amarok; is an album by British composer Mike Oldfield. I happen to like it a lot, and I think the name's got a nice sound. Plus, of course, it contains the all important “K”.. :) - - - - - - -Is it &amarok;, AmaroK or Amarok? - - - -It is &amarok;! Yes, we understand this is unconventional ;-) - - - - - - - - - - -Tips and Tricks - - - - - - -How do I use &amarok; as an alarm clock? - - - -Actually, thanks to the magic of DCOP you already can :) Simply set an alarm in your favorite calendar program and tell it to run the following command: -dcop amarok player play - -This command will tell &amarok; to start playing. Make sure that &amarok; is running before you go to bed, and you should wake up to the merry tune of whatever you pressed stop on before going to bed. - - - - - - -How do I get what &amarok; is playing right now, when I'm on another computer? - - - -If you have a properly set up ssh environment, you can use that to get the information. The following command will return the Now Playing string. -ssh -i ~/.ssh/id_rsa yourip dcop --user yourusername amarok player nowPlaying - -Make sure that you replace yourip with your IP and yourusername with your username. Also note that this expects your identification to be found in the ~/.ssh/id_rsa file. - - - - - - -What kind of tricks can the Player Window do? - - - -The &amarok; player analyzers can be detached from the Player Window. By pressing d on your keyboard the active analyzer will open in an independent, re-sizeable window. - - - - - - -What kind of tricks can the Playlist Window do? - - - -Holding Control and clicking the right mouse button enqueues files in the order in which you clicked them. -Pressing Enter after making a playlist search will play the first search item and will clear the search. - - - - - - -I see the Player Window and Playlist Window have neat tricks, what about the tray icon? - - - -Hovering your mouse on the icon will display a nice popup with current track information. -Clicking the middle mouse button on the icon play-pauses the current track. -Scrolling the mouse wheel changes volume. -Holding Shift while scrolling the mouse wheel seeks through the current track. -Holding Control while scrolling the mouse wheel will skip through tracks in the playlist. -Dragging and dropping items into the tray icon opens a pop up menu allowing you to choose from three options, Append to Playlist, Append and Play, and Queue after Current Track. -Tray icon is also a song position indicator. - - - - - - -Where do I find the settings for &amarok;? - - - -~/.trinity/share/apps/amarok -~/.trinity/share/config/amarokrc - - - - - - -How do I disable a browser section in &amarok;? - - - -Clicking with the &RMB; on any browser title shows up a list of visible browsers. You can use this list to disable/re-enable any browsers available. - - - - - - - - - - -General Questions - - - - - - -How Do I use an external MySQL database with &amarok;? - - - -See MySQL HowTo. - - - - - - -My $HOME is located on NFS. After startup, &amarok; fails to build the Collection, printing many database errors to the console. What to do? - - - -The internal SQLite database which &amarok; uses by default does not work on NFS. You must either link your ~/.trinity/share/apps/amarok directory to a local drive, or use the MySQL support. - - - - - - -How can I rip/encode Audio-CDs with &amarok;? - - - -Insert your CD, then click on "Play Audio CD" in the menu. The File-Browser will come up and show a tree with several folders. For normal ripping, go to the "wav" folder, select some tracks and drag them to the desired destination in a Konqueror window. For automatic encoding, drag files from the "mp3" or "ogg" folder instead. -CD-ripping requires the "AudioCD TDEIO-slave" to be installed. It is part of KDE-Multimedia. - - - - - - -How are track ratings determined? - - - -&amarok; assigns a rating (a number 1-100) to a song based on how many times you've listened to it and whether you skip the song without it finishing. Every time the song finishes playing, the rating is changed. The code for changing the rating is in collectiondb.cpp. As of version 1.2.2, it was on line 1181, though you can find it by searching for "CollectionDB::addSongPercentage". -When defining a score for a track which has never been played before, &amarok; uses the calculation -score = ( ( 50 + percentage ) / 2 ) -This sets the score equal to a number from 25-75, depending on how far through the song was allowed to play. For example, if the user stops or skips the song after only 25% of it has played, the score will be set to (50+25)/2, or 37.5. Scores are displayed as integers, however, so this number is rounded to the nearest integer before being displayed. The score is kept internally as a floating point number however, since after a song has been played several times, it may be impossible to alter the score by more than a point with a single play (see below). -When defining a score for a track which has been played before, the calculation is a bit more complicated. In the source, it is - score = ( ( values[2].toDouble() * values.first().toInt() ) + percentage ) / ( values.first().toInt() + 1 ); -Substituting in the values from this line: - - QStringList values = query( QString( - "SELECT playcounter, createdate, percentage FROM statistics " - "WHERE url = '%1';" ) - .arg( escapeString( url ) ) ); - -We have - score = ( ( statistics_percentage.toDouble() * PlayCounter.toInt() ) + percentage ) / ( PlayCounter.toInt() + 1 ); - -Basically, this adjusts the previous score (statistics_percentage) by a decreasing amount depending on how many times the track has been played. The more times the track has been played, the less of an impact each play has on the score. - - - - - - -How do I manually change a track's rating? - - - -You may change the rating manually by right-clicking on the playlist columns titles (the ones that say title, artist, album etc) and select Score. You can then change the score like any other song attribute, by right clicking it and selecting "Edit Tag 'Score'" or pressing F2. You can also edit the score in the Tag dialog, available by right clicking on a track. - - - - - - -Why isn't &amarok; part of KDEmultimedia? - - - -The developers don't want the man telling them when they can release. (Meaning, packages in KDE proper have a release schedule that doesn't fit with &amarok;'s fast-paced development). - - - - - - -How do I prevent the &amarok; icon from blinking in my system tray? - - - -This is a new feature that has been added that some users might find distracting. Simply uncheck the "Flash icon tray when playing" option under General Options. - - - - - - -How can I show/remove the analyzer in the playlist window? - - - -The playlist analyzer is part of the playlist toolbar. Select SettingsConfigure Toolbars -Add/Remove Analyzer to the Current actions -Press OK - - - - - - - -How do I change the Context Browser theme? - - - -Download a theme or make your own. Install it through Configure &amarok;... AppearanceContext Browser Style, click Install New Style. - - - - - - -What legal issues caused "Blue Wolf" icon replacement? - - - -The icon was way too similar to the Warp Graphics, Inc. logo (elfquest.com), so it had to be removed to avoid problems. - - - - - - -I don't have any visualizations. Where can I obtain these ? - - - -Install the latest version of libvisual. - - - - - - -How can I add my favorite streams to &amarok;? - - - -First of all, load the stream into the playlist. There are several ways to do this. You can simply click on a Stream-Playlist URL in Konqueror; &amarok; will then automatically open the stream. E.g. on shoutcast.com, click on the "Tune In" button. Or you can use the "Add Media" function to load a stream.Once the stream is loaded, you can save it by right-clicking on "Current Playlist" in the Playlist-Browser, then select "Save", and give it a meaningful name. The Stream will then be added to the Playlist-Browser view for later reference. - - - - - - - - - - -Konqueror Sidebar - - - - - - -What is Konqueror Sidebar? - - - -Konqueror sidebar allows you to monitor/control &amarok; while browsing with Konqueror. To see it, run Konqueror, press F9 to see sidebar, click on preferences (top one) button, in dropdown menu choose Add &amarok; Konqueror Sidebar. - - - - - - - - - - -Audioscrobbler - - - - - - -What is Audioscrobbler? - - - -Audioscrobbler is a free service that is sends information regarding which songs are played to an independent server. The service signup is free and only requires that you pick a user name and password that is not already in use. Audioscrobbler is currently utilized in &amarok;. - - - - - - -I do not want &amarok; to send information to Audioscrobbler! - - - -Uncheck "Submit tracks I play" to prevent querying Audioscrobbler for suggested tracks. - - - - - - -How do I get to the Audioscrobbler &amarok; group? - - - -The Audioscrobbler &amarok; group is located here: &amarok; Audioscrobbler Group - - - - - - - - - - -General Engine/Playback Questions - - - - - - -Which sound engine should I use? - - - -Please refer to the Audio Engine Comparison. - - - - - - -What version of ALSA should I use? - - - -If you output to ALSA, you should use the newest available version of ALSA possible! Old versions of ALSA have caused plenty of crashes, and have caused plenty of wrongly attributed crash-reports. - - - - - - -I've installed GStreamer/xine/etc., but the relevant audio-engine won't show up. What gives? - - - -&amarok; was probably compiled before you had xine and/or gstreamer installed, so the ./configure routine did not include them in the list of engines to be built. You will have to rebuild &amarok;. - - - - - - -But I did rebuild &amarok; after installing gstreamer and/or xine, but the engine still does not show up. What happened? - - - -You most likely are using a distro that packages development libraries separately from the main library, so even though gstreamer is installed, &amarok; cannot link to it because gstreamer-devel is not installed. The same issue exists for xine, you must install xine-devel if your distro splits packages in this fashion. Don't forget to rebuild &amarok; after installing the devel packages. - - - - - - - - - - -GStreamer engine - - - - - - -Why is there always a gap although I have crossfading enabled? - - - -Make sure you don't have gst-ffmpeg installed. Instead, install the gst-mad plugin. - - - - - - -I'm getting this error: "GStreamer-CRITICAL **: Factory for `adder' has no type.". How to fix? - - - -Your GStreamer was built with Prelinking, which is not compatible with GStreamer. You must rebuild it without this option. -merlin-tc advises: In addition, don't use any ldflags when building GStreamer. - - - - - - -You receive an error "There is no element present to handle the file's mimetype audia/mp4" even though you have the correct gstreamer-faad plugin is installed. - - - -To correctly play mp4 or m4a files with gstreamer, you must also have gstreamer-quicktime in addition to gstreamer-faad installed. - - - - - - -You receive an error "There is no element present to handle the stream's mimetype audio/mpeg" - - - -You are trying to play an mp3 stream without the gstreamer-mad plugin installed. Install the gstreamer-mad plugin and run "gst-register" as root before restarting &amarok;. - - - - - - -I have a second soundcard and I'm using ALSA. How do I make Amarok use it instead of the default? - - - -In SettingsConfigure AmarokEngine, check the 'Device' checkbox and fill in the device. Typical this is 'hw:0' for the default soundcard, and 'hw:1' for the second soundcard. - - - - - - - - - - -xine engine - - - - - - -How can I change where the audio is output to? - - - -If you are using ALSA, you can output to a specific device with xine. Set up an ~/.asoundrc (user only) or /etc/asound.conf (system wide) file that aliases your hardware devices, and then insert that alias in the "device used for stereo output:" box in the xine-engine configuration tab. Alternatively, you can directly enter the alsa device (hw:0,0 or hw:1,0 and so on). If you choose this latter (alternate) method, be aware that ALSA's corresponding plugfoo (e.g. plughw:0,0 or plughw:1,0 and so on) routing through alsa-lib is much preferred. -Here is a sample ~/.asoundrc for a machine that has an onboard Intel AC97 codec and a usb-audio device: - - pcm.intel8x0 { - type plug - slave.pcm "hw:0" - } - - ctl.intel8x0 { - type hw - card 0 - } - - pcm.usb-audio { - type plug - slave.pcm "hw:1" - } - - ctl.usb-audio { - type hw - card 1 - } - -Now enter usb-audio in the xine-engine setup screen and output should go to the usb-audio device (with alsa-lib properly handling sample rate conversion, channels, and so on). - To use a dmixed virtual device, ensure that the "sound card can do mmap" checkbox is unchecked. - - - - - - - - - - -aRts engine - -Sorry, aRts-engine has no maintainer, but feel free to fix it yourself! You could be the new aRts-engine maintainer we need so desperately! - - - - - diff --git a/doc/amarok/file_browser.png b/doc/amarok/file_browser.png deleted file mode 100644 index 0efc4bdf..00000000 Binary files a/doc/amarok/file_browser.png and /dev/null differ diff --git a/doc/amarok/index.docbook b/doc/amarok/index.docbook deleted file mode 100644 index b94fd6a0..00000000 --- a/doc/amarok/index.docbook +++ /dev/null @@ -1,392 +0,0 @@ - - - - - - - - - - - - - - - -]> - - - - -The &amarok; Handbook - - - - Mike - Diehl - -
madpenguin8@yahoo.com
- - - - - The Amarok Development Squad - Developers - - - - - - - 2005 - The Amarok Development Squad - - - - 2006 - The doKymotion Krew - - -&FDLNotice; - -2006-02-20 -2.1 - - - &amarok; is a media player for the Trinity Desktop Environment. - - - - TDE - multimedia - player - audio - ogg - mp3 - wav - music - sound - script - - - - - -Introduction - - - Logo - - - - - -&amarok; is an audio player for &kde; that is extremely powerful, yet surprisingly simple to use. - -With &amarok; you can simply drag and drop music into the playlist instead of searching through endless menus. Just looking for that one song in a huge collection? &amarok;'s collection browser with its quick-search bar will help you find it in a matter of seconds. - -It may seem that &amarok; has the same old features found in the average audio player, but we did not stop there. One look at the context browser and you will see why &amarok; is one step ahead of the rest. The context browser shows all kinds of information related to your currently playing track - from the album cover, through to other music by the same artist, as well as related artists - an informative and fun way to learn about your collection! - -Do you already have many different playlists but can never decide on which one you want to use? Then the playlist browser is just for you. Never know what to listen to? Amarok's Dynamic Mode will choose your music for you, and Smart Playlists allow you to jump right in to specific parts of your collection. - -Amarok has outstanding support for Apple's iPod, iRiver's ifp and a multitude of generic USB devices. It also features many different audio backends allowing YOU to choose how you listen to your music. These and other features make it the most advanced audio player available. &amarok; is smart, sexy and clever. We hope that its use will truly allow you to "Rediscover your music!" - - - - - -&amarok-quick; - -&amarok-config; - -&amarok-using; - -&amarok-advanced; - -&amarok-faq; - - -Credits and License - -Program copyright 2003-2005 Mark Kretschmann markey@web.de -and The AmaroK Team. - - -The AmaroK Team -Christian babe-magnet Muehlhaeuser chris@chris.de -Frederik ich bin kein Deustcher! Holljen fh@ez.no -Mark it's good, but it's not irssi Kretschmann markey@web.de -Max Turtle-Power Howell max.howell@methylblue.com -Mike purple is not girly! Diehl madpenguin8@yahoo.com -Pierpaolo Spaghetti Coder Di Panfilopippo_dp@libero.it - -Roman and God said, let there be Mac Becker roman@formmorf.de -Seb Surfin' down under Ruiz me@sebruiz.net -Stanislav did someone say DCOP? Karchebny Stanislav.Karchebny@kdemail.net - - - -Contributors: - - -Adam Pigg (analyzers, patches) adam@piggz.fsnet.co.uk - - - -Adeodato Simo (patches) asp16@alu.ua.es - - - -Alexandre Oliveira (improvements, bugfixes) aleprj@gmail.com - - - -Andreas Mair (MySql Support) am_ml@linogate.com - - - -Andrew de Quincey (Postgresql support) adq_dvb@lidskialf.net - - - -Christie Harris (roKymoter) dangle.baby@gmail.com - - - -Dan Leinir Turthra Jensen (first run wizard) admin@removeleinir.dk - - - -Dan Meltzer (roKymoter) hydrogen@notyetimplemented.com - - - -Enrico Ros (analyzers, king of openGL) eros.kde@email.it - - - -Florian 'da-flow' Egerer (Amarok application icon 'Blue Wolf) flo_for_never@gmx.at - - - -Gérard Dürrmeyer (icons and image work) gerard@randomtree.com - - - -Greg Meyer (Fabulous help with our pre 1.2 bug-avalanche) greg@gkmweb.com - - - -Harald Sitter (roKymoter, translations, bug fixes, screenshots) harald.sitter@kdemail.net - - - -Ian Monroe (patches, Ruby script template (eean) )ian@monroe.nu - - - -Jarkko Lehti (tester) grue@iki.fi - - - -Jocke Andersson (roKymoter) ajocke@gmail.com - - - -Kenneth Wesley Wimer II (icons) kwwii@bootsplash.org - - - -Kenny Lemieux (Amarok webmaster) swaft@pwsp.net - - - -Melchior Franz (new FFT routine, bugfixes) mfranz@kde.org - - - -Michael Pyne (K3B export code) michael.pyne@kdemail.net - - - -Nenad Grujicic (splash screen for 1.1) mchitman@neobee.net - - - -Olivier Bédard (website hosting) paleo@pwsp.net - - - -Reigo Reinmets (Wikipedia support, patches) xatax@hot.ee - - - -Roland Gigler (MAS engine) michael.pyne@kdemail.net - - - -Sami Nieminen (Audioscrobbler support) sami.nieminen@iki.fi - - - -Scott Wheeler (TagLib) wheeler@kde.org - - - -Stefan Bogner (Loadsa stuff) bochi@online.ms - - - -Stefan Siegel (patches, bugfixes) kde@sdas.de - - - -Sven Krohlas (roKymoter) sven@asbest-online.de - - - -Whitehawk Stormchaser (tester, patches) zerokode@gmx.net - - - - -Documentation copyright 2005 Mike Diehl madpenguin8@yahoo.com - -&underFDL; - -&underGPL; - - - -&amarok-req; - - -Installation - - -How to obtain &amarok; - -&amarok; can be downloaded from The &amarok; home page - - -The latest development version can be obtained from &kde; SVN, module -/trunk/extragear/multimedia/amarok/. - - -How to compile &amarok; - -In order to compile and install Amarok on your system, type the following in the -base directory of the Amarok distribution: - - -./configure --prefix=`tde-config --prefix` -make -su -c "make install" - - -The --enable-final configure flag is no longer supported. - -Since &amarok; uses autoconf and automake you should have no trouble compiling it. Should you run into problems please report them to the &kde; mailing lists. - - - - -Configure Options - -&amarok; is like most other apps in that it has several compile time options that can be enabled or disabled during configure. This is a list of the options that can be configured. - -Some compile time options require specific dependencies to be used. See the requirements section for more details. - - - - - - -Option -Default -Description - - - - - ---enable-debug= -no -Enables debug symbols. Choose from yes, no, and full. Please use the full option if you intend to help with &amarok; development. - - - ---enable-mysql -Disabled -Enables MySql database support for &amarok; - - - ---disable-amazon -Enabled -Disables Amazon cover art downloading support in &amarok; - - - ---without-arts -With -Disables aRts support for &amarok; - - - ---without-gstreamer -With -Disables GStreamer support for &amarok; - - - ---with-helix -With -Enables Helix engine support for &amarok; - - - ---without-xine -With -Disables xine support for &amarok; - - - ---with-nmm -Without -Enables NMM support for &amarok; - - - ---with-mas -Without -Enables MAS support for &amarok; - - - ---without-opengl -With -Disables OpenGL (analyzer) support for &amarok; - - - ---without-included-sqlite -With -Do not use the included sqlite sources (requires sqlite to be installed) - - - - - - - - - - - - -&documentation.index; - - diff --git a/doc/amarok/logo.png b/doc/amarok/logo.png deleted file mode 100644 index be5465c5..00000000 Binary files a/doc/amarok/logo.png and /dev/null differ diff --git a/doc/amarok/media_device.png b/doc/amarok/media_device.png deleted file mode 100644 index 8f7f6ec0..00000000 Binary files a/doc/amarok/media_device.png and /dev/null differ diff --git a/doc/amarok/menubar.png b/doc/amarok/menubar.png deleted file mode 100644 index 8d1b7f86..00000000 Binary files a/doc/amarok/menubar.png and /dev/null differ diff --git a/doc/amarok/musicbrainz.png b/doc/amarok/musicbrainz.png deleted file mode 100644 index a87e056a..00000000 Binary files a/doc/amarok/musicbrainz.png and /dev/null differ diff --git a/doc/amarok/pl_tip1.png b/doc/amarok/pl_tip1.png deleted file mode 100644 index 738dda56..00000000 Binary files a/doc/amarok/pl_tip1.png and /dev/null differ diff --git a/doc/amarok/play_list.png b/doc/amarok/play_list.png deleted file mode 100644 index 58df3172..00000000 Binary files a/doc/amarok/play_list.png and /dev/null differ diff --git a/doc/amarok/player_window.png b/doc/amarok/player_window.png deleted file mode 100644 index 69053b46..00000000 Binary files a/doc/amarok/player_window.png and /dev/null differ diff --git a/doc/amarok/playlist_browser.png b/doc/amarok/playlist_browser.png deleted file mode 100644 index 282a9fc0..00000000 Binary files a/doc/amarok/playlist_browser.png and /dev/null differ diff --git a/doc/amarok/playlist_window.png b/doc/amarok/playlist_window.png deleted file mode 100644 index 0a5aac81..00000000 Binary files a/doc/amarok/playlist_window.png and /dev/null differ diff --git a/doc/amarok/queue_manager.png b/doc/amarok/queue_manager.png deleted file mode 100644 index 762ba8d2..00000000 Binary files a/doc/amarok/queue_manager.png and /dev/null differ diff --git a/doc/amarok/quick.docbook b/doc/amarok/quick.docbook deleted file mode 100644 index f47059a3..00000000 --- a/doc/amarok/quick.docbook +++ /dev/null @@ -1,85 +0,0 @@ - -&amarok; Quick Start Guide - -Listening to music should be easy. To this end we have provided a First-Run Wizard which presents itself the first time &amarok; is run. For those who wish to update their collection later on, or not use the wizard, this Quick Start Guide is for you. It will help you have &amarok; up and running in minutes. - - - -Building a collection - - - Collection Browser Screenshot - - - - - -Building your collection is an essential step in using all of &amarok;'s features. From the Collection Browser, click the Configure Folders button located in the toolbar. Next you will choose which folders you would like to be in your collection from the Configure Collection dialog. Also from here you have the option to Scan folders recursively, Watch folders for changes, and Import playlists that are found in the collection folders. After selecting your folders, and checking any relevant check boxes, click the OK button. After the initial scan, your collection is built and you can move on to making a playlist. - - - - - -Making a playlist - - - Playlist Screenshot - - - - - - - -Making a playlist is as simple as dragging items from the Collection Browser Tree View into the Playlist. To make searching for items easier, a text box is provided for filtering your collection. Just start typing in the text box, and the Tree View will change to show only the relevant results. After you are satisfied with your playlist, you can save it by clicking the Save Playlist As button found in the Playlist menu. - - - Playlist Browser Screenshot - - - - - -If you have your own playlists, you can add them in the Playlist Browser by clicking the Add button and choosing the Playlist... option in the toolbar. If your collection folders have your playlists in them, and you selected the Import Playlists in the collection setup, your playlists will already be in the Tree View. Right clicking a playlist in the Tree View will give you several options of how to load the playlist. - - - - - -Listening to streams - -Radio streams in &amarok; are played by adding them from the Playlist Broswer. &amarok; comes with a select set of streams for our listeners to enjoy, Cool Streams. Double-cliking or dragging an entry will load it into the playlist and once there it can be played. To add your own streams to the Playlist Browser click on the Add button in the toolbar and choose Radio Stream... from the dropdown box options. After adding your custom stream it can also be played after loading into the playlist. - - - - - -Playing an audio cd - - - Playlist Menubar Screenshot - - - - - - - - -To play an audio cd, select ActionsPlay Audio CD in the Playlist Menubar. The File Browser will open showing several folders and also the cd tracks listed in the WAV format. Drag the WAV files into the playlist and click the Play button. - -The Play Audio CD feature uses the audiocd:/ protocol and is not compatible with all of the available engines. - - - - -Burning an audio cd - -Burning an audio cd in &amarok; is easy thanks to the K3B integration. To burn an album, first open the Collection Browser. Next, by expanding an artist's entry in the Tree View, right click the album you wish to burn. A pop-up menu will open, click Burn This Album, and a dialog will open prompting you to choose a mode for burning. From the dialog click the Audio Mode button, K3B will open ready to burn the album. - -Burning functionality is also provided in the Playlist. Simply right click an item in the Playlist and follow the Burn menu for multiple cd burning options. - - - - - \ No newline at end of file diff --git a/doc/amarok/requirements.docbook b/doc/amarok/requirements.docbook deleted file mode 100644 index e8a85499..00000000 --- a/doc/amarok/requirements.docbook +++ /dev/null @@ -1,40 +0,0 @@ - -Requirements - -&amarok; requires the installation of some software packages. The required packages are listed below along with several other packages to enhance your &amarok; experience. - - - -Required: -KDELIBS 3.3 -TagLib 1.4 - - - -Recommended: -GStreamer-0.8.6 and Gst-Plugins-0.8.6 - - - -Optional: -aRts 1.3 -K3B 0.11 -KDE-Base 3.3 (needed for Konqueror Sidebar) -KDEMULTIMEDIA 3.3 -libtunepimp 0.3 -Libvisual 0.2.0 and Libvisual plugins -MAS 0.6.3 -MySQL 4 -NMM 0.7.0 -OpenGL accelerated X-Server -ProjectM 0.96 -Real Player 10 -SDL 1.2 -xine 1.0.0 -XMMS 1.2 and XMMS visualization plugins - - -If you obtain these dependencies via a packaging system, you must -also install the devel versions of these packages! - - diff --git a/doc/amarok/rmb_menu.png b/doc/amarok/rmb_menu.png deleted file mode 100644 index e32dd142..00000000 Binary files a/doc/amarok/rmb_menu.png and /dev/null differ diff --git a/doc/amarok/script_manager.png b/doc/amarok/script_manager.png deleted file mode 100644 index 28d94f4a..00000000 Binary files a/doc/amarok/script_manager.png and /dev/null differ diff --git a/doc/amarok/status_bar.png b/doc/amarok/status_bar.png deleted file mode 100644 index 0a2ff065..00000000 Binary files a/doc/amarok/status_bar.png and /dev/null differ diff --git a/doc/amarok/tab_lyrics.png b/doc/amarok/tab_lyrics.png deleted file mode 100644 index 284414db..00000000 Binary files a/doc/amarok/tab_lyrics.png and /dev/null differ diff --git a/doc/amarok/tab_music.png b/doc/amarok/tab_music.png deleted file mode 100644 index e87e689a..00000000 Binary files a/doc/amarok/tab_music.png and /dev/null differ diff --git a/doc/amarok/tab_wiki.png b/doc/amarok/tab_wiki.png deleted file mode 100644 index 60f00195..00000000 Binary files a/doc/amarok/tab_wiki.png and /dev/null differ diff --git a/doc/amarok/using.docbook b/doc/amarok/using.docbook deleted file mode 100644 index 03bb95cb..00000000 --- a/doc/amarok/using.docbook +++ /dev/null @@ -1,1270 +0,0 @@ - -Using &amarok; - -&amarok; is a versatile audio player that offers many different ways of controlling your music collection. Like any ordinary audio player, &amarok; has a player window for controlling your most basic functions. &amarok; also has a playlist that is second to none. The playlist window has multiple browsers for creating and browsing your entire audio collection. - -In this chapter we will go over how to use all the features of &amarok; including creating a collection and a playlist. - - -The Player Window - - - Player Window Screenshot - - - - - - - - -The player window is your one click &amarok; control center. At the top of the player there is a scrolling display to show the currently playing track or stream. Just below the scrolling display there is an area to display the current track's play time, bit rate, and sample rate. Clicking this area will change the track time from total played to total time remaining. - -The player window also features a selection of audio analyzers also located under the scrolling display. You can cycle through the available analyzers by left clicking the analyzer area. - - - - - - - Analyzer Tip - - - - - - - -The &amarok; player analyzers can be detached from the player window. By pressing d on your keyboard the active analyzer will open in an independent, re-sizeable window. - - -Also below the scrolling display are the PL and EQ buttons. The PL button is used to quickly enable or disable the playlist window, while the EQ button is used to enable and disable the equalizer if your engine is compatible. - -The remainder of the player includes the playback buttons and the volume and track position sliders. Use the sliders to choose a track postion or volume level that suits your needs. Use the playback buttons to control the playback of the current track, or to skip either forward or back through your tracks. - - - - -The Equalizer Window - -The built in equalizer is easy to use and works with all engines. There are 17 presets included, ranging from Classical to Techno, and you can easily create your own. - -To access the equalizer choose ToolsEqualizer from the main window or click the EQ button from the Player window. Once you check the Enable Equalizer check box in this window, the equalizer will be active. - - - Equalizer Screenshot - - - - - - - -You can use the dialog's drop down box to select one of the built in presets. You can also adjust individual sliders here. Adjusting a slider will automatically cause a switch to the Manual preset so feel free to experiment with them until you find a desirable combination. When you are ready to save, click the Add new preset icon to the right of the drop down box. If you change to another preset without saving your changes they will be lost. In addition to saving you can also click the Manage presets icon, to the right of the drop down box, to delete or rename presets. - - - - -The Playlist Window - - - Playlist Window Screenshot - - - - - - - -The &amarok; playlist is the most advanced playlist available to any audio player for &kde;. The playlist offers many features that are not found in any other player. You should not be intimidated by the power of the playlist however, as it is still the easiest to use. - -The playlist window can be divided into two main sections, on the left is the sidebar. The sidebar is where you will find some of the excellent features of the playlist like the Context Browser. On the right side of the window is the playlist itself. The playlist is simple to use yet powerful enough for even the most advanced users. - - - - -The Sidebar Browsers - -Browsers in &amarok; allow you to acess your music collection in several different ways. They are situated on the left side of the window, and each one is represented by a tab with its name written on it. Clicking on a tab brings the selected browser into view. If a browser is active clicking on its tab again will contract the browser. Only one browser is visible at any time, although you can drag tracks from one tab to another by hovering on the target tab for 1 second until that tab becomes visible. You can also hide browsers by simply right-clicking on any tab and (un)selecting the desired browser(s) in the provided context menu. - - - Browser Selection Screenshot - - - - - - -Context Browser - -The Context Browser displays various information related to the currently playing track. Its appearance can be modified by using themes known as Context Browser Styles. It is organized into three tabs: Music, Lyrics, and Artist. These tabs, whose function will be more fully explained below, supply information on different aspects the track currently being listened to. - -Users of previous &amarok; versions will notice that there is no longer a Home tab. The information from this tab has been redistributed throughout the &amarok; interface. Analogous information can be found mainly in the Statistics dialog, accessible through ToolsStatistics. - - - Context Screenshot - - - - - - - -The Music Tab - -The Music tab offers information about the currently playing track, and it's artist and album. - -The first pane in this tab is for information about the track. The title of the pane lists the track name, artist name, and album. Inside the pane you will find it shows the album cover image for the track. Next to the image you will find a MusicBrainz icon. Click this icon to do a MusicBrainz look-up for the track. - -Below the MusicBrainz icon there is more information about you current track. Here you will find the total number of times the track has been played, the track's current core, and when the track was first and last played. - -To display album cover images in the Context Browser you must have the album cover image in the same directory as the track you are listening to. Supported file formats are .jpg, .jpeg, .gif, and .png. The images can be named anything, but images with the word front in the filename will be used with preference. The Context Browser will also use cover images saved from the album cover downloader, or images embedded in ID3v2 tags. - -The next pane, Suggested Songs, lists multiple tracks for suggested listening. Click on any of the listed tracks to begin playback of the track. - -Below Suggested Songs is the Favorite Tracks By Artist. This pane lists the five highest rated tracks by the current track's artist. - -You can adjust the amount of information shown in the Music tab by right-clicking anywhere on Music tab and toggling items on the context menu. - -The last pane, Albums By Artists, lists all of the albums by the current track's artists that are in your collection. Clicking on any of the albums in this pane will expand the album to show the album's content. - -You can click on tracks in any of the panes to begin playback of the track. You can also right click albums and tracks for a pop-up menu to choose several ways to play or enqueue the track or album. - - - - - -The Lyrics Tab - -Lyrics tabs fetches lyrics for the currently played song from one of the supported websites. This feature is flexible, and it's possible to write scripts to fetch lyrics from different sites. See Chapter on Script-Writing. When you click on the Lyrics tab, &amarok; attempts to fetch lyrics for the current track. If there is no lyrics script running you will be given the opportunity to select one. - - - Lyrics Screenshot - - - - - - -You can perform various actions on the lyrics tab, using its toolbar buttons. - -The Add button opens (in an external browser) the Add Lyrics page on the lyrics website, depending on which script you run. - -The Edit button allows you to edit lyrics for the current track. They are then stored in &amarok;'s collection database. This does not require a lyrics script to be active. - -The Search button launches a google.com search (in an external browser) for the lyrics of the current track. - -The Refresh button clears cached lyrics for current track, and searches again. - -Open in external browser displays the current track's lyrics in your external browser. - - - - -The Artist Tab - - - Artist Tab Screenshot - - - - - -The Artist tab shows Wikipedia article about currently played artist. Toolbar contains: - - - -Navigational buttons for moving forward or backward - - -Page buttons for jumping to artist's, album's or track's Wikipedia page, - - -A button for opening current page in external browser - - -A configuration button for setting the Wikipedia locale - - - - - - - - - -Collection Browser - - - Collection Browser Screenshot - - - - - -The Collection browser is the heart of &amarok;. The entire collection is viewable here and sorted using various groupings. Within each grouping, everything is always alphabetical, symbols and numbers first, and case insensitive. In every grouping method, tracks that have unknown artists and/or albums are always grouped at the start of your collection, under Unknown. Although track numbers are not shown, tracks are listed in their album order. Clicking the header of the collection list reverses the sort order. Left-clicking on the expand icon to the left of any entry in your collection will expand that entry. - -The Group By pull-down menu allows you to group your collection in several ways: - - - -Group ByArtist - Top level sort only, every track is grouped under its artist, with no consideration given to albums or genres. - - -Group ByArtist/Album - Tracks are sorted into artists, and then beneath this, sorted by album. If you want to see compilation or soundtrack albums, this is the best way to view your collection - these albums are grouped together at the very begin of your list, under Various Artists. - - -Group ByArtist/Year-Album - Sorts by artist, with albums in descending order of year (most recent first). If there is no Year tag set for a track, the default 0 - album name. - - -Group ByAlbum - Every album in your collection is displayed alphabetically based on the album name, regardless of artist. - - -Group ByGenre/Artist - Tracks are grouped according to their genre tag, then by artist. - - -Group ByGenre/Artist/Album - Same as above, only with tracks sorted by album, below each artist. - - - - -The remaining items on the pulldown menu allow you to customise the grouping with any combination of the above. - -The next two icons on the toolbar change the way your collection is viewed. The first, Tree View, is the default view, and the one you'll probably see the most. The next button enables Flat View, which at first appears empty. Typing search terms in the text entry box immediately below the toolbar will begin to populate your collection, which can be sorted in a variety of ways, by left-clicking on the column headers. right-clicking on the column headers will pop up a context menu allowing you to change the columns shown. - -The last icon in the toolbar lets you change your collection setup. Note that if you change any folders, &amarok; will automatically rescan your collection - this may take quite some time if you have many tracks. - -Immediately below the toolbar is a search filter, which behaves the same in both Flat and Tree views. See the Playlist section of the handbook for more details on searching techniques. - -Below the Search Filter, another pull-down menu lets you see the most recently added tracks to your collection. Several time periods are available, ranging from the last 24 hours, to 1 year, or your entire collection. - - -The Collection Browser &RMB; Options -The following options are accessible by clicking with the &RMB; on entries in the collection browser. - -Load - Clears the current playlist and adds selected track(s) as first track(s), in sort order. - -Append to Playlist - Adds selected track(s) to end of current playlist. Double clicking on a single track in the collection also achieves the same result. - -Queue Tracks - Adds the selected track(s) to the queue as the next to be played. - -Save as Playlist - Save the selected tracks as a playlist. You'll be prompted for a name to save as. - -Add to Media Device Transfer Queue - Adds track(s) to a queue, ready to be transferred to a media device, when such a device is attached. See Media Device Browser section for more detail. - -Burn All Tracks By This Artist/Burn To CD - Sends track(s) to &k3b; for burning as either a data or Audio CD. If &k3b; is not installed, this option is not selectable. - -Fetch Cover Image - Searches amazon.com for a cover image for this album. - -Edit Information for (n) Tracks - Opens the Track Information dialog and allows you to change tags for one or more tracks. - -Manage Files - - - -Organize (n) Files - Opens Organize Collection Files dialog. - - - -Delete (n) Files - Pops up a confirmation dialog asking whether you want to permanently delete the selected track(s) from your computer. - - - -Mark As Compilation - Sets the selected album as a compilation album, to be listed under Various Artists - -Unmark As Compilation - Changes an album marked as a compilation to a normal album, and moves the listing from Various Artists, to back under the artists listed. - - - - - - -Playlist Browser - - - Playlist Browser Screenshot - - - - - -The Playlist Browser is used for easy handling of your multiple playlists. The Playlist Browser also features built in smart playlists making it the most clever playlist browser around. - -The Playlist Browser is divided into two sections, Playlists and Smart Playlists. The Playlists sections is for your own custom playlists. You can view the contents of your playlists in a list view by clicking the + symbol found next to each of the listed playlists. When you view a playlist in the list view new items can be added to the playlist by dragging and dropping them into the view. When you have found a playlist that you would like to load, you can double click the playlist, or press the Space Bar to have &amarok; load it. The other Playlist Browser keyboard shortcuts can be found in the Keyboard Shortcuts section. - -When you save a new playlist from the Playlist Window it is automatically added to the Playlist section. - -The bottom section of the Playlist Browser is the Smart Playlists. The Smart Playlists use &amarok;'s built in data base to compile some useful playlists on the fly. The Smart Playlists include the following: - - - -All Collection: a playlist with all the tracks that are in your configured collection. - - - -Favorite Tracks: multiple playlists of the fifteen highest rated tracks in a listview by artitst. - - - -Most Played: multiple playlists of the fifteen most played tracks in a listview by artitst. - - - -Newest Tracks: multiple playlists of the fifteen most recently added tracks in a listview by artitst. - - - -Last Played: a playlist of the fifteen most recently played tracks in your collection. - - - -Never Played: a playlist of the tracks in your collection which have never been played before. - - - -Genres: multiple playlists in a listview ordered by genre. - - - -User defined smart playlists are also possible. Clicking the Create Smart-Playlist button will open a dialog to configure a smart playlist to fit your criteria. - - - - - - -Media Device Browser - - - Media Device Browser Screenshot - - - - - -The Media Device panel is used for connecting your iPod, to &amarok;. To use your iPod with the Media Device browser you must have your iPod mounted at /mnt/ipod before starting &amarok;. Once you have started &amarok; you will find the tracks on your iPod listed by artist in a listview at the top of the browser. - -To add tracks to your iPod, drag the tracks you want to add from the playlist and drop them on the Artist listview. After you are done adding tracks to the list click the Transfer button to upload them to your iPod. After the transfer has completed, close &amarok; and unmount your iPod. - - - - -File Browser - - - File Browser Screenshot - - - - - -The File Browser panel is like a mini konqueror embedded into the playlist. You can use the File Browser panel to browse your entire filesystem for audio files to add to the playlist. At the top of the File Browser you will find a toolbar with navigation buttons for moving Up, Back, and Forward through your filesystem. The tool bar also offers a Home, Reload, Short view and Detailed view buttons, it also features a Bookmarks button for creating bookmarks of your favorite filesystem areas. - -Below the toolbar is a handy search bar for searching by file name. You will find the search bar useful for directories with many files as it searches as you type leaving only the relevant file names in the view. - -At the bottom of the File Browser is an address bar for accessing your music from any URL that you type. For instance typing tar:/home/mike/music.tar.gz into the address bar and pressing Enter on your keyboard will allow you to access the files inside the music tar ball. Now you can drag the audio from the tar ball and drop it into the playlist. - -When playlist grows larger than one screenful, it becomes hard to append files by simply dropping them. Holding Shift key on keyboard while dropping may help in this case: the files will be appended at the end of playlist rather than inserted at current drop position. - - - - - - - -The Playlist - - - Playlist Screenshot - - - - - - - -The Playlist holds all the tracks you have en-queued for playing. You can change the sequence by dragging items around with the mouse, and dropping them in the desired position. Above the Playlist you see a Text Box, where you can enter a filter string. As soon as you enter a letter there, the Playlist will be redisplayed, showing only entries containing the entered characters. To stop the filtering, simply press Backspace, until the filter is empty. - -Advanced, Google-esque syntax is also available. - -By default, when you enter terms separated by spaces, it will search for items containing all of them. -For example: one two three, will search for anything that contains one, two, and three. - -However, you can put OR between terms to search for items that contain either, like this: one OR two OR three. -That way, it will search for items that contain either one, or two, or three (or a combination of them). - -You can also use quotes to search for terms with spaces in them: "Mike Oldfield". -That will search for items that contain Mike Oldfield, but not, for example, ones that contain Mike J. Oldfield. - -By default, it searches in all the columns of the playlist that are currently visible. However, you can use column:term to specify the column to search in: title:amarok (this can also be a column that isn't visible). -This way, it will only search for items that have the word amarok in the title, and not, for example, in the album. - -When specifying a specific column to search in, you can also search for items less than or greater than a term, for example: score:>50, which will search for items with a score greater than 50. - -To specify a term you don't want the items to match, you can put a minus (-) sign before them: -thing, to search for anything that doesn't contain thing. - -You can combine the above at will, for example: "Mike Oldfield" OR score:>50 -comment:bad. That will search for anything that either contains Mike Oldfield or has a score greater than 50, but excludes items where the comment contains "bad". - - - - - Playlist Tip - - - - - - - -You can select items to be played in a specific order by holding Control and clicking the &RMB; on items in the order in which you wish them to be played. The items will be tagged with a number showing the order in which you selected them. - - - - - - -The Playlist Menubar - - - Playlist Menubar Screenshot - - - - - - - - -The Actions Menu - - - - -Actions -Play Media... - -Opens a dialog for entering an URL. - - - - -Actions -Play Audio CD - -Allows you to view and play an Audio CD using the audiocd:/ protocol. - - - - - -WinZ - -Actions -Previous Track - -Move to the previous track in the playlist. - - - - -Actions -Pause - -Pauses the playback of the current track. - - - - - -WinZ - -Actions -Stop - -Stops playback. - - - - - -WinZ - -Actions -Next Track - -Move to the next track in the playlist. - - - - - -CtrlQ - -Actions -Quit - -Quits &amarok;. - - - - - - -The Playlist Menu - - - - - -CtrlO - -Playlist -Add Media... - -Opens a dialog to add media to your current playlist. - - - - - -CtrlS - -Playlist -Save Playlist As... - -Opens a dialog to save your current playlist. - - - - - -CtrlZ - -Playlist -Undo - -Undo the last change to the playlist. - - - - - -CtrlShiftS - -Playlist -Redo - -Reverts changes made by Undo. - - - - -Playlist -Clear - -Clears the current playlist. - - - - - -CtrlH - -Playlist -Shuffle - -Shuffles the ordering of the current playlist. - - - - - -CtrlEnter - -Playlist -Goto Current Track - -Moves the playlist to the currently playing track. - - - - - -CtrlD - -Playlist -Queue Selected Tracks - -Queues all selected tracks in the playlist. - - - - -Playlist -Remove Duplicates & Dead Entries - -Remove all duplicate or dead entries in the current playlist. - - - - - -CtrlA - -Playlist -Select All - -Selects all the tracks in the current playlist. - - - - - - - -The Tools Menu - - - - -Tools -Cover Manager - -Opens the Cover Manager. - - - - -Tools -Queue Manager - -Opens the Queue Manager. - - - - -Tools -First-Run Wizard - -Opens the First-Run wizard. - - - - -Tools -Visualizations - -Opens the Visualizations dialog. - - - - -Tools -Equalizer - -Opens the Equalizer Window. - - - - -Tools -Scripts - -Opens the Script Manager. - - - - -Tools -Rescan Collection - -Starts a manual scan of your collection folders. - - - - - - -The Settings Menu - - - - - -CtrlM - -Settings -Hide Menubar - -Hide the Playlist Window Menubar. - - - - -Settings -Hide Toolbar - -Hide the Playlist Window Toolbar. - - - - -Settings -Hide Player Window - -Hide the Player Window. - - - - -Settings -Repeat Track - -Repeat playback of the current track. - - - - -Settings -Repeat Playlist - -Repeat playback of the current playlist. - - - - -Settings -Random Mode - -Randomizes the order of playback of the tracks in the playlist. - - - - -Settings -Dynamic Mode - -Starts the dynamic playlist mode. - - - - - -Settings -Configure Global Shortcuts... - -Opens the global shortcut configuration dialog.. - - - - -Settings -Configure Shortcuts... - -Opens the &amarok; shortcut configuration dialog.. - - - - -Settings -Configure Toolbars... - -Opens the &amarok; toolbar configuration dialog.. - - - - -Settings -Configure Amarok... - -Opens the &amarok; configuration dialog.. - - - - - - - -The Help Menu - - - - - -F1 - -Help -Amarok Handbook - -Opens this documentation. - - - - - -ShiftF1 - -Help -What's This - -Activates the What's This mouse cursor. - - - - -Help -Report Bug... - -Starts the bug reporting tool. - - - - -Help -about Amarok - -Opens the about Amarok dialog. - - - - -Help -about KDE - -Opens the about KDE dialog. - - - - - - - - - -The Playlist Toolbar - - - Playlist Toolbar Screenshot - - - - - - - -The Playlist Window Toolbar is found near the bottom of the Playlist Window. The Toolbar contains buttons for many of the Playlist actions. On the right side of the Toolbar you can find the Add Media button, which opens a file dialog to add your media files to the playlist. Following the Add Media button are the Save Playlist, Clear Playlist, and Refresh Playlist buttons. You can use these buttons for handling the current Playlist. - -The next set of buttons are the Undo, and Redo buttons. You can use these buttons to Undo or Redo any changes made to the playlist. - -In the center of the Toolbar you can find a unique, re-sizeable analyzer. You can adjust the refresh rate for the analyzer by using the &RMB; menu, and selecting your desired frame rate. - -The last button in the Toolbar is the Menu button. The Menu button opens the same menu as the Player Window &RMB; menu. You can use this menu for accessing the &amarok; configuration options. - -There are many other buttons available for the Toolbar including player control buttons and a volume slider. You can configure what buttons are in the Toolbar by clicking the Menu button and selecting Configure Toolbars... - - - - -The Playlist Status Bar - - - Status Bar Screenshot - - - - - - - -The Status Bar provides quick access to some useful information about the playlist. The Status Bar displays the current track's title, the number of tracks in the playlist along with the total playlist time, Random and Repeat status, a mini track position slider, and the current track's play time. You can change the Random and Repeat status by double clicking there respective areas in the status bar. - -You can also choose to not have the Status Bar displayed using the Show statusbar option in the Configure General Options Dialog. - - - - -The Right Mouse Button Menu - - - RMB Menu Screenshot - - - - - - - -The &RMB; menu can be found by right clicking the player window, it can also be found by clicking the Menu button in the playlist window. The &RMB; menu is used for access to all of &amarok;'s options. - - - - - -Repeat Track - -This option when enabled repeats playback of the current track. - - - - - -Repeat Playlist - -This option when enabled repeats playback of the entire playlist. - - - - - -Random Mode - -This option when enabled randomizes the playback of the tracks in your playlist. - - - - - -Append Suggestions - -Appends the suggested songs in the Context Browser to the current playlist. - - - - - -Cover manager - -Opens the Cover Manager. - - - - - -First-run Wizard - -Clicking this option starts the first-run wizard for the initial configuration of &amarok;. - - - - - -Visualizations... - -Clicking this option opens the Visualizations Window for choosing what visualizations to use with &amarok;. - - - - - -Equalizer - -Opens the Equalizer Window. - - - - - -Script Manager - -Opens the Script Manager dialog. - - - - - - -Configure Toolbars... - -Clicking this option opens a dialog to configure the Playlist Toolbar. - - - - -Configure Shortcuts... - -Clicking this option opens a dialog to configure the &amarok; Shortcuts. - - - - - -Configure Global Shortcuts... - -Clicking this option opens a dialog to configure the global &amarok; Shortcuts. - - - - -Configure Global Amarok... - -Clicking this options opens the &amarok; Configuration Dialog. - - - - -Help - -This entry provides a sub-menu providing links to this document and other &amarok; information. - - - - -Quit - -This entry when clicked will quit &amarok;. - - - - - - - - -Album Cover Manager - - - Album Cover Manager - - - - - - - -The Album Cover Manager is a useful tool for managing your album covers. You can start the Cover Manager by selecting ActionsCover Manager in the Collection Browser. - -The cover manager provides a listview of all the albums in your collection. You can view all of your album covers for an artist by clicking on the artist in the list view. - -The cover manager provides a search bar for searching in your album covers. The cover manager will search your albums for the search criteria you type in the search bar. - -The View menu allows you to choose what is displayed in the cover manager. You can choose from: - -All albums which displays all your albums in your collection. - -Albums with cover which displays only the albums that have cover images. - -Albums without cover which displays only the albums that do not have cover images. - -The Fetch Missing Covers button is used to download cover images for your albums that do not already have cover images available. - - - -The Queue Manager - - - Queue Manager Screenshot - - - - - - - -The Queue Manager makes it's grand entrance in &amarok; 1.3. This feature is designed to enable users to have even more control over their playlists. After queuing, a track a number will be shown beside it in the Queue Manager. This number indicates the order in which &amarok; will play the track: one will be first, two will be second, and so on. - -You can use the Queue Manager by opening it from Tools Queue Manager, selecting the track, and then pressing the + icon in the Queue Manager. You can also just drag tracks to the Queue Manager to create a queue. Alternatively, the playlist's context menu may also be used and the Queue Manager can then be opened in order to modify the order. - - - - -Dynamic Playlists - - - What Are They? - - Dynamic Playlists are self-generating playlists, created according to defined rules, which are used to keep the current playlist to a manageable size. Whilst &amarok; is fairly light on resources while running, loading a large number of tracks into a playlist at once increases RAM usage, possibly impacting on system performance, which is avoided completely by using Dynamic Playlists. Also known as Party Mode, they are also a great way to keep the music playing all night with no interaction. - - - - - Where Are They? - You can find Dynamic Playlists in the Playlists Sidebar. - - - Playlist Sidebar - - - - - Playlist Sidebar - - - - - There are three types of Dynamic Playlists, referred to as Dynamic Modes, two of which are predefined (more details on configuring this later). - - - - Random Mix - Initialises a playlist with random tracks from you're entire collection, and keeps adding random tracks. - - - - - Suggested Songs - - Adds tracks based on last.fm (formerly audioscrobbler) suggestions. Requires some tracks already in the playlist. Note you do not need a last.fm profile for this to work. - - - - - Playlist Shuffle (user-created) - Adds random tracks from specified Smart Playlists, either built-in or user defined. - - - - - - - How Do I Use Them? - Simply double-click your desired playlist, drag it to the playlist window, or right-click and select Load. This will replace your current playlist, so you may want to save that first if it's important to you. - Both Random Mix and Playlist Shuffle will populate your playlist and allow you to start playing immediately. Suggested Songs will start with an empty playlist, requiring you to add at least one song from your collection manually. The suggestions are added on a track change, so your playlist will not be populated until the end of the first song. - If you wish to retain your current playlist, you can enable the last type of Dynamic Mode used by selecting Settings Dynamic Mode. This will use your existing playlist as a starting point. You can disable Dynamic Mode via the same menu option. - - Dynamic Playlist loaded - - - - - - Dynamic Playlist loaded - - - - - The Repopulate button will clear your playlist and re-add tracks according to the Dynamic Mode you are using, and the Edit this Dynamic Mode button will pop up the Dynamic Mode Settings dialog. These buttons will not appear if you have Dynamic Mode disabled. - - - - -Configuring Dynamic Playlists - - Changing the Behaviour of a Dynamic Playlist - Right-clicking on a Dynamic Playlist will allow you to select Edit, which opens the Dynamic Mode Settings dialog box. - - - Dynamic Mode Settings - - - - - - - - - - - Dynamic Playlist Name - - Rename to anything you like, if you so desire. Playlist names should be unique, to avoid confusion. - - - - - Remove played tracks - - If you uncheck this, your playlists will continually grow, the Upcoming Tracks setting is overridden, and you will not get repeats in your playlist. If the setting is checked, played tracks are removed from the start of the list, according to the Played tracks to show setting below. - - - - - Mark history - - Greys out tracks that have been played. - - - - - Played tracks to show - - Played tracks to show - number of played tracks to leave showing at the start of the playlist. Useful for seeing what has been played recently. - - - - - Upcoming tracks - - This is the setting that restricts the size of your playlist. - - - - - Tracks to append - - The number of tracks that will be added to your playlist after each song is played. Note that if you set this greater than 1, your playlist will grow rapidly, as only one track can be played then removed at a time. - - - - - You can also access this dialog via the Edit this Dynamic Mode button at the top right of your playlist window. - - - Dynamic Mode Bar - - - - - - - - - - - Adding a Custom Dynamic Playlist - Right-click on Dynamic Playlists and select New Dynamic Playlist. - - - Create New Dynamic Playlist - - - - - - - - - The settings on the right are as described in the previous section. In the panel on the left, you can select from any of the existing playlists and smart playlists on your system. If you select multiple playlists, &amarok; will add random tracks from each of these. - - - - -The Script Manager - - - Script Manager Screenshot - - - - - - - -The script interface provides a simple way to extend the functionality of &amarok;. To run an &amarok; script, start the Script Manager by selecting ToolsScript Manager in the &amarok; Menubar. In the Script Manager dialog you will find a listview of your installed scripts, select a script from the listview and click the Run button to launch the script. The &amarok; script will run until it has finished, or is manually stopped by selecting the script in the Script Manager and clicking the Stop button. - -Some scripts provide special configuration options. To access these options first run the script and then click the Configure button to access the script's configuration dialog. - -To install new &amarok; scripts click the Install Script button in the Script Manager dialog. A select file dialog will open allowing you to select an &amarok; script package. After selecting a package to install a new entry for the script will appear in the listview. You can also install new scripts by clicking the Get More Scripts button, which opens a Dialog for downloading and installing scripts automatically from the internet. - -You may also find that there are scripts that you no longer use. To uninstall a script select the script in the Script Manager listview and click the Uninstall button. - -If you are looking for information on writing an &amarok; script, please see the Script Writing section of this document. - - - - -The Visualizations - - - Visualizations Screenshot - - - - - - - -The Visualizations Window is used to enable your available visualizations with &amarok;. A list of your available visualizations will be provided in the window. To enable a visualization check the provided checkbox for the specific visualization. - - - - diff --git a/doc/amarok/vis_window.png b/doc/amarok/vis_window.png deleted file mode 100644 index 89afa82e..00000000 Binary files a/doc/amarok/vis_window.png and /dev/null differ diff --git a/doc/da/CMakeLists.txt b/doc/da/CMakeLists.txt deleted file mode 100644 index fa47e2bc..00000000 --- a/doc/da/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# - -tde_create_handbook( LANG da DESTINATION amarok ) diff --git a/doc/de/CMakeLists.txt b/doc/de/CMakeLists.txt deleted file mode 100644 index ecc4f567..00000000 --- a/doc/de/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# - -tde_create_handbook( LANG de DESTINATION amarok ) diff --git a/doc/en/Makefile.am b/doc/en/Makefile.am new file mode 100644 index 00000000..5996bada --- /dev/null +++ b/doc/en/Makefile.am @@ -0,0 +1,3 @@ +KDE_LANG = en +KDE_LANG_C = en +KDE_DOCS = AUTO diff --git a/doc/en/add_dynamic.png b/doc/en/add_dynamic.png new file mode 100644 index 00000000..2442e8b3 Binary files /dev/null and b/doc/en/add_dynamic.png differ diff --git a/doc/en/advanced.docbook b/doc/en/advanced.docbook new file mode 100644 index 00000000..9f0908eb --- /dev/null +++ b/doc/en/advanced.docbook @@ -0,0 +1,1110 @@ + +Advanced Amarok features + + + +Keyboard Shortcuts + +&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 Configure Global Shortcuts... The &amarok; shortcuts can be configured by right clicking the Player window and selecting Configure Shortcuts... + +You can assign you multimedia keys to work as &amarok; shortcuts making your keyboard an &amarok; control center. + +The global shortcuts are: + + + + + + +Key Combination +Action + + + + + +WinX +Play + + + +WinC +Pause + + + +WinV +Stop + + + +WinB +Next Track + + + +WinZ +Previous Track + + + +WinKP_Add +Increase Volume + + + +WinKP_Subtract +Decrease Volume + + + +WinShiftKP_Add +Seek Forward + + + +WinShiftKP_Subtract +Seek Backward + + + +WinA +Add Media + + + +WinP +Toggle Playlist + + + +WinO +Show OSD + + + +WinM +Mute Volume + + + + + + +The &amarok; shortcuts are: + + + + + + +Key Combination +Action + + + + + +CtrlC +Copy + + + +CtrlKP_Enter +Goto Current + + + +CtrlD +Queue Selected Tracks + + + +CtrlQ +Quit + + + +CtrlShiftZ +Redo + + + +CtrlS +Save Playlist + + + +CtrlA +Select All + + + +CtrlM +Show Menubar + + + +CtrlH +Shuffle + + + +CtrlZ +Undo + + + + + + + + +The Playlist Browser shortcuts are: + + + + + + +Key Combination +Action + + + + + +Space +Load Playlist + + + +F2 +Rename Playlist + + + +Backspace +Remove Playlist + + + + + + + + + +The DCOP Interface + +The Amarok DCOP interface provides you with an easy way to control Amarok with your own custom scripts. + +The DCOP interface for Amarok has many generic calls that may be found in other TDE 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 pause dcop call would look like: + +%dcop amarok player pause + + +dcop amarok collection + + + + + + +DCOP Call +Action + + + + + +int totalAlbums() +Returns the total of albums in the collection. + + + +int totalArtists() +Returns the total of artists in the collection. + + + +int totalCompilations() +Returns the total of compilations in the collection. + + + +int totalGenres() +Returns the total of genres in the collection. + + + +int totalTracks() +Returns the total of tracks in the collection. + + + +QString query( QString sql) +Queries the database via SQL. + + + +QStringList similarArtists( int artists ) +Return similar artists of the current tracks, limit to int artists. + + + +void migrateFile( QString oldURL, QString newURL ) +Move a file in the collection, keeping stats intact. + + + +void scanCollection() +Scan the collection. + + + +void scanCollectionChanges() +Scan the collection for changes only. + + + + + + + + + + +dcop amarok contextbrowser + + + + + + +DCOP Call +Action + + + + + +void showCurrentTrack() +Show the current track in the context browser. + + + +void showLyrics() +Show the lyrics tab in the context browser. + + + +void showWiki() +Show the wikipedia tab in the context browser. + + + + + + + + + +dcop amarok player + + + + + + +DCOP Call +Action + + + + + +bool dynamicModeStatus() +Return dynamic mode status. + + + +bool equalizerEnabled() +Return the equalizer status. + + + +bool isPlaying() +Return true if something is playing now. + + + +bool randomModeStatus() +Return random mode status. + + + +bool repeatPlaylistStatus() +Return repeat playlist status. + + + +bool repeatTrackStatus() +Return repeat track status. + + + +int getVolume() +Return volume in range 0-100%. + + + +int sampleRate() +Return the sample rate of the currently playing track. + + + +int score() +Return the score of the currently playing track. + + + +int status() +Return playback status: 0 - stopped, 1 - paused, 2 - playing. + + + +int trackCurrentTime() +Return current play position in seconds. + + + +int trackPlayCounter() +Return play counter for current song. + + + +int trackTotalTime() +Return track length in seconds. + + + +QString album() +Return the album of the currently playing track. + + + +QString artist() +Return the artist of the currently playing track. + + + +QString bitrate() +Return the bitrate of the currently playing track (XX kbps). + + + +QString comment() +Return the comment of the currently playing track. + + + +QString coverImage() +Return the encoded URL of the current track's cover image + + + +QString currentTime() +Return the position of the currently playing track ([h:]mm:ss format). + + + +QString encodedURL() +Return the encoded URL of the currently playing track. + + + +QString engine() +Return the current sound engine. + + + +QString genre() +Return the genre of the currently playing track. + + + +QString lyrics() +Return the lyrics of the currently playing track. + + + +QString lyricsByPath( QString path ) +Return the lyrics of a track by path. + + + +QString nowPlaying() +The title of now playing media. + + + +QString path() +Return the unencoded path of the currently playing track. + + + +QString setContextStyle( QString ) +Set the CSS style for the context browser. + + + +QString title() +Return the title of the currently playing track. + + + +QString totalTime() +Return the total length of the currently playing track ([h:]mm:ss format). + + + +QString track() +Return the track number. + + + +QString type() +Return the file type. + + + +QString year() +Return the year of the currently playing track. + + + +void configEqualizer() +Toggle equalizer config dialog. + + + +void enableDynamicMode(bool enable) +Switch Dynamic Mode on or off. + + + +void enableOSD(bool enable) +Switch OSD display on or off. + + + +void enableRandomMode(bool enable) +Switch Random Mode on or off. + + + +void enableRepeatPlaylist(bool enable) +Switch Repeat Playlist on or off. + + + +void enableRepeatTrack(bool enable) +Switch Repeat Track on or off. + + + +void mediaDeviceMount() +Sets the command used for mounting media device. + + + +void mediaDeviceUmount() +Sets the comment used for umounting media device. + + + +void mute() +Toggle mute. + + + +void next() +Equivalent to pressing "Next" button. + + + +void pause() +Equivalent to pressing "Pause" button. + + + +void play() +Equivalent to pressing "Play" button. + + + +void playPause() +Toggle play/pause state (good for mm keyboard users) + + + +void prev() +Equivalent to pressing "Prev" button. + + + +void queueForTransfer( KURL url ) +Queue file for transfer to Media Device. + + + +void seek(int s) +Seek track to seconds position. + + + +void seekRelative(int s) +Seek to a position relative to the current track position. + + + +void setEqualizer(int, int, int, int, int, int, int, int, int, int, int) +Set the equalizer bands + + + +void setEqualizerEnabled( bool active ) +Toggle equalizer. + + + +void setEqualizerPreset( QString name ) +Set the equalizer preset + + + +void setLyricsByPath( QString url, QString lyrics ) +Set the lyrics of a track by it's path. + + + +void setScore( int score ) +Set the score of the currently playing track. + + + +void setScoreByPath( QString url, int score ) +Set the score of a track by it's path. + + + +void setVolume(int volume) +Set volume in range 0-100%. + + + +void showBrowser( QString browser ) +Shows browsers in the playlist window + + + +void showOSD() +Show the OSD display on the screen. + + + +void stop() +Equivalent to pressing "Stop" button. + + + +void transferDeviceFiles() +Transfer files to media device. + + + +void volumeDown() +Decrease volume by a reasonable step. + + + +void volumeUp() +Increase volume by a reasonable step. + + + + + + + + + +dcop amarok playlist + + + + + + +DCOP Call +Action + + + + + +int getActiveIndex() +Return the index of the currently active track. -1 if none. + + + +int getTotalTrackCount() +Return number of tracks in playlist. 0 if none. + + + +QString saveCurrentPlaylist() +Saves the current playlist to current.xml and returns its path. + + + +void addMedia( KURL ) +Add audio media specified by the url. + + + +void addMediaList( KURL::List ) +Add some audio media specified by the url. + + + +void clearPlaylist() +Clears the playlist. + + + +void playByIndex(int) +Starts playing the track at the specified index. + + + +void playMedia( KURL ) +Add audio media specified by the url. + + + +void popupMessage( QString) +Shows a temporary popup message. + + + +void removeCurrentTrack() +Removes the current-track item from the playlist. + + + +void repopulate() +Repopulate the playlist with random tracks. + + + +void saveM3u( QString path, bool relativePaths) +Saves the current playlist as m3u. + + + +void setStopAfterCurrent( bool ) +Enables/disables the "Stop After Current Track" feature. + + + +void shortStatusMessage( QString) +Shows a temporary message on the statusbar. + + + +void shufflePlaylist() +Shuffles the playlist. + + + +void togglePlaylist() +Toggle the Playlist-window. + + + + + + + + + +dcop amarok playlistbrowser + + + + + + +DCOP Call +Action + + + + + +void addPodcast( QString ) +Add a podcast entry to the playlist browser. + + + +void scanPodcasts() +Scan all podcasts for updates. + + + +void addPlaylist( QString ) +Add a playlist to the playlist browser. + + + + + + + + + +dcop amarok script + + + + + + + +DCOP Call +Action + + + + + +bool runScript( QString name) +Starts the script with the given name. Returns true on success. + + + +bool stopScript( QString name) +Stops the script with the given name. Returns true on success. + + + +QStringList listRunningScripts() +Returns a list of all currently running scripts. + + + +void addCustomMenuItem(QString submenu, QString itemTitle ) +Enables and sets custom menu item title. + + + +void removeCustomMenuItem(QString submenu, QString itemTitle ) +Removes the custom menu item. + + + +QString readConfig( QString key) +Returns a AmarokConfig configuration entry value from the given key. + + + + + + + + + + + + +Command-line Options + +Amarok supports the use of the standard Qt and kde command line options. Amarok also has it's own application specific options. + +The Qt and kde options: + + + + + + +Option +Action + + + + + +--help +Show help about options. + + + +--help-qt +Show Qt specific options. + + + +--help-kde +Show KDE specific options. + + + +--help-all +Show all options. + + + +--author +Show author information. + + + +-v, --version +Show version information. + + + +--license +Show license information. + + + + + + +The Amarok options: + +The &amarok; options are designed to be used while &amarok; is running. + + + + + + +Option +Action + + + + + +-r, --previous +Skip to the previous track in the playlist. + + + +-p, --play +Start playing current playlist. + + + +-s, --stop +Stop playback. + + + +--pause +Pause playback. + + + +-f, --next +Skip to the next track in the playlist. + + + +-a, --append +Append Files/URLs into the playlist. + + + +-e, --enqueue +See append, available for backwards compatability. + + + +--queue +Queue Files/URLs after the currently playing track. + + + +-m, --toggle-playlist-window +Toggle the playlist window. + + + +--wizard +Launch the First-run wizard. + + + +--engine "name" +Start &amarok; with the "name" engine. + + + + + + + + + + +Script Writing + +Scripting allows you to extend &amarok; easily without changing the main codebase. Scripts are similar to plugins, but instead of a dedicated plugin API they use &amarok;'s DCOP interface for communication. This makes it possible to write scripts in almost any programming language, like Ruby, Python or PHP. Not only can you create scripts in classic scripting languages, but also in compiled languages like C++ or plain C. Additionally, &amarok; can notify the scripts on special events and make them react accordingly. This notification system will be explained later in this section. + + +Bindings + +It is possible to write simple scripts that do not need user interaction, and it's also possible to make scripts with comfortable GUIs that act like little applications of their own. For GUI programming one of the many bindings which KDE provides can be used, for instance RubyQt, a Qt library binding for Ruby. However, it is worth noting that not every user has all available bindings installed. If you decide to use a binding, try to use one of the relatively wide spread ones (e.g. RubyQt or PyQt). + +In order to provide some feedback when a script fails to run due to a missing dependency, please check in your script if the module you want to include really exists. If the dependency is missing, you should catch the error and show an information dialog using the "kdialog" command line tool, so that the user learns why the script fails to run. + +This example shows how to catch a missing dependency in Ruby: + + +begin + require 'Korundum' +rescue LoadError + error = 'Korundum (KDE bindings for ruby) from tdebindings v3.4 is required for this script.' + `kdialog --sorry '#{error}'` + exit +end + + + + + +Getting Started: The Templates + +&amarok; provides template scripts for several languages in the scripts/templates/ directory. You can use these scripts as a basis for your own scripts, and extend them with the functionality you need. You'll notice that scripting is actually quite straightforward; For instance if you know to program a bit in Python, making your own script won't take you long. + + + + +Controlling &amarok; With DCOP + +Scripts can control Amarok by calling some of its DCOP functions. The easiest way to invoke a DCOP function is by using the "dcop" command line utility, which is part of every KDE distribution. + +Here is an example for increasing the master volume: + +dcop amarok player volumeUp + +Most scripting languages allow to execute external programs, with a function like exec(). This way the "dcop" utility can be invoked easily. Here is a simple Python example: + + + import os + os.system("dcop amarok player volumeDown") + + + + + +Notifications + +&amarok; sends notifications to all running scripts by writing strings to their stdin channel. The script should therefore constantly monitor stdin, and react accordingly to each of the possible events. Scripts may also choose to ignore any event they don't have a use for. + +The following notifications are sent by &amarok;: + + +configure +Tells the script to show its configuration dialog. The script must handle the +storing and loading of configuration options by itself. When a script is +started, Amarok sets its working directory to the folder where all data +should be stored. + + + +engineStateChange:empty|idle|paused|playing +Signals a change in the engine's state. + + + +trackChange +Signals the start of a new track. The script may then use DCOP functions to +query further information about the track, e.g. metadata and the length. + + + +volumeChangenewVolume +Signals a change of the master volume level. The volume is an integer with a +range of 0-100. + + + +customMenuClicked:submenu itemTitle paths +Returns the paths to selected files in the playlist when the custom playlist +context menu item is clicked. The submenu and itemTitle are also returned for +identification purposes in case a script is listening for multiple notifications. +To insert an item into the context menu use the DCOP call +'dcop amarok script addCustomMenuItem( submenu itemTitle )'. To remove an +item from the context menu use the DCOP call +'dcop amarok script removeCustomMenuItem( submenu itemTitle )'. + + + + + +Script Termination + +Before &amarok; exits, or when the user stops a script with the Script Manager, &amarok; sends the SIGTERM signal to the script. This signal can be caught in order to do cleanup work, like saving data or configuration settings. + + + + +Packaging + +&amarok;'s Script Manager is able to install script packages that the user has downloaded from a web server. Packages are just normal tarballs (.tar), optionally compressed with bzip2 (.bz2). We strongly recommend using a filename like myscript.amarokscript.tar.bz2, so the user can easily identify the package as an Amarok script. + +&amarok; 1.3 will only accept script packages with the amarokscript extension, so it is better to use it right from the start. + +The tarball's content must be organized as follows: + + +myscript/ + README + myscript.py (executable) + somemodule.py + foo.data + ... + + + + + +File permissions + +The main script must have executable (+x) permissions set, while additional modules which the script loads should not be executable. To preserve the file permissions in the tarball, you should use tar with the -p flag: + +tar -cf myscript.amarokscript.tar -p myscript + +&amarok; will not be able to install the script if the permissions are not correctly set. + + + + +Distributing + +When the package is finished, you can upload it to www.kde-apps.org, and add the link to the &amarok; Wiki Scripts Page. For the kde-apps entry you should use the &amarok; Scripts category. + + + + + + + + diff --git a/doc/en/amarok_playlist.png b/doc/en/amarok_playlist.png new file mode 100644 index 00000000..447ba6aa Binary files /dev/null and b/doc/en/amarok_playlist.png differ diff --git a/doc/en/analyzer.png b/doc/en/analyzer.png new file mode 100644 index 00000000..b1a2721b Binary files /dev/null and b/doc/en/analyzer.png differ diff --git a/doc/en/buttons.png b/doc/en/buttons.png new file mode 100644 index 00000000..44f461e9 Binary files /dev/null and b/doc/en/buttons.png differ diff --git a/doc/en/collection.png b/doc/en/collection.png new file mode 100644 index 00000000..7a0b4ee5 Binary files /dev/null and b/doc/en/collection.png differ diff --git a/doc/en/config.docbook b/doc/en/config.docbook new file mode 100644 index 00000000..5a43ce7d --- /dev/null +++ b/doc/en/config.docbook @@ -0,0 +1,252 @@ + +Configuring &amarok; +&amarok; is easily configured from the configuration dialog. The configuration dialog has multiple tabs for setting up different functions of &amarok;. +The configuration dialog can be found by selecting Configure &amarok; in the player &RMB; menu, +or by selecting Settings Configure &amarok;.... + +General Options + + General Options Screenshot + + + + +The General Options tab is divided into two sections, General Options and Playlist Options. + + +General Options + +In the General Options section you can configure some basic &amarok; options. +Show splash-screen on startup: displays the splash screen when &amarok; starts. +Show tray icon: enables the display of the system tray icon. + +Flash tray icon: enables animation of the system tray icon. +Show player window (like XMMS): Turns on the XMMS-like Player Window. When un-checked, only the Playlist Window, which resembles a display mode similar to the Juk interface, is shown. +Use Moodbar: only visible when &amarok; is compiled with moodbar support. This turns on the experimental moodbar support. +Make Moodier: only visible when &amarok; is compiled with moodbar support. It changes the color scheme used for the moodbar. +Store Mood data files with music: only visible when &amarok; is compiled with moodbar support. When enabled, this option allows saving of .mood files in the same location as the corresponding audio file. When disabled, the .mood files are saved within the &amarok; settings directory; usually ~/.trinity/share/apps/amarok/moodbar/. +Default size of cover previews: allows adjusting the size of the album cover image in the Context Browser. +External web browser: allows choosing what &amarok; uses to open external links via a drop-down menu listing the installed browsers. +Use another browser: allows you to specify the location to a browser not listed in the above menu. + + + +Playlist-Window Options + +In the Playlist-Window Options section you can configure playlist behavior. +Remember current playlist on exit: check this if you want to save your current playlist when you exit &amarok; and reload it the next time. +Manually saved playlists use relative path: check this box to have &amarok; save playlists with the location of audio file with respect to the location of the playlist. When unchecked &amarok; will save the exact location to the audio files in the playlist. +Keep active song visible on track change: this option automatically scrolls the Playlist, when a track changes, to ensure that the currently playing track is always visible. +Switch to Context Browser on track change: used to change to the Context Browser tab if it isn't active when &amarok; starts playback of a new track. +Show statusbar: enables the &amarok; statusbar in the Playlist Window. + + + + + +Configure Appearance + + Configure Appearance Screenshot + + + + +The Appearance tab allows you to configure how &amarok; looks. The tab is divided into three sections. + + +Fonts + +The fonts section is used for selecting the fonts to be used with &amarok;. Selecting the Use custom fonts checkbox enables font selection buttons. The available choices are for the Player Window, the Playlist Window, and the Context Browser. By clicking the Choose... button you can select a font from the dialog. + + + +Color Scheme + +The color scheme section is used to choose the color scheme for &amarok;. +The current KDE color-scheme choice forces &amarok; use the current KDE color scheme. +The classic Amarok, "funky-monkey", theme choice uses &amarok;'s original color scheme. +Custom color scheme enables color selectors to choose custom foreground and background colors for &amarok;. + + + +Context Browser Style + +This section allows you to change, install and remove Context Browser styles (themes). The Select a style drop-down menu selection of installed styles for use. The Install New Styles... button opens a file selection dialog where you can browse to styles saved on your system and install them. The Download Styles... button opens a dialog that fetches new styles from kde-look.org. Finally, the Uninstall Style button shows a dialog which allows you to remove any manually installed styles. + + + + + +Configure Playback + + Configure Playback Screenshot + + + + +The Configure Playback tab provides an interface for configuring your audio playback characteristics. + + +Transition Behavior + +You can configure how &amarok; transitions from one song to the next. +No Crossfading: provides a silent gap between tracks, specified in milliseconds. +Crossfading: provides a nice fading effect. The crossfade period is also specified in milliseconds. + + + +Remaining Options + +The remaining checkbox configures the the following option: +Resume playback on start allows resuming playback of the last track that was playing when &amarok; was closed, from the last known position in the track. + + + + + +Configure On-Screen-Display + + Configure OSD Screenshot + + + + + + +Configure On-Screen-Display + +The Configure On-Screen-Display tab allows you to activate the On-Screen-Display. If the On-Screen-Display check box is selected an area is activated for configuring the look of the display. When the On-Screen-Display is activated a preview widget will also be displayed allowing you to see the effects of your changes to the look of the On-Screen-Display +The first option for the OSD is the Font. Clicking the Choose button will open a Font Selection dialog allowing you to choose the font used in the OSD. There is also a Draw shadow checkbox to enable or disable the use of Shadowed text in the OSD +The next option is for the OSD colors. Checking the Use custom colors checkbox enables the Text color: and Background color: buttons. Clicking the buttons opens a dialog to choose the color OSD Text or OSD Background. If the Use custom colors checkbox is disabled the OSD will follow your current &kde; color scheme. +The Display Text text input box is used for configuring the text shown in the OSD. By assigning variables you can customize the OSD to suit your needs. Below is a list of the variables and the text they represent. + + + + +Text +Variable + + + + +Title +%title + + +Album +%album + + +Artist +%artist + + +Genre +%genre + + +Bitrate +%bitrate + + +Year +%year + + +Track Length +%length + + +Track Number +%track + + +Filename +%file + + +Comment +%comment + + +Score +%score + + +Playcount +%playcount + + + + +The Duration spin box is used to adjust the time, in milliseconds, that the OSD is displayed on your desktop. +The Screen option is for xinerama users only. This option is used to determine what screen the OSD will be shown on in a multiple monitor setup. + + + + + +Configure Engine + + Configure Engine Screenshot + + + + +The Configure Engine tab allows you to select a sound engine from the list in the drop-down menu. Available options vary among the engines selected. See the "Requirements" section for different engines available. + + +Configure Collection + + Configure Collection Screenshot + + + + +The Collection settings tab is used for configuring all the collection options. These include the folders where you music is stored, and the database used for the collection. + + +Collection Folders + +This is where you choose the folders you want &amarok; to scan for music. Simply check the boxes next to the desired folders in the tree view of your filesystem. The Collection Folders section also has several check boxes to specify how the collection uses the selected folders. +Scan folders recursively: tells &amarok; to scan the selected folders and all of their sub-folders. +Watch folders for changes: allows &amarok; to watch the selected folders for filesystem changes (for example, added or deleted music files). An incremental scan is also performed to make the necessary changes to your collection. +Import Playlists: allows &amarok; to import any playlists (.pls and .m3u files) it finds while scanning for tracks to add to your collection. You will find these on the "Playlists" sidebar. + + + +Collection Database + +The Collection Database section is used to select a database to use for the collection. Use the Engine: combo box to select from either Sqlite or MySql. If MySql is selected, additional configuration is required in the MySql Configuration section. +The MySql Configuration section is for configuring what database &amarok; uses, and where it is located. First is the Hostname:, which is where the MySql database is located. Next is the Port:, which is the network port used when connecting to the database. The Name: option, is the actual database to connect to. +Use the Username: and Password: text input boxes to specify the username and password used for connecting to the MySql database. + + + + + +Configure Last.fm + + Configure last.fm Screenshot + + + + +The last.fm settings tab configures the last.fm support in &amarok;. Tracks played are submitted to the last.fm server, and if asked to, &amarok; will request recommendations based on your currently playing track. + + +last.fm Profile + +This is where you fill in the Username and Password for your last.fm profile. If you do not have a profile you can register at the last.fm website. + + + +last.fm Services + +Improve my profile by submitting the tracks I play: allows &amarok; to submit your played tracks to your last.fm profile. +Retrieve similar artists: this will cause &amarok; to request, from last.fm, a list of artists similar to the one you're listening to. These are also displayed in the Context Browser. Note: you do not need a last.fm profile to recieve similar artists - simply check this box. + + + + + \ No newline at end of file diff --git a/doc/en/config_appearance.png b/doc/en/config_appearance.png new file mode 100644 index 00000000..0204c05b Binary files /dev/null and b/doc/en/config_appearance.png differ diff --git a/doc/en/config_collection.png b/doc/en/config_collection.png new file mode 100644 index 00000000..a16911b7 Binary files /dev/null and b/doc/en/config_collection.png differ diff --git a/doc/en/config_engine.png b/doc/en/config_engine.png new file mode 100644 index 00000000..5309e2d4 Binary files /dev/null and b/doc/en/config_engine.png differ diff --git a/doc/en/config_general.png b/doc/en/config_general.png new file mode 100644 index 00000000..68c22907 Binary files /dev/null and b/doc/en/config_general.png differ diff --git a/doc/en/config_osd.png b/doc/en/config_osd.png new file mode 100644 index 00000000..b64417bf Binary files /dev/null and b/doc/en/config_osd.png differ diff --git a/doc/en/config_playback.png b/doc/en/config_playback.png new file mode 100644 index 00000000..11312bc1 Binary files /dev/null and b/doc/en/config_playback.png differ diff --git a/doc/en/config_scrobbler.png b/doc/en/config_scrobbler.png new file mode 100644 index 00000000..ba03382e Binary files /dev/null and b/doc/en/config_scrobbler.png differ diff --git a/doc/en/coverman.png b/doc/en/coverman.png new file mode 100644 index 00000000..d18bcf4b Binary files /dev/null and b/doc/en/coverman.png differ diff --git a/doc/en/dynamic_bar.png b/doc/en/dynamic_bar.png new file mode 100644 index 00000000..5431d1f5 Binary files /dev/null and b/doc/en/dynamic_bar.png differ diff --git a/doc/en/dynamic_settings.png b/doc/en/dynamic_settings.png new file mode 100644 index 00000000..aa6cb431 Binary files /dev/null and b/doc/en/dynamic_settings.png differ diff --git a/doc/en/equalizer.png b/doc/en/equalizer.png new file mode 100644 index 00000000..61d2d175 Binary files /dev/null and b/doc/en/equalizer.png differ diff --git a/doc/en/faq.docbook b/doc/en/faq.docbook new file mode 100644 index 00000000..43e78113 --- /dev/null +++ b/doc/en/faq.docbook @@ -0,0 +1,1038 @@ + +Questions and Answers + + +What is &amarok;? + + + + + +What is &amarok;? + + + +&amarok; is a music player for Unix systems (eg. Linux). More information can be found in a summary of its features and the screenshot gallery. + + + + + + + + +Installation + + + + + + +Can I use &amarok; without KDE? + + + +&amarok; only requires KDElibs, none of the other KDE stuff. So you have to have KDElibs installed properly (including all the binaries that come with it, as &amarok; needs some of these to find plugins and for the script plugins). We have written an entry for how to compile a minimal KDElibs, which you may find useful. +For some features to work correctly, such as the on-screen display, require your window manager to support the relevant freedesktop.org standards. So GNOME will work well, but fluxbox will have some trouble. We are committed to supporting &amarok; on all platforms. We use KDElibs and Qt because they provide an excellent development environment. + + + + + + + + + +Troubleshooting + + + + + +&amarok; crashes during the Collection scan, always at the same point. What's happenning? + + + +It's likely that one file in your Collection triggers a bug in the TagLib library, and makes &amarok; crash. You can identify this file by looking at ~/.trinity/share/apps/amarok/collection_scan.log. You should report this crash to the TagLib bug database on bugs.kde.org and attach the broken file. Afterward you can remove the file from your Collection and repeat the scanning. + + + + + +&amarok; crashes when I play a certain track, everytime, what's wrong? + + + +This usually means TagLib is crashing while reading that track's tags. Report the bug against TagLib at bugs.kde.org. + + + + + + +&amarok; crashes often, what can I do? + + + +Upgrade your ALSA libs and utils to the latest version, or use OSS, or OSS emulation. +If you use MySQL as the database backend, try the SQLite one, it is slightly more mature (the &amarok; code, not the db itself) + Try a different audio-engine. +Make sure that all the libraries that &amarok; uses were compiled with the same GCC version as &amarok; itself. The situation when &amarok; is compiled using GCC 3.4.x and linked against taglib which was compiled using GCC 3.3.x can lead to crashes during tag editing. +If you're using KDE with artsd, try disabling "auto suspend if idle after..." in the sound system settings or at least don't use a value of 1 second since that will interfere every time amarok switches songs. +Otherwise, forward us the backtraces when the email pops-up (you'll see). If you get a crash often you will get it fixed for sure if you forward a really good backtrace to us. See the next sections for assistance there. + + + + + + +How can I obtain a decent backtrace? + + + +See the Debugging HowTo. + + + + + + +&amarok; is not using the tags I know are in my files! + + + +If Konqueror or other apps are displaying different Title, Artist, Album or Genre information than &amarok; is picking up when it creates your collection, it may be reading the older ID3v1 format tags rather than the newer ID3v2 tags. This can be due to your Encodings setting: Go to Settings Configure &amarok;, and then find the Encodings section of the Settings panel. Uncheck all checkboxes to "Do not decode the following as latin1". Rescan your collection to pick up the ID3v2 tags. + + + + + + +&amarok; is not displaying my utf-8 id3v2 tags properly! + + + +This is because most applications put utf8 data into id3v2 tags but do not specify the encoding as unicode. This perl script will fix that. + +#!/usr/bin/perl +die "File $ARGV[0] doesn't exist" unless -f $ARGV[0]; +use MP3::Mplib; +my $mp3 = MP3::Mplib->new($ARGV[0]); +my $v2tag = $mp3->get_v2tag; +print "Error writing tags of $ARGV[0]\n" unless $mp3->set_v2tag($v2tag,&UTF8); + +This script requires the perl module MP3::Mplib which can be installed by issuing this command +perl -MCPAN -e 'install MP3::Mplib' + + + + + +Why do my statusbar icons always look active? + + + +&amarok; statusbar icons(Random/Repeat/Append) look constantly Active on KDE 3.4.0. This is a known bug in KDE 3.4.0. The icon effects are sometimes forgotten. Simple fix kcontrol AppearanceIconsAdvanced, set disabled state to "Gray" and "Semi-transparent". Note that sometimes you must click on the icon 3 times before it has an effect after making this change. + + + + + + +Why does &amarok; complain about undefined symbols and then refuses to start? + + + +if you get this error : "amarokapp: symbol lookup error: amarokapp: undefined symbol: _ZN11KSystemTray9setPixmapERK7QPixmap", then check that amarokapp uses the correct libtqt (check with : ldd `which amarokapp` | grep qt). +To fix it, you might have to remove any conflicting libtqt and/or edit /etc/ld.so.conf so it pick up the correct version first. + + + + + + + + + +General Usage + + + + + + +Where can I get support for &amarok;? + + + +There are several options. Often times problems you have with the initial install of &amarok; are best answered by experts of your particular Unix or Linux distribution. You may seek help from fellow users and developers at the &amarok; forum and the IRC channel at irc.freenode.net channel #amarok. +Bugzilla is not a place to seek support. Please do enter a bug if you are serious about helping fix a bug in &amarok; itself. + + + + + + +When I start &amarok;, I see an empty playlist. How do I actually get tracks in there? + + + +Simple. Use the File Browser on the left side to navigate to the desired directory. Then drag the files into the Playlist part on the right. + + + + + + +Where is the"Home" tab? + + + +To avoid interface-clutter "Home" tab has been transformed into "Statistics" tool, available under ToolsStatistics. + + + + + + +Is there a way to set up amount of information that "Context" borwser shows? + + + +Yes, use the right mouse button menu anywhere on "Context" browser to modify it. + + + + + + +Why are the stars and numbers in the "Context" browser are out of sync? + + + +The meaning of those symbols has changed in Amarok 1.4 "Fast Forward": stars represents the user-defined rating, while numbers shows calculated score. + + + + + + +Clicking on stars in "Context" browser does not work! How do I rate a song? + + + +To rate a track you need a "Rating" column in playlist. Click with the &RMB; on playlist title, and choose Add ColumnRating. Click anywhere inside "Rating" column to set up rating for a track. You can also use shortcuts [Win]+[1-5] to quickly rate a song, with Amarok running in the background. + + + + + + +How do I remove tracks from the Playlist? + + + +Select the files you want to remove, and press Del key on your keyboard. Or right-click the selection and choose Remove Selected from pop up menu. + + + + + + +How can I load a playlist? + + + +Just drag and drop the playlist file into the Playlist, like you would do with any other file. It's that simple! + + + + + +How can I save the current playlist? + + + +The Save playlist button is next to Add Media button in the Playlist Toolbar. Just click it! + + + + + + +There are no visualizations in the visualizations dialog. + + + +You probably don't have xmms-config installed, reconfigure and build after installing the appropriate xmms-devel package. You also may want to install the latest version of libvisual, which has some ultra fancy visualizations. + + + + + + +Where's the equalizer? + + + +The Equalizer Window can be found in the right mouse button menu. You can also find it in the Menubar by selecting Tools Equalizer. + + + + + + + + + + +Playback + + + + + + +What media types does &amarok; support? + + + +None. Yes, that's right! None! We have a backend independent approach, so the question you should be asking is "What media types does GStreamer/xine/aRts/NMM/MAS/KDEmm support?" So as you can guess we pretty much support absolutely every audio format you can think of. GStreamer can even decode text and PNG! +For more information, have a look at Audio Engine Comparison. + + + + + + +Why can't &amarok; play MP3s? + + + +It can! Chances are you're using Fedora/RedHat linux, they don't ship with MP3 decoders by default (due to patenting issues). Solution: +Alt-F2, gg:redhat mp3 kde, ENTER + + + + + + +&amarok; won't play MP3's under SUSE Linux 9.3, what could I do? + + + +Open the "YaST Online Update" and install the 'Multimedia Option Pack 1' patch. Voila, &amarok; plays MP3's. + + + + + + +With GStreamer-engine I'm getting 100% CPU usage while playing. How can I fix it? + + + +When using GStreamer-engine with alsasink, &amarok; requires the device to provide a mixer. Mixing allows multiple applications to access the device at the same time, and output sound simultaneously. This can either be achieved by using a soundcard with hardware-mixing (e.g. SBLive), or by using the "dmix" plugin for alsa, which provides software-mixing. See Setting up Dmix for ALSA. +After installation you need to specify "dmix" as the sound device in the engine settings dialog. + + + + + + +I can't get any media to play in &amarok;, why not? + + + +You need to test the sound frameworks at the commandline: + +artsplay foobar.mp3 +gst-launch filesrc location=/home/foo/bar.mp3 ! spider ! audioscale ! audioconvert ! alsasink +xine-check + +The output from these commands should help you identify the problems you are having and how to fix them. Please note you may need to use a different sink to test GStreamer (eg. osssink). + + + + + + +Can &amarok; output directly to OSS/ALSA? + + + +We already do! Don't forget that the media must be decoded first! You can't just pipe an MP3 to ALSA, all you will get is white-noise. GStreamer is the best choice for most people who want a low-overhead decoding solution, it reads the file, decodes it and pipes the PCM data to ALSA. Exactly like XMMS. + + + + + + + +But! XMMS can output directly to ALSA! + + + +But it decodes it first! GStreamer can output directly to ALSA too! So can xine! + + + + + + +The sound stutters, is there anything I can do to improve it? + + + +You can either use the GStreamer engine (it's great!), or tweak aRts. Open Control Center Sound and Multimedia Sound System. Enable Run with highest possible priority, and increase the size of the Sound buffer: (warning, see the next FAQ!) You should also ensure that your artswrapper is suid: + +su +chmod a+rsx /path/to/kde/bin/artswrapper +killall -9 artsd + +With KDE 3.2.x there are issues with the KDEMultimedia codecs that can cause distorted playback, please see this bug report. +Also, increasing the size of the sound buffer in your .asoundrc alsa configuration file can help a great deal. + + + + + + +The CPU usage is high, is there anything I can do to improve it? + + + +Either don't use the aRts-engine, use the GStreamer or xine engines, or address the high CPU usage by installing KDEMultimedia in its entirety to get the faster aRts codecs (eg. libarts_mpeglib.so, etc.) + + + + + + +The &amarok; analyzers are really unresponsive! + + + +You are probably using the aRts-engine, either use another engine (the xine-engine has been seriously tweaked to give perfect analyzer-sync), or reduce the size of your aRts buffer in kcontrol, sound system. The lower the buffer the more responsive the visuals. Yes this is a bug, please help us fix it! + + + + + + +I have GStreamer installed but when I try to change to the GStreamer engine &amarok; crashes, what gives? + + + +After installing GStreamer you have register it's components, running `gst-register` (sometimes suffixed with a version, so gst-register-0.8) should take care of registering your GStreamer components. + + + + + + +I ran gst-register but I still have have GStreamer troubles, what can I do? + + + +You can try the GStreamer FAQ. If all else fails you can try the knowledgeable people at the #gstreamer IRC channel. + + + + + + +&amarok; says that the GStreamer engine cannot play MP3 files, although I have compiled/installed the mad plugin! + + + +Try this (make sure that &amarok; does not run): + - Download, compile and install the ffmpeg package + - Run gst-register (you may need to run it twice, as root and as your "normal" user) + - Go to your GStreamer plugin directory (you can find it with gst-config / gstreamer-config) + - Delete the ffmpeg files (or move them somewhere else) + - Run gst-register again + - Start &amarok; + + + + + + + + + + +Development + + + + + + +How do I get a cvs/svn version of &amarok;? + + + +How to obtain and build SVN &amarok; + + + + + + +I've found a bug / I've got a great idea for &amarok;! + + + +Please report it at bugs.kde.org, if you have a list of suggestions/wishes it may be best to send them to our mailing list: amarok-devel@lists.sourceforge.net + + + + + + +Do you accept patches? + + + +Happily! Your best course of action is to let us know what you plan to do before you do any work so we can discuss it, but don't fret we haven't turned down a patch yet! Discussion is mostly to help you patch the correct bits of &amarok;. Then either submit a patch to the mailing list, or commit if you have svn access. However, please let us know before you commit new features to svn! If you have a bug fix then just go ahead, this is open source after all :) + + + + + + +Why did you choose the name &amarok;? + + + +&amarok; is an album by British composer Mike Oldfield. I happen to like it a lot, and I think the name's got a nice sound. Plus, of course, it contains the all important “K”.. :) + + + + + + +Is it &amarok;, AmaroK or Amarok? + + + +It is &amarok;! Yes, we understand this is unconventional ;-) + + + + + + + + + + +Tips and Tricks + + + + + + +How do I use &amarok; as an alarm clock? + + + +Actually, thanks to the magic of DCOP you already can :) Simply set an alarm in your favorite calendar program and tell it to run the following command: +dcop amarok player play + +This command will tell &amarok; to start playing. Make sure that &amarok; is running before you go to bed, and you should wake up to the merry tune of whatever you pressed stop on before going to bed. + + + + + + +How do I get what &amarok; is playing right now, when I'm on another computer? + + + +If you have a properly set up ssh environment, you can use that to get the information. The following command will return the Now Playing string. +ssh -i ~/.ssh/id_rsa yourip dcop --user yourusername amarok player nowPlaying + +Make sure that you replace yourip with your IP and yourusername with your username. Also note that this expects your identification to be found in the ~/.ssh/id_rsa file. + + + + + + +What kind of tricks can the Player Window do? + + + +The &amarok; player analyzers can be detached from the Player Window. By pressing d on your keyboard the active analyzer will open in an independent, re-sizeable window. + + + + + + +What kind of tricks can the Playlist Window do? + + + +Holding Control and clicking the right mouse button enqueues files in the order in which you clicked them. +Pressing Enter after making a playlist search will play the first search item and will clear the search. + + + + + + +I see the Player Window and Playlist Window have neat tricks, what about the tray icon? + + + +Hovering your mouse on the icon will display a nice popup with current track information. +Clicking the middle mouse button on the icon play-pauses the current track. +Scrolling the mouse wheel changes volume. +Holding Shift while scrolling the mouse wheel seeks through the current track. +Holding Control while scrolling the mouse wheel will skip through tracks in the playlist. +Dragging and dropping items into the tray icon opens a pop up menu allowing you to choose from three options, Append to Playlist, Append and Play, and Queue after Current Track. +Tray icon is also a song position indicator. + + + + + + +Where do I find the settings for &amarok;? + + + +~/.trinity/share/apps/amarok +~/.trinity/share/config/amarokrc + + + + + + +How do I disable a browser section in &amarok;? + + + +Clicking with the &RMB; on any browser title shows up a list of visible browsers. You can use this list to disable/re-enable any browsers available. + + + + + + + + + + +General Questions + + + + + + +How Do I use an external MySQL database with &amarok;? + + + +See MySQL HowTo. + + + + + + +My $HOME is located on NFS. After startup, &amarok; fails to build the Collection, printing many database errors to the console. What to do? + + + +The internal SQLite database which &amarok; uses by default does not work on NFS. You must either link your ~/.trinity/share/apps/amarok directory to a local drive, or use the MySQL support. + + + + + + +How can I rip/encode Audio-CDs with &amarok;? + + + +Insert your CD, then click on "Play Audio CD" in the menu. The File-Browser will come up and show a tree with several folders. For normal ripping, go to the "wav" folder, select some tracks and drag them to the desired destination in a Konqueror window. For automatic encoding, drag files from the "mp3" or "ogg" folder instead. +CD-ripping requires the "AudioCD TDEIO-slave" to be installed. It is part of KDE-Multimedia. + + + + + + +How are track ratings determined? + + + +&amarok; assigns a rating (a number 1-100) to a song based on how many times you've listened to it and whether you skip the song without it finishing. Every time the song finishes playing, the rating is changed. The code for changing the rating is in collectiondb.cpp. As of version 1.2.2, it was on line 1181, though you can find it by searching for "CollectionDB::addSongPercentage". +When defining a score for a track which has never been played before, &amarok; uses the calculation +score = ( ( 50 + percentage ) / 2 ) +This sets the score equal to a number from 25-75, depending on how far through the song was allowed to play. For example, if the user stops or skips the song after only 25% of it has played, the score will be set to (50+25)/2, or 37.5. Scores are displayed as integers, however, so this number is rounded to the nearest integer before being displayed. The score is kept internally as a floating point number however, since after a song has been played several times, it may be impossible to alter the score by more than a point with a single play (see below). +When defining a score for a track which has been played before, the calculation is a bit more complicated. In the source, it is + score = ( ( values[2].toDouble() * values.first().toInt() ) + percentage ) / ( values.first().toInt() + 1 ); +Substituting in the values from this line: + + QStringList values = query( QString( + "SELECT playcounter, createdate, percentage FROM statistics " + "WHERE url = '%1';" ) + .arg( escapeString( url ) ) ); + +We have + score = ( ( statistics_percentage.toDouble() * PlayCounter.toInt() ) + percentage ) / ( PlayCounter.toInt() + 1 ); + +Basically, this adjusts the previous score (statistics_percentage) by a decreasing amount depending on how many times the track has been played. The more times the track has been played, the less of an impact each play has on the score. + + + + + + +How do I manually change a track's rating? + + + +You may change the rating manually by right-clicking on the playlist columns titles (the ones that say title, artist, album etc) and select Score. You can then change the score like any other song attribute, by right clicking it and selecting "Edit Tag 'Score'" or pressing F2. You can also edit the score in the Tag dialog, available by right clicking on a track. + + + + + + +Why isn't &amarok; part of KDEmultimedia? + + + +The developers don't want the man telling them when they can release. (Meaning, packages in KDE proper have a release schedule that doesn't fit with &amarok;'s fast-paced development). + + + + + + +How do I prevent the &amarok; icon from blinking in my system tray? + + + +This is a new feature that has been added that some users might find distracting. Simply uncheck the "Flash icon tray when playing" option under General Options. + + + + + + +How can I show/remove the analyzer in the playlist window? + + + +The playlist analyzer is part of the playlist toolbar. Select SettingsConfigure Toolbars +Add/Remove Analyzer to the Current actions +Press OK + + + + + + + +How do I change the Context Browser theme? + + + +Download a theme or make your own. Install it through Configure &amarok;... AppearanceContext Browser Style, click Install New Style. + + + + + + +What legal issues caused "Blue Wolf" icon replacement? + + + +The icon was way too similar to the Warp Graphics, Inc. logo (elfquest.com), so it had to be removed to avoid problems. + + + + + + +I don't have any visualizations. Where can I obtain these ? + + + +Install the latest version of libvisual. + + + + + + +How can I add my favorite streams to &amarok;? + + + +First of all, load the stream into the playlist. There are several ways to do this. You can simply click on a Stream-Playlist URL in Konqueror; &amarok; will then automatically open the stream. E.g. on shoutcast.com, click on the "Tune In" button. Or you can use the "Add Media" function to load a stream.Once the stream is loaded, you can save it by right-clicking on "Current Playlist" in the Playlist-Browser, then select "Save", and give it a meaningful name. The Stream will then be added to the Playlist-Browser view for later reference. + + + + + + + + + + +Konqueror Sidebar + + + + + + +What is Konqueror Sidebar? + + + +Konqueror sidebar allows you to monitor/control &amarok; while browsing with Konqueror. To see it, run Konqueror, press F9 to see sidebar, click on preferences (top one) button, in dropdown menu choose Add &amarok; Konqueror Sidebar. + + + + + + + + + + +Audioscrobbler + + + + + + +What is Audioscrobbler? + + + +Audioscrobbler is a free service that is sends information regarding which songs are played to an independent server. The service signup is free and only requires that you pick a user name and password that is not already in use. Audioscrobbler is currently utilized in &amarok;. + + + + + + +I do not want &amarok; to send information to Audioscrobbler! + + + +Uncheck "Submit tracks I play" to prevent querying Audioscrobbler for suggested tracks. + + + + + + +How do I get to the Audioscrobbler &amarok; group? + + + +The Audioscrobbler &amarok; group is located here: &amarok; Audioscrobbler Group + + + + + + + + + + +General Engine/Playback Questions + + + + + + +Which sound engine should I use? + + + +Please refer to the Audio Engine Comparison. + + + + + + +What version of ALSA should I use? + + + +If you output to ALSA, you should use the newest available version of ALSA possible! Old versions of ALSA have caused plenty of crashes, and have caused plenty of wrongly attributed crash-reports. + + + + + + +I've installed GStreamer/xine/etc., but the relevant audio-engine won't show up. What gives? + + + +&amarok; was probably compiled before you had xine and/or gstreamer installed, so the ./configure routine did not include them in the list of engines to be built. You will have to rebuild &amarok;. + + + + + + +But I did rebuild &amarok; after installing gstreamer and/or xine, but the engine still does not show up. What happened? + + + +You most likely are using a distro that packages development libraries separately from the main library, so even though gstreamer is installed, &amarok; cannot link to it because gstreamer-devel is not installed. The same issue exists for xine, you must install xine-devel if your distro splits packages in this fashion. Don't forget to rebuild &amarok; after installing the devel packages. + + + + + + + + + + +GStreamer engine + + + + + + +Why is there always a gap although I have crossfading enabled? + + + +Make sure you don't have gst-ffmpeg installed. Instead, install the gst-mad plugin. + + + + + + +I'm getting this error: "GStreamer-CRITICAL **: Factory for `adder' has no type.". How to fix? + + + +Your GStreamer was built with Prelinking, which is not compatible with GStreamer. You must rebuild it without this option. +merlin-tc advises: In addition, don't use any ldflags when building GStreamer. + + + + + + +You receive an error "There is no element present to handle the file's mimetype audia/mp4" even though you have the correct gstreamer-faad plugin is installed. + + + +To correctly play mp4 or m4a files with gstreamer, you must also have gstreamer-quicktime in addition to gstreamer-faad installed. + + + + + + +You receive an error "There is no element present to handle the stream's mimetype audio/mpeg" + + + +You are trying to play an mp3 stream without the gstreamer-mad plugin installed. Install the gstreamer-mad plugin and run "gst-register" as root before restarting &amarok;. + + + + + + +I have a second soundcard and I'm using ALSA. How do I make Amarok use it instead of the default? + + + +In SettingsConfigure AmarokEngine, check the 'Device' checkbox and fill in the device. Typical this is 'hw:0' for the default soundcard, and 'hw:1' for the second soundcard. + + + + + + + + + + +xine engine + + + + + + +How can I change where the audio is output to? + + + +If you are using ALSA, you can output to a specific device with xine. Set up an ~/.asoundrc (user only) or /etc/asound.conf (system wide) file that aliases your hardware devices, and then insert that alias in the "device used for stereo output:" box in the xine-engine configuration tab. Alternatively, you can directly enter the alsa device (hw:0,0 or hw:1,0 and so on). If you choose this latter (alternate) method, be aware that ALSA's corresponding plugfoo (e.g. plughw:0,0 or plughw:1,0 and so on) routing through alsa-lib is much preferred. +Here is a sample ~/.asoundrc for a machine that has an onboard Intel AC97 codec and a usb-audio device: + + pcm.intel8x0 { + type plug + slave.pcm "hw:0" + } + + ctl.intel8x0 { + type hw + card 0 + } + + pcm.usb-audio { + type plug + slave.pcm "hw:1" + } + + ctl.usb-audio { + type hw + card 1 + } + +Now enter usb-audio in the xine-engine setup screen and output should go to the usb-audio device (with alsa-lib properly handling sample rate conversion, channels, and so on). + To use a dmixed virtual device, ensure that the "sound card can do mmap" checkbox is unchecked. + + + + + + + + + + +aRts engine + +Sorry, aRts-engine has no maintainer, but feel free to fix it yourself! You could be the new aRts-engine maintainer we need so desperately! + + + + + diff --git a/doc/en/file_browser.png b/doc/en/file_browser.png new file mode 100644 index 00000000..0efc4bdf Binary files /dev/null and b/doc/en/file_browser.png differ diff --git a/doc/en/index.docbook b/doc/en/index.docbook new file mode 100644 index 00000000..b94fd6a0 --- /dev/null +++ b/doc/en/index.docbook @@ -0,0 +1,392 @@ + + + + + + + + + + + + + + + +]> + + + + +The &amarok; Handbook + + + + Mike + Diehl + +
madpenguin8@yahoo.com
+ + + + + The Amarok Development Squad + Developers + + + + + + + 2005 + The Amarok Development Squad + + + + 2006 + The doKymotion Krew + + +&FDLNotice; + +2006-02-20 +2.1 + + + &amarok; is a media player for the Trinity Desktop Environment. + + + + TDE + multimedia + player + audio + ogg + mp3 + wav + music + sound + script + + + + + +Introduction + + + Logo + + + + + +&amarok; is an audio player for &kde; that is extremely powerful, yet surprisingly simple to use. + +With &amarok; you can simply drag and drop music into the playlist instead of searching through endless menus. Just looking for that one song in a huge collection? &amarok;'s collection browser with its quick-search bar will help you find it in a matter of seconds. + +It may seem that &amarok; has the same old features found in the average audio player, but we did not stop there. One look at the context browser and you will see why &amarok; is one step ahead of the rest. The context browser shows all kinds of information related to your currently playing track - from the album cover, through to other music by the same artist, as well as related artists - an informative and fun way to learn about your collection! + +Do you already have many different playlists but can never decide on which one you want to use? Then the playlist browser is just for you. Never know what to listen to? Amarok's Dynamic Mode will choose your music for you, and Smart Playlists allow you to jump right in to specific parts of your collection. + +Amarok has outstanding support for Apple's iPod, iRiver's ifp and a multitude of generic USB devices. It also features many different audio backends allowing YOU to choose how you listen to your music. These and other features make it the most advanced audio player available. &amarok; is smart, sexy and clever. We hope that its use will truly allow you to "Rediscover your music!" + + + + + +&amarok-quick; + +&amarok-config; + +&amarok-using; + +&amarok-advanced; + +&amarok-faq; + + +Credits and License + +Program copyright 2003-2005 Mark Kretschmann markey@web.de +and The AmaroK Team. + + +The AmaroK Team +Christian babe-magnet Muehlhaeuser chris@chris.de +Frederik ich bin kein Deustcher! Holljen fh@ez.no +Mark it's good, but it's not irssi Kretschmann markey@web.de +Max Turtle-Power Howell max.howell@methylblue.com +Mike purple is not girly! Diehl madpenguin8@yahoo.com +Pierpaolo Spaghetti Coder Di Panfilopippo_dp@libero.it + +Roman and God said, let there be Mac Becker roman@formmorf.de +Seb Surfin' down under Ruiz me@sebruiz.net +Stanislav did someone say DCOP? Karchebny Stanislav.Karchebny@kdemail.net + + + +Contributors: + + +Adam Pigg (analyzers, patches) adam@piggz.fsnet.co.uk + + + +Adeodato Simo (patches) asp16@alu.ua.es + + + +Alexandre Oliveira (improvements, bugfixes) aleprj@gmail.com + + + +Andreas Mair (MySql Support) am_ml@linogate.com + + + +Andrew de Quincey (Postgresql support) adq_dvb@lidskialf.net + + + +Christie Harris (roKymoter) dangle.baby@gmail.com + + + +Dan Leinir Turthra Jensen (first run wizard) admin@removeleinir.dk + + + +Dan Meltzer (roKymoter) hydrogen@notyetimplemented.com + + + +Enrico Ros (analyzers, king of openGL) eros.kde@email.it + + + +Florian 'da-flow' Egerer (Amarok application icon 'Blue Wolf) flo_for_never@gmx.at + + + +Gérard Dürrmeyer (icons and image work) gerard@randomtree.com + + + +Greg Meyer (Fabulous help with our pre 1.2 bug-avalanche) greg@gkmweb.com + + + +Harald Sitter (roKymoter, translations, bug fixes, screenshots) harald.sitter@kdemail.net + + + +Ian Monroe (patches, Ruby script template (eean) )ian@monroe.nu + + + +Jarkko Lehti (tester) grue@iki.fi + + + +Jocke Andersson (roKymoter) ajocke@gmail.com + + + +Kenneth Wesley Wimer II (icons) kwwii@bootsplash.org + + + +Kenny Lemieux (Amarok webmaster) swaft@pwsp.net + + + +Melchior Franz (new FFT routine, bugfixes) mfranz@kde.org + + + +Michael Pyne (K3B export code) michael.pyne@kdemail.net + + + +Nenad Grujicic (splash screen for 1.1) mchitman@neobee.net + + + +Olivier Bédard (website hosting) paleo@pwsp.net + + + +Reigo Reinmets (Wikipedia support, patches) xatax@hot.ee + + + +Roland Gigler (MAS engine) michael.pyne@kdemail.net + + + +Sami Nieminen (Audioscrobbler support) sami.nieminen@iki.fi + + + +Scott Wheeler (TagLib) wheeler@kde.org + + + +Stefan Bogner (Loadsa stuff) bochi@online.ms + + + +Stefan Siegel (patches, bugfixes) kde@sdas.de + + + +Sven Krohlas (roKymoter) sven@asbest-online.de + + + +Whitehawk Stormchaser (tester, patches) zerokode@gmx.net + + + + +Documentation copyright 2005 Mike Diehl madpenguin8@yahoo.com + +&underFDL; + +&underGPL; + + + +&amarok-req; + + +Installation + + +How to obtain &amarok; + +&amarok; can be downloaded from The &amarok; home page + + +The latest development version can be obtained from &kde; SVN, module +/trunk/extragear/multimedia/amarok/. + + +How to compile &amarok; + +In order to compile and install Amarok on your system, type the following in the +base directory of the Amarok distribution: + + +./configure --prefix=`tde-config --prefix` +make +su -c "make install" + + +The --enable-final configure flag is no longer supported. + +Since &amarok; uses autoconf and automake you should have no trouble compiling it. Should you run into problems please report them to the &kde; mailing lists. + + + + +Configure Options + +&amarok; is like most other apps in that it has several compile time options that can be enabled or disabled during configure. This is a list of the options that can be configured. + +Some compile time options require specific dependencies to be used. See the requirements section for more details. + + + + + + +Option +Default +Description + + + + + +--enable-debug= +no +Enables debug symbols. Choose from yes, no, and full. Please use the full option if you intend to help with &amarok; development. + + + +--enable-mysql +Disabled +Enables MySql database support for &amarok; + + + +--disable-amazon +Enabled +Disables Amazon cover art downloading support in &amarok; + + + +--without-arts +With +Disables aRts support for &amarok; + + + +--without-gstreamer +With +Disables GStreamer support for &amarok; + + + +--with-helix +With +Enables Helix engine support for &amarok; + + + +--without-xine +With +Disables xine support for &amarok; + + + +--with-nmm +Without +Enables NMM support for &amarok; + + + +--with-mas +Without +Enables MAS support for &amarok; + + + +--without-opengl +With +Disables OpenGL (analyzer) support for &amarok; + + + +--without-included-sqlite +With +Do not use the included sqlite sources (requires sqlite to be installed) + + + + + + + + + + + + +&documentation.index; + + diff --git a/doc/en/logo.png b/doc/en/logo.png new file mode 100644 index 00000000..be5465c5 Binary files /dev/null and b/doc/en/logo.png differ diff --git a/doc/en/media_device.png b/doc/en/media_device.png new file mode 100644 index 00000000..8f7f6ec0 Binary files /dev/null and b/doc/en/media_device.png differ diff --git a/doc/en/menubar.png b/doc/en/menubar.png new file mode 100644 index 00000000..8d1b7f86 Binary files /dev/null and b/doc/en/menubar.png differ diff --git a/doc/en/musicbrainz.png b/doc/en/musicbrainz.png new file mode 100644 index 00000000..a87e056a Binary files /dev/null and b/doc/en/musicbrainz.png differ diff --git a/doc/en/pl_tip1.png b/doc/en/pl_tip1.png new file mode 100644 index 00000000..738dda56 Binary files /dev/null and b/doc/en/pl_tip1.png differ diff --git a/doc/en/play_list.png b/doc/en/play_list.png new file mode 100644 index 00000000..58df3172 Binary files /dev/null and b/doc/en/play_list.png differ diff --git a/doc/en/player_window.png b/doc/en/player_window.png new file mode 100644 index 00000000..69053b46 Binary files /dev/null and b/doc/en/player_window.png differ diff --git a/doc/en/playlist_browser.png b/doc/en/playlist_browser.png new file mode 100644 index 00000000..282a9fc0 Binary files /dev/null and b/doc/en/playlist_browser.png differ diff --git a/doc/en/playlist_window.png b/doc/en/playlist_window.png new file mode 100644 index 00000000..0a5aac81 Binary files /dev/null and b/doc/en/playlist_window.png differ diff --git a/doc/en/queue_manager.png b/doc/en/queue_manager.png new file mode 100644 index 00000000..762ba8d2 Binary files /dev/null and b/doc/en/queue_manager.png differ diff --git a/doc/en/quick.docbook b/doc/en/quick.docbook new file mode 100644 index 00000000..f47059a3 --- /dev/null +++ b/doc/en/quick.docbook @@ -0,0 +1,85 @@ + +&amarok; Quick Start Guide + +Listening to music should be easy. To this end we have provided a First-Run Wizard which presents itself the first time &amarok; is run. For those who wish to update their collection later on, or not use the wizard, this Quick Start Guide is for you. It will help you have &amarok; up and running in minutes. + + + +Building a collection + + + Collection Browser Screenshot + + + + + +Building your collection is an essential step in using all of &amarok;'s features. From the Collection Browser, click the Configure Folders button located in the toolbar. Next you will choose which folders you would like to be in your collection from the Configure Collection dialog. Also from here you have the option to Scan folders recursively, Watch folders for changes, and Import playlists that are found in the collection folders. After selecting your folders, and checking any relevant check boxes, click the OK button. After the initial scan, your collection is built and you can move on to making a playlist. + + + + + +Making a playlist + + + Playlist Screenshot + + + + + + + +Making a playlist is as simple as dragging items from the Collection Browser Tree View into the Playlist. To make searching for items easier, a text box is provided for filtering your collection. Just start typing in the text box, and the Tree View will change to show only the relevant results. After you are satisfied with your playlist, you can save it by clicking the Save Playlist As button found in the Playlist menu. + + + Playlist Browser Screenshot + + + + + +If you have your own playlists, you can add them in the Playlist Browser by clicking the Add button and choosing the Playlist... option in the toolbar. If your collection folders have your playlists in them, and you selected the Import Playlists in the collection setup, your playlists will already be in the Tree View. Right clicking a playlist in the Tree View will give you several options of how to load the playlist. + + + + + +Listening to streams + +Radio streams in &amarok; are played by adding them from the Playlist Broswer. &amarok; comes with a select set of streams for our listeners to enjoy, Cool Streams. Double-cliking or dragging an entry will load it into the playlist and once there it can be played. To add your own streams to the Playlist Browser click on the Add button in the toolbar and choose Radio Stream... from the dropdown box options. After adding your custom stream it can also be played after loading into the playlist. + + + + + +Playing an audio cd + + + Playlist Menubar Screenshot + + + + + + + + +To play an audio cd, select ActionsPlay Audio CD in the Playlist Menubar. The File Browser will open showing several folders and also the cd tracks listed in the WAV format. Drag the WAV files into the playlist and click the Play button. + +The Play Audio CD feature uses the audiocd:/ protocol and is not compatible with all of the available engines. + + + + +Burning an audio cd + +Burning an audio cd in &amarok; is easy thanks to the K3B integration. To burn an album, first open the Collection Browser. Next, by expanding an artist's entry in the Tree View, right click the album you wish to burn. A pop-up menu will open, click Burn This Album, and a dialog will open prompting you to choose a mode for burning. From the dialog click the Audio Mode button, K3B will open ready to burn the album. + +Burning functionality is also provided in the Playlist. Simply right click an item in the Playlist and follow the Burn menu for multiple cd burning options. + + + + + \ No newline at end of file diff --git a/doc/en/requirements.docbook b/doc/en/requirements.docbook new file mode 100644 index 00000000..e8a85499 --- /dev/null +++ b/doc/en/requirements.docbook @@ -0,0 +1,40 @@ + +Requirements + +&amarok; requires the installation of some software packages. The required packages are listed below along with several other packages to enhance your &amarok; experience. + + + +Required: +KDELIBS 3.3 +TagLib 1.4 + + + +Recommended: +GStreamer-0.8.6 and Gst-Plugins-0.8.6 + + + +Optional: +aRts 1.3 +K3B 0.11 +KDE-Base 3.3 (needed for Konqueror Sidebar) +KDEMULTIMEDIA 3.3 +libtunepimp 0.3 +Libvisual 0.2.0 and Libvisual plugins +MAS 0.6.3 +MySQL 4 +NMM 0.7.0 +OpenGL accelerated X-Server +ProjectM 0.96 +Real Player 10 +SDL 1.2 +xine 1.0.0 +XMMS 1.2 and XMMS visualization plugins + + +If you obtain these dependencies via a packaging system, you must +also install the devel versions of these packages! + + diff --git a/doc/en/rmb_menu.png b/doc/en/rmb_menu.png new file mode 100644 index 00000000..e32dd142 Binary files /dev/null and b/doc/en/rmb_menu.png differ diff --git a/doc/en/script_manager.png b/doc/en/script_manager.png new file mode 100644 index 00000000..28d94f4a Binary files /dev/null and b/doc/en/script_manager.png differ diff --git a/doc/en/status_bar.png b/doc/en/status_bar.png new file mode 100644 index 00000000..0a2ff065 Binary files /dev/null and b/doc/en/status_bar.png differ diff --git a/doc/en/tab_lyrics.png b/doc/en/tab_lyrics.png new file mode 100644 index 00000000..284414db Binary files /dev/null and b/doc/en/tab_lyrics.png differ diff --git a/doc/en/tab_music.png b/doc/en/tab_music.png new file mode 100644 index 00000000..e87e689a Binary files /dev/null and b/doc/en/tab_music.png differ diff --git a/doc/en/tab_wiki.png b/doc/en/tab_wiki.png new file mode 100644 index 00000000..60f00195 Binary files /dev/null and b/doc/en/tab_wiki.png differ diff --git a/doc/en/using.docbook b/doc/en/using.docbook new file mode 100644 index 00000000..03bb95cb --- /dev/null +++ b/doc/en/using.docbook @@ -0,0 +1,1270 @@ + +Using &amarok; + +&amarok; is a versatile audio player that offers many different ways of controlling your music collection. Like any ordinary audio player, &amarok; has a player window for controlling your most basic functions. &amarok; also has a playlist that is second to none. The playlist window has multiple browsers for creating and browsing your entire audio collection. + +In this chapter we will go over how to use all the features of &amarok; including creating a collection and a playlist. + + +The Player Window + + + Player Window Screenshot + + + + + + + + +The player window is your one click &amarok; control center. At the top of the player there is a scrolling display to show the currently playing track or stream. Just below the scrolling display there is an area to display the current track's play time, bit rate, and sample rate. Clicking this area will change the track time from total played to total time remaining. + +The player window also features a selection of audio analyzers also located under the scrolling display. You can cycle through the available analyzers by left clicking the analyzer area. + + + + + + + Analyzer Tip + + + + + + + +The &amarok; player analyzers can be detached from the player window. By pressing d on your keyboard the active analyzer will open in an independent, re-sizeable window. + + +Also below the scrolling display are the PL and EQ buttons. The PL button is used to quickly enable or disable the playlist window, while the EQ button is used to enable and disable the equalizer if your engine is compatible. + +The remainder of the player includes the playback buttons and the volume and track position sliders. Use the sliders to choose a track postion or volume level that suits your needs. Use the playback buttons to control the playback of the current track, or to skip either forward or back through your tracks. + + + + +The Equalizer Window + +The built in equalizer is easy to use and works with all engines. There are 17 presets included, ranging from Classical to Techno, and you can easily create your own. + +To access the equalizer choose ToolsEqualizer from the main window or click the EQ button from the Player window. Once you check the Enable Equalizer check box in this window, the equalizer will be active. + + + Equalizer Screenshot + + + + + + + +You can use the dialog's drop down box to select one of the built in presets. You can also adjust individual sliders here. Adjusting a slider will automatically cause a switch to the Manual preset so feel free to experiment with them until you find a desirable combination. When you are ready to save, click the Add new preset icon to the right of the drop down box. If you change to another preset without saving your changes they will be lost. In addition to saving you can also click the Manage presets icon, to the right of the drop down box, to delete or rename presets. + + + + +The Playlist Window + + + Playlist Window Screenshot + + + + + + + +The &amarok; playlist is the most advanced playlist available to any audio player for &kde;. The playlist offers many features that are not found in any other player. You should not be intimidated by the power of the playlist however, as it is still the easiest to use. + +The playlist window can be divided into two main sections, on the left is the sidebar. The sidebar is where you will find some of the excellent features of the playlist like the Context Browser. On the right side of the window is the playlist itself. The playlist is simple to use yet powerful enough for even the most advanced users. + + + + +The Sidebar Browsers + +Browsers in &amarok; allow you to acess your music collection in several different ways. They are situated on the left side of the window, and each one is represented by a tab with its name written on it. Clicking on a tab brings the selected browser into view. If a browser is active clicking on its tab again will contract the browser. Only one browser is visible at any time, although you can drag tracks from one tab to another by hovering on the target tab for 1 second until that tab becomes visible. You can also hide browsers by simply right-clicking on any tab and (un)selecting the desired browser(s) in the provided context menu. + + + Browser Selection Screenshot + + + + + + +Context Browser + +The Context Browser displays various information related to the currently playing track. Its appearance can be modified by using themes known as Context Browser Styles. It is organized into three tabs: Music, Lyrics, and Artist. These tabs, whose function will be more fully explained below, supply information on different aspects the track currently being listened to. + +Users of previous &amarok; versions will notice that there is no longer a Home tab. The information from this tab has been redistributed throughout the &amarok; interface. Analogous information can be found mainly in the Statistics dialog, accessible through ToolsStatistics. + + + Context Screenshot + + + + + + + +The Music Tab + +The Music tab offers information about the currently playing track, and it's artist and album. + +The first pane in this tab is for information about the track. The title of the pane lists the track name, artist name, and album. Inside the pane you will find it shows the album cover image for the track. Next to the image you will find a MusicBrainz icon. Click this icon to do a MusicBrainz look-up for the track. + +Below the MusicBrainz icon there is more information about you current track. Here you will find the total number of times the track has been played, the track's current core, and when the track was first and last played. + +To display album cover images in the Context Browser you must have the album cover image in the same directory as the track you are listening to. Supported file formats are .jpg, .jpeg, .gif, and .png. The images can be named anything, but images with the word front in the filename will be used with preference. The Context Browser will also use cover images saved from the album cover downloader, or images embedded in ID3v2 tags. + +The next pane, Suggested Songs, lists multiple tracks for suggested listening. Click on any of the listed tracks to begin playback of the track. + +Below Suggested Songs is the Favorite Tracks By Artist. This pane lists the five highest rated tracks by the current track's artist. + +You can adjust the amount of information shown in the Music tab by right-clicking anywhere on Music tab and toggling items on the context menu. + +The last pane, Albums By Artists, lists all of the albums by the current track's artists that are in your collection. Clicking on any of the albums in this pane will expand the album to show the album's content. + +You can click on tracks in any of the panes to begin playback of the track. You can also right click albums and tracks for a pop-up menu to choose several ways to play or enqueue the track or album. + + + + + +The Lyrics Tab + +Lyrics tabs fetches lyrics for the currently played song from one of the supported websites. This feature is flexible, and it's possible to write scripts to fetch lyrics from different sites. See Chapter on Script-Writing. When you click on the Lyrics tab, &amarok; attempts to fetch lyrics for the current track. If there is no lyrics script running you will be given the opportunity to select one. + + + Lyrics Screenshot + + + + + + +You can perform various actions on the lyrics tab, using its toolbar buttons. + +The Add button opens (in an external browser) the Add Lyrics page on the lyrics website, depending on which script you run. + +The Edit button allows you to edit lyrics for the current track. They are then stored in &amarok;'s collection database. This does not require a lyrics script to be active. + +The Search button launches a google.com search (in an external browser) for the lyrics of the current track. + +The Refresh button clears cached lyrics for current track, and searches again. + +Open in external browser displays the current track's lyrics in your external browser. + + + + +The Artist Tab + + + Artist Tab Screenshot + + + + + +The Artist tab shows Wikipedia article about currently played artist. Toolbar contains: + + + +Navigational buttons for moving forward or backward + + +Page buttons for jumping to artist's, album's or track's Wikipedia page, + + +A button for opening current page in external browser + + +A configuration button for setting the Wikipedia locale + + + + + + + + + +Collection Browser + + + Collection Browser Screenshot + + + + + +The Collection browser is the heart of &amarok;. The entire collection is viewable here and sorted using various groupings. Within each grouping, everything is always alphabetical, symbols and numbers first, and case insensitive. In every grouping method, tracks that have unknown artists and/or albums are always grouped at the start of your collection, under Unknown. Although track numbers are not shown, tracks are listed in their album order. Clicking the header of the collection list reverses the sort order. Left-clicking on the expand icon to the left of any entry in your collection will expand that entry. + +The Group By pull-down menu allows you to group your collection in several ways: + + + +Group ByArtist - Top level sort only, every track is grouped under its artist, with no consideration given to albums or genres. + + +Group ByArtist/Album - Tracks are sorted into artists, and then beneath this, sorted by album. If you want to see compilation or soundtrack albums, this is the best way to view your collection - these albums are grouped together at the very begin of your list, under Various Artists. + + +Group ByArtist/Year-Album - Sorts by artist, with albums in descending order of year (most recent first). If there is no Year tag set for a track, the default 0 - album name. + + +Group ByAlbum - Every album in your collection is displayed alphabetically based on the album name, regardless of artist. + + +Group ByGenre/Artist - Tracks are grouped according to their genre tag, then by artist. + + +Group ByGenre/Artist/Album - Same as above, only with tracks sorted by album, below each artist. + + + + +The remaining items on the pulldown menu allow you to customise the grouping with any combination of the above. + +The next two icons on the toolbar change the way your collection is viewed. The first, Tree View, is the default view, and the one you'll probably see the most. The next button enables Flat View, which at first appears empty. Typing search terms in the text entry box immediately below the toolbar will begin to populate your collection, which can be sorted in a variety of ways, by left-clicking on the column headers. right-clicking on the column headers will pop up a context menu allowing you to change the columns shown. + +The last icon in the toolbar lets you change your collection setup. Note that if you change any folders, &amarok; will automatically rescan your collection - this may take quite some time if you have many tracks. + +Immediately below the toolbar is a search filter, which behaves the same in both Flat and Tree views. See the Playlist section of the handbook for more details on searching techniques. + +Below the Search Filter, another pull-down menu lets you see the most recently added tracks to your collection. Several time periods are available, ranging from the last 24 hours, to 1 year, or your entire collection. + + +The Collection Browser &RMB; Options +The following options are accessible by clicking with the &RMB; on entries in the collection browser. + +Load - Clears the current playlist and adds selected track(s) as first track(s), in sort order. + +Append to Playlist - Adds selected track(s) to end of current playlist. Double clicking on a single track in the collection also achieves the same result. + +Queue Tracks - Adds the selected track(s) to the queue as the next to be played. + +Save as Playlist - Save the selected tracks as a playlist. You'll be prompted for a name to save as. + +Add to Media Device Transfer Queue - Adds track(s) to a queue, ready to be transferred to a media device, when such a device is attached. See Media Device Browser section for more detail. + +Burn All Tracks By This Artist/Burn To CD - Sends track(s) to &k3b; for burning as either a data or Audio CD. If &k3b; is not installed, this option is not selectable. + +Fetch Cover Image - Searches amazon.com for a cover image for this album. + +Edit Information for (n) Tracks - Opens the Track Information dialog and allows you to change tags for one or more tracks. + +Manage Files + + + +Organize (n) Files - Opens Organize Collection Files dialog. + + + +Delete (n) Files - Pops up a confirmation dialog asking whether you want to permanently delete the selected track(s) from your computer. + + + +Mark As Compilation - Sets the selected album as a compilation album, to be listed under Various Artists + +Unmark As Compilation - Changes an album marked as a compilation to a normal album, and moves the listing from Various Artists, to back under the artists listed. + + + + + + +Playlist Browser + + + Playlist Browser Screenshot + + + + + +The Playlist Browser is used for easy handling of your multiple playlists. The Playlist Browser also features built in smart playlists making it the most clever playlist browser around. + +The Playlist Browser is divided into two sections, Playlists and Smart Playlists. The Playlists sections is for your own custom playlists. You can view the contents of your playlists in a list view by clicking the + symbol found next to each of the listed playlists. When you view a playlist in the list view new items can be added to the playlist by dragging and dropping them into the view. When you have found a playlist that you would like to load, you can double click the playlist, or press the Space Bar to have &amarok; load it. The other Playlist Browser keyboard shortcuts can be found in the Keyboard Shortcuts section. + +When you save a new playlist from the Playlist Window it is automatically added to the Playlist section. + +The bottom section of the Playlist Browser is the Smart Playlists. The Smart Playlists use &amarok;'s built in data base to compile some useful playlists on the fly. The Smart Playlists include the following: + + + +All Collection: a playlist with all the tracks that are in your configured collection. + + + +Favorite Tracks: multiple playlists of the fifteen highest rated tracks in a listview by artitst. + + + +Most Played: multiple playlists of the fifteen most played tracks in a listview by artitst. + + + +Newest Tracks: multiple playlists of the fifteen most recently added tracks in a listview by artitst. + + + +Last Played: a playlist of the fifteen most recently played tracks in your collection. + + + +Never Played: a playlist of the tracks in your collection which have never been played before. + + + +Genres: multiple playlists in a listview ordered by genre. + + + +User defined smart playlists are also possible. Clicking the Create Smart-Playlist button will open a dialog to configure a smart playlist to fit your criteria. + + + + + + +Media Device Browser + + + Media Device Browser Screenshot + + + + + +The Media Device panel is used for connecting your iPod, to &amarok;. To use your iPod with the Media Device browser you must have your iPod mounted at /mnt/ipod before starting &amarok;. Once you have started &amarok; you will find the tracks on your iPod listed by artist in a listview at the top of the browser. + +To add tracks to your iPod, drag the tracks you want to add from the playlist and drop them on the Artist listview. After you are done adding tracks to the list click the Transfer button to upload them to your iPod. After the transfer has completed, close &amarok; and unmount your iPod. + + + + +File Browser + + + File Browser Screenshot + + + + + +The File Browser panel is like a mini konqueror embedded into the playlist. You can use the File Browser panel to browse your entire filesystem for audio files to add to the playlist. At the top of the File Browser you will find a toolbar with navigation buttons for moving Up, Back, and Forward through your filesystem. The tool bar also offers a Home, Reload, Short view and Detailed view buttons, it also features a Bookmarks button for creating bookmarks of your favorite filesystem areas. + +Below the toolbar is a handy search bar for searching by file name. You will find the search bar useful for directories with many files as it searches as you type leaving only the relevant file names in the view. + +At the bottom of the File Browser is an address bar for accessing your music from any URL that you type. For instance typing tar:/home/mike/music.tar.gz into the address bar and pressing Enter on your keyboard will allow you to access the files inside the music tar ball. Now you can drag the audio from the tar ball and drop it into the playlist. + +When playlist grows larger than one screenful, it becomes hard to append files by simply dropping them. Holding Shift key on keyboard while dropping may help in this case: the files will be appended at the end of playlist rather than inserted at current drop position. + + + + + + + +The Playlist + + + Playlist Screenshot + + + + + + + +The Playlist holds all the tracks you have en-queued for playing. You can change the sequence by dragging items around with the mouse, and dropping them in the desired position. Above the Playlist you see a Text Box, where you can enter a filter string. As soon as you enter a letter there, the Playlist will be redisplayed, showing only entries containing the entered characters. To stop the filtering, simply press Backspace, until the filter is empty. + +Advanced, Google-esque syntax is also available. + +By default, when you enter terms separated by spaces, it will search for items containing all of them. +For example: one two three, will search for anything that contains one, two, and three. + +However, you can put OR between terms to search for items that contain either, like this: one OR two OR three. +That way, it will search for items that contain either one, or two, or three (or a combination of them). + +You can also use quotes to search for terms with spaces in them: "Mike Oldfield". +That will search for items that contain Mike Oldfield, but not, for example, ones that contain Mike J. Oldfield. + +By default, it searches in all the columns of the playlist that are currently visible. However, you can use column:term to specify the column to search in: title:amarok (this can also be a column that isn't visible). +This way, it will only search for items that have the word amarok in the title, and not, for example, in the album. + +When specifying a specific column to search in, you can also search for items less than or greater than a term, for example: score:>50, which will search for items with a score greater than 50. + +To specify a term you don't want the items to match, you can put a minus (-) sign before them: -thing, to search for anything that doesn't contain thing. + +You can combine the above at will, for example: "Mike Oldfield" OR score:>50 -comment:bad. That will search for anything that either contains Mike Oldfield or has a score greater than 50, but excludes items where the comment contains "bad". + + + + + Playlist Tip + + + + + + + +You can select items to be played in a specific order by holding Control and clicking the &RMB; on items in the order in which you wish them to be played. The items will be tagged with a number showing the order in which you selected them. + + + + + + +The Playlist Menubar + + + Playlist Menubar Screenshot + + + + + + + + +The Actions Menu + + + + +Actions +Play Media... + +Opens a dialog for entering an URL. + + + + +Actions +Play Audio CD + +Allows you to view and play an Audio CD using the audiocd:/ protocol. + + + + + +WinZ + +Actions +Previous Track + +Move to the previous track in the playlist. + + + + +Actions +Pause + +Pauses the playback of the current track. + + + + + +WinZ + +Actions +Stop + +Stops playback. + + + + + +WinZ + +Actions +Next Track + +Move to the next track in the playlist. + + + + + +CtrlQ + +Actions +Quit + +Quits &amarok;. + + + + + + +The Playlist Menu + + + + + +CtrlO + +Playlist +Add Media... + +Opens a dialog to add media to your current playlist. + + + + + +CtrlS + +Playlist +Save Playlist As... + +Opens a dialog to save your current playlist. + + + + + +CtrlZ + +Playlist +Undo + +Undo the last change to the playlist. + + + + + +CtrlShiftS + +Playlist +Redo + +Reverts changes made by Undo. + + + + +Playlist +Clear + +Clears the current playlist. + + + + + +CtrlH + +Playlist +Shuffle + +Shuffles the ordering of the current playlist. + + + + + +CtrlEnter + +Playlist +Goto Current Track + +Moves the playlist to the currently playing track. + + + + + +CtrlD + +Playlist +Queue Selected Tracks + +Queues all selected tracks in the playlist. + + + + +Playlist +Remove Duplicates & Dead Entries + +Remove all duplicate or dead entries in the current playlist. + + + + + +CtrlA + +Playlist +Select All + +Selects all the tracks in the current playlist. + + + + + + + +The Tools Menu + + + + +Tools +Cover Manager + +Opens the Cover Manager. + + + + +Tools +Queue Manager + +Opens the Queue Manager. + + + + +Tools +First-Run Wizard + +Opens the First-Run wizard. + + + + +Tools +Visualizations + +Opens the Visualizations dialog. + + + + +Tools +Equalizer + +Opens the Equalizer Window. + + + + +Tools +Scripts + +Opens the Script Manager. + + + + +Tools +Rescan Collection + +Starts a manual scan of your collection folders. + + + + + + +The Settings Menu + + + + + +CtrlM + +Settings +Hide Menubar + +Hide the Playlist Window Menubar. + + + + +Settings +Hide Toolbar + +Hide the Playlist Window Toolbar. + + + + +Settings +Hide Player Window + +Hide the Player Window. + + + + +Settings +Repeat Track + +Repeat playback of the current track. + + + + +Settings +Repeat Playlist + +Repeat playback of the current playlist. + + + + +Settings +Random Mode + +Randomizes the order of playback of the tracks in the playlist. + + + + +Settings +Dynamic Mode + +Starts the dynamic playlist mode. + + + + + +Settings +Configure Global Shortcuts... + +Opens the global shortcut configuration dialog.. + + + + +Settings +Configure Shortcuts... + +Opens the &amarok; shortcut configuration dialog.. + + + + +Settings +Configure Toolbars... + +Opens the &amarok; toolbar configuration dialog.. + + + + +Settings +Configure Amarok... + +Opens the &amarok; configuration dialog.. + + + + + + + +The Help Menu + + + + + +F1 + +Help +Amarok Handbook + +Opens this documentation. + + + + + +ShiftF1 + +Help +What's This + +Activates the What's This mouse cursor. + + + + +Help +Report Bug... + +Starts the bug reporting tool. + + + + +Help +about Amarok + +Opens the about Amarok dialog. + + + + +Help +about KDE + +Opens the about KDE dialog. + + + + + + + + + +The Playlist Toolbar + + + Playlist Toolbar Screenshot + + + + + + + +The Playlist Window Toolbar is found near the bottom of the Playlist Window. The Toolbar contains buttons for many of the Playlist actions. On the right side of the Toolbar you can find the Add Media button, which opens a file dialog to add your media files to the playlist. Following the Add Media button are the Save Playlist, Clear Playlist, and Refresh Playlist buttons. You can use these buttons for handling the current Playlist. + +The next set of buttons are the Undo, and Redo buttons. You can use these buttons to Undo or Redo any changes made to the playlist. + +In the center of the Toolbar you can find a unique, re-sizeable analyzer. You can adjust the refresh rate for the analyzer by using the &RMB; menu, and selecting your desired frame rate. + +The last button in the Toolbar is the Menu button. The Menu button opens the same menu as the Player Window &RMB; menu. You can use this menu for accessing the &amarok; configuration options. + +There are many other buttons available for the Toolbar including player control buttons and a volume slider. You can configure what buttons are in the Toolbar by clicking the Menu button and selecting Configure Toolbars... + + + + +The Playlist Status Bar + + + Status Bar Screenshot + + + + + + + +The Status Bar provides quick access to some useful information about the playlist. The Status Bar displays the current track's title, the number of tracks in the playlist along with the total playlist time, Random and Repeat status, a mini track position slider, and the current track's play time. You can change the Random and Repeat status by double clicking there respective areas in the status bar. + +You can also choose to not have the Status Bar displayed using the Show statusbar option in the Configure General Options Dialog. + + + + +The Right Mouse Button Menu + + + RMB Menu Screenshot + + + + + + + +The &RMB; menu can be found by right clicking the player window, it can also be found by clicking the Menu button in the playlist window. The &RMB; menu is used for access to all of &amarok;'s options. + + + + + +Repeat Track + +This option when enabled repeats playback of the current track. + + + + + +Repeat Playlist + +This option when enabled repeats playback of the entire playlist. + + + + + +Random Mode + +This option when enabled randomizes the playback of the tracks in your playlist. + + + + + +Append Suggestions + +Appends the suggested songs in the Context Browser to the current playlist. + + + + + +Cover manager + +Opens the Cover Manager. + + + + + +First-run Wizard + +Clicking this option starts the first-run wizard for the initial configuration of &amarok;. + + + + + +Visualizations... + +Clicking this option opens the Visualizations Window for choosing what visualizations to use with &amarok;. + + + + + +Equalizer + +Opens the Equalizer Window. + + + + + +Script Manager + +Opens the Script Manager dialog. + + + + + + +Configure Toolbars... + +Clicking this option opens a dialog to configure the Playlist Toolbar. + + + + +Configure Shortcuts... + +Clicking this option opens a dialog to configure the &amarok; Shortcuts. + + + + + +Configure Global Shortcuts... + +Clicking this option opens a dialog to configure the global &amarok; Shortcuts. + + + + +Configure Global Amarok... + +Clicking this options opens the &amarok; Configuration Dialog. + + + + +Help + +This entry provides a sub-menu providing links to this document and other &amarok; information. + + + + +Quit + +This entry when clicked will quit &amarok;. + + + + + + + + +Album Cover Manager + + + Album Cover Manager + + + + + + + +The Album Cover Manager is a useful tool for managing your album covers. You can start the Cover Manager by selecting ActionsCover Manager in the Collection Browser. + +The cover manager provides a listview of all the albums in your collection. You can view all of your album covers for an artist by clicking on the artist in the list view. + +The cover manager provides a search bar for searching in your album covers. The cover manager will search your albums for the search criteria you type in the search bar. + +The View menu allows you to choose what is displayed in the cover manager. You can choose from: + +All albums which displays all your albums in your collection. + +Albums with cover which displays only the albums that have cover images. + +Albums without cover which displays only the albums that do not have cover images. + +The Fetch Missing Covers button is used to download cover images for your albums that do not already have cover images available. + + + +The Queue Manager + + + Queue Manager Screenshot + + + + + + + +The Queue Manager makes it's grand entrance in &amarok; 1.3. This feature is designed to enable users to have even more control over their playlists. After queuing, a track a number will be shown beside it in the Queue Manager. This number indicates the order in which &amarok; will play the track: one will be first, two will be second, and so on. + +You can use the Queue Manager by opening it from Tools Queue Manager, selecting the track, and then pressing the + icon in the Queue Manager. You can also just drag tracks to the Queue Manager to create a queue. Alternatively, the playlist's context menu may also be used and the Queue Manager can then be opened in order to modify the order. + + + + +Dynamic Playlists + + + What Are They? + + Dynamic Playlists are self-generating playlists, created according to defined rules, which are used to keep the current playlist to a manageable size. Whilst &amarok; is fairly light on resources while running, loading a large number of tracks into a playlist at once increases RAM usage, possibly impacting on system performance, which is avoided completely by using Dynamic Playlists. Also known as Party Mode, they are also a great way to keep the music playing all night with no interaction. + + + + + Where Are They? + You can find Dynamic Playlists in the Playlists Sidebar. + + + Playlist Sidebar + + + + + Playlist Sidebar + + + + + There are three types of Dynamic Playlists, referred to as Dynamic Modes, two of which are predefined (more details on configuring this later). + + + + Random Mix + Initialises a playlist with random tracks from you're entire collection, and keeps adding random tracks. + + + + + Suggested Songs + + Adds tracks based on last.fm (formerly audioscrobbler) suggestions. Requires some tracks already in the playlist. Note you do not need a last.fm profile for this to work. + + + + + Playlist Shuffle (user-created) + Adds random tracks from specified Smart Playlists, either built-in or user defined. + + + + + + + How Do I Use Them? + Simply double-click your desired playlist, drag it to the playlist window, or right-click and select Load. This will replace your current playlist, so you may want to save that first if it's important to you. + Both Random Mix and Playlist Shuffle will populate your playlist and allow you to start playing immediately. Suggested Songs will start with an empty playlist, requiring you to add at least one song from your collection manually. The suggestions are added on a track change, so your playlist will not be populated until the end of the first song. + If you wish to retain your current playlist, you can enable the last type of Dynamic Mode used by selecting Settings Dynamic Mode. This will use your existing playlist as a starting point. You can disable Dynamic Mode via the same menu option. + + Dynamic Playlist loaded + + + + + + Dynamic Playlist loaded + + + + + The Repopulate button will clear your playlist and re-add tracks according to the Dynamic Mode you are using, and the Edit this Dynamic Mode button will pop up the Dynamic Mode Settings dialog. These buttons will not appear if you have Dynamic Mode disabled. + + + + +Configuring Dynamic Playlists + + Changing the Behaviour of a Dynamic Playlist + Right-clicking on a Dynamic Playlist will allow you to select Edit, which opens the Dynamic Mode Settings dialog box. + + + Dynamic Mode Settings + + + + + + + + + + + Dynamic Playlist Name + + Rename to anything you like, if you so desire. Playlist names should be unique, to avoid confusion. + + + + + Remove played tracks + + If you uncheck this, your playlists will continually grow, the Upcoming Tracks setting is overridden, and you will not get repeats in your playlist. If the setting is checked, played tracks are removed from the start of the list, according to the Played tracks to show setting below. + + + + + Mark history + + Greys out tracks that have been played. + + + + + Played tracks to show + + Played tracks to show - number of played tracks to leave showing at the start of the playlist. Useful for seeing what has been played recently. + + + + + Upcoming tracks + + This is the setting that restricts the size of your playlist. + + + + + Tracks to append + + The number of tracks that will be added to your playlist after each song is played. Note that if you set this greater than 1, your playlist will grow rapidly, as only one track can be played then removed at a time. + + + + + You can also access this dialog via the Edit this Dynamic Mode button at the top right of your playlist window. + + + Dynamic Mode Bar + + + + + + + + + + + Adding a Custom Dynamic Playlist + Right-click on Dynamic Playlists and select New Dynamic Playlist. + + + Create New Dynamic Playlist + + + + + + + + + The settings on the right are as described in the previous section. In the panel on the left, you can select from any of the existing playlists and smart playlists on your system. If you select multiple playlists, &amarok; will add random tracks from each of these. + + + + +The Script Manager + + + Script Manager Screenshot + + + + + + + +The script interface provides a simple way to extend the functionality of &amarok;. To run an &amarok; script, start the Script Manager by selecting ToolsScript Manager in the &amarok; Menubar. In the Script Manager dialog you will find a listview of your installed scripts, select a script from the listview and click the Run button to launch the script. The &amarok; script will run until it has finished, or is manually stopped by selecting the script in the Script Manager and clicking the Stop button. + +Some scripts provide special configuration options. To access these options first run the script and then click the Configure button to access the script's configuration dialog. + +To install new &amarok; scripts click the Install Script button in the Script Manager dialog. A select file dialog will open allowing you to select an &amarok; script package. After selecting a package to install a new entry for the script will appear in the listview. You can also install new scripts by clicking the Get More Scripts button, which opens a Dialog for downloading and installing scripts automatically from the internet. + +You may also find that there are scripts that you no longer use. To uninstall a script select the script in the Script Manager listview and click the Uninstall button. + +If you are looking for information on writing an &amarok; script, please see the Script Writing section of this document. + + + + +The Visualizations + + + Visualizations Screenshot + + + + + + + +The Visualizations Window is used to enable your available visualizations with &amarok;. A list of your available visualizations will be provided in the window. To enable a visualization check the provided checkbox for the specific visualization. + + + + diff --git a/doc/en/vis_window.png b/doc/en/vis_window.png new file mode 100644 index 00000000..89afa82e Binary files /dev/null and b/doc/en/vis_window.png differ diff --git a/doc/es/CMakeLists.txt b/doc/es/CMakeLists.txt deleted file mode 100644 index 99cd2fda..00000000 --- a/doc/es/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# - -tde_create_handbook( LANG es DESTINATION amarok ) diff --git a/doc/et/CMakeLists.txt b/doc/et/CMakeLists.txt deleted file mode 100644 index b09ffc5b..00000000 --- a/doc/et/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# - -tde_create_handbook( LANG et DESTINATION amarok ) diff --git a/doc/fr/CMakeLists.txt b/doc/fr/CMakeLists.txt deleted file mode 100644 index 3bd465c7..00000000 --- a/doc/fr/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# - -tde_create_handbook( LANG fr DESTINATION amarok ) diff --git a/doc/it/CMakeLists.txt b/doc/it/CMakeLists.txt deleted file mode 100644 index 07a32be8..00000000 --- a/doc/it/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# - -tde_create_handbook( LANG it DESTINATION amarok ) diff --git a/doc/man/CMakeLists.txt b/doc/man/CMakeLists.txt deleted file mode 100644 index db8bb9c1..00000000 --- a/doc/man/CMakeLists.txt +++ /dev/null @@ -1,9 +0,0 @@ -file( GLOB _man_files *.1 ) -if( _man_files ) - INSTALL( - FILES ${_man_files} - DESTINATION ${MAN_INSTALL_DIR}/man1 - COMPONENT doc - ) -endif() - diff --git a/doc/nl/CMakeLists.txt b/doc/nl/CMakeLists.txt deleted file mode 100644 index 1b63b82e..00000000 --- a/doc/nl/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# - -tde_create_handbook( LANG nl DESTINATION amarok ) diff --git a/doc/pl/CMakeLists.txt b/doc/pl/CMakeLists.txt deleted file mode 100644 index 8e5a48a7..00000000 --- a/doc/pl/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# - -tde_create_handbook( LANG pl DESTINATION amarok ) diff --git a/doc/pt/CMakeLists.txt b/doc/pt/CMakeLists.txt deleted file mode 100644 index eafa8c8e..00000000 --- a/doc/pt/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# - -tde_create_handbook( LANG pt DESTINATION amarok ) diff --git a/doc/pt_BR/CMakeLists.txt b/doc/pt_BR/CMakeLists.txt deleted file mode 100644 index 5263f9b8..00000000 --- a/doc/pt_BR/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# - -tde_create_handbook( LANG pt_BR DESTINATION amarok ) diff --git a/doc/ru/CMakeLists.txt b/doc/ru/CMakeLists.txt deleted file mode 100644 index e390ba13..00000000 --- a/doc/ru/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# - -tde_create_handbook( NOINDEX LANG ru DESTINATION amarok ) diff --git a/doc/sv/CMakeLists.txt b/doc/sv/CMakeLists.txt deleted file mode 100644 index 45827c23..00000000 --- a/doc/sv/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# - -tde_create_handbook( LANG sv DESTINATION amarok ) diff --git a/translations/CMakeLists.txt b/translations/CMakeLists.txt deleted file mode 100644 index a8b8de4b..00000000 --- a/translations/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# - -tde_auto_add_subdirectories() diff --git a/translations/messages/CMakeLists.txt b/translations/messages/CMakeLists.txt deleted file mode 100644 index 4d7e4137..00000000 --- a/translations/messages/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -################################################# -# -# (C) 2010-2011 Serghei Amelian -# serghei (DOT) amelian (AT) gmail.com -# -# Improvements and feedback are welcome -# -# This file is released under GPL >= 2 -# -################################################# - -tde_add_project_translations() -- cgit v1.2.1