diff --git a/doc/Screenshot_20170615_224755.png b/doc/Screenshot_20170615_224755.png deleted file mode 100644 index 3b4cd552..00000000 Binary files a/doc/Screenshot_20170615_224755.png and /dev/null differ diff --git a/doc/Screenshot_20180112_174013.png b/doc/Screenshot_20180112_174013.png new file mode 100644 index 00000000..40203a11 Binary files /dev/null and b/doc/Screenshot_20180112_174013.png differ diff --git a/doc/index.docbook b/doc/index.docbook index 5b0c7fd9..1fb6260f 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -1,214 +1,251 @@ Elisa"> Elisa"> ]> The &elisa; Handbook Matthieu Gallien matthieu_gallien@yahoo.fr -2017 +2017-2018 Matthieu Gallien &CCBYSA4Notice; -2017-10-24 +2018-01-17 -Elisa 0.0.80 +Elisa 0.0.81 -&elisa; is a music player designed to be simple to use. +Elisa is a music player developed by the KDE community that strives to be +simple and nice to use. We also recognize that we need a flexible product to +account for the different workflows and use-cases of our users. + + +We focus on a very good integration with the Plasma desktop of the KDE +community without compromising the support for other platforms (other Linux +desktop environments, Windows and Android). + + +We are creating a reliable product that is a joy to use and respects our users +privacy. As such, we will prefer to support online services where users are in +control of their data. KDE kdemultimedia Elisa audio music Introduction &elisa; is a music player designed to be simple to use. -It gets your music from local sources either Baloo indexer or an internal music indexer. - - -&elisa; allows you to browse your music, build a playlist and plays it. - - - - -Using &elisa; - - Here's a screenshot of &elisa; start screen - + Screenshot + + + +Using &elisa; -There are no special requirements for use of &elisa;. Currently the only supported -indexer is Baloo but support for Tracker and the indexer generally available on -Windows are planned. It is also possible to have &elisa; index your music by itself. +&elisa; indexes your music either by using Baloo if possible or by searching in a list of paths configured by the user through a dedicated interface. + + +In case the Baloo support is activated and your setup is not working, a notification is shown with hints allowing to deactivate the indexer or to activate the Baloo indexer and to feed &elisa; with music tracks. + + +In case the file indexer is not finding anything, a notification is shown with a button to open the configuration interface. You can find a list of changes at Elisa Project. Currently no configuration is required before use of &elisa;. -You can explore the menu of application to see the customization possibilities. +You can explore the menu of the application to see the customization possibilities. It is possible to choose the paths that will be indexed for music. It is also possible to modify the shortcuts for common actions inside the application. If you use the internal music indexer, you can configure the paths that will be searched. &elisa; features &elisa; provides two different tasks: browsing your music to build a playlist and playing music. Browsing Music From the different sources of music, it collects all your music and analyses their metadata such that their title, artist, ... It provides three ways to browse your music: a list of all albums, a list of all artists or a list of all tracks. Each method uses a view of all your music along with a filter to allow to quickly find what you are looking for. You can also filter by rating. The filter of the view of all albums is implemented on the title or the artist of albums or the list of artists of each track of an album. The filter of the view of all artists is implemented on the name of the artists. The filter of the view of all tracks is implemented on the track title, track artist and track album name (if any). Building a Playlist When browsing your music, artists, albums and tracks can be added with a button shown when mouse is over it. It is also possible to clear the playlist and at the same time add some music. -A toolbar below the playlist allow to operate on it. Currently it is possible to clear it or to navigate to the currently playing track. +A toolbar below the playlist allow to operate on it. The following actions are possible: + + + + You can clear the whole playlist. + + + + + You can navigate to the currently playing track. + + + + + You can save the playlist to the m3u format. + + + + + You can load a playlist that will replace your current one. + + + Playing Music The playlist is read in the order of the tracks unless the Shuffle option is selected. At the end of the list playing is stopped unless the Repeat option is selected. It is possible to switch to the next or previous track in the list. If the mouse is over a track, it is possible to skip to it by pressing a button. The currently playing track is indicated by a flashing play icon. Credits and License &elisa; -Program copyright 2015-2017 Matthieu Gallien matthieu_gallien@yahoo.fr +Program copyright 2015-2018 The Elisa Team Contributors: -Andrew Lake (concept and design work)jamboarder@gmail.com +Matthieu Gallien Maintainer matthieu_gallien@yahoo.fr + +Andrew Lake (concept and design work) jamboarder@gmail.com + +Luigi Toscano (localizations) luigi.toscano@tiscali.it + +Safa Alfulaij (right-to-left support in interface) safa1996alfulaij@gmail.com -Luigi Toscano (localizations)luigi.toscano@tiscali.it +Alexander Stippich Core developer a.stippich@gmx.net -Safa Alfulaij (right-to-left support in interface)safa1996alfulaij@gmail.com +Diego Gangl (various improvements to the interface) diego@sinestesia.co -Documentation Copyright © 2017 Matthieu Gallien matthieu_gallien@yahoo.fr +Documentation Copyright © 2017-2018 Matthieu Gallien matthieu_gallien@yahoo.fr &underCCBYSA4; &underLGPL; &documentation.index;