Update vala version.
[gmpc.git] / doc / Manual_NL.txt
blob876e492e8d90297d8d2fdbb24e14870eaa9dee05
1 GMPC Manual - Nederlands
2 ========================
3 :Author:  Qball
4 :Email: Qball@gmpclient.org
5 :Date: 08/11/2010
6 :Revision: 0.01
9 == Het hoofd scherm
11 Het volgende plaatje weergeeft het hoofdscherm van GMPC.
13 image:Images/main-window.png[]
15 Wanneer je het hoofdscherm in vouwt, worden delen van het scherm weggelaten.
16 Op dit moment zijn er twee versies van het gevouwen beeld.
18 Gevouwen beeld versie 1:
20 image:Images/main-window-collapsed1.png[]
22 Gevouwen beeld versie 2:
24 image:Images/main-view-collapsed2.png[]
26 Wij zullen hieronder uitleggen wat elke deel van het scherm doet.
29 === De menu balk
30 image:Images/menu-bar.png[]
32 De menu balk geeft directe toegang tot elk deel van gmpc. U kan er de playback bedienen, gmpc configureren, outputs aan zetten, naar een ander profiel gaan, enz.
35 NOTE: Er kunnen meer of minder menu items aanwezig zijn, dit hangt af van het aantal plugins.
37 * Muziek
38 ** 'Verbinden' - Verbind GMPC met MPD.
39 ** 'Verbreek verbinding' - Verbreekt de verbinding met MPD.
40 ** 'Stuur wachtwoord' - Verzend een nieuw wachtwoord naar MPD. Dit kan het toegangsniveau verhogen of verlagen.
41 ** 'Profiel' - Een submenu met een lijst van mogelijke profielen.
42 *** Lijst met beschikbare profielen.
43 ** 'Opties' - Opent een venster met opties. xref:preferences[(meer)] 
44 ** 'Quit' - Sluit GMPC volledig af. Dit sluit overigens niet MPD af.
45 * Server
46 ** 'Database bijwerken' - Vertelt MPD om de database up te daten.
47 ** 'Informatie' - Opent een scherm met server informatie. xref:server-information[(meer)]
48 ** Lijst met alle beschikbare outputs. Dit geeft u de mogelijkheid een output in of uit te schakelen.
49 * Bediening
50 ** 'Speel/Pauzeer'
51 ** 'Stop'
52 ** 'Volgende'
53 ** 'Vorige'
54 ** 'Dempen' - Dempt het geluid.
55 ** 'Herhalen' - In-/Uitschakelen herhalen nummers.
56 ** 'Willekeurig' - In-/Uitschakelen shuffle nummers.
57 ** 'Single modus' - In-/Uitschakelen single modus. Single modus zorgt ervoor dat MPD niet naar het volgende nummer gaat.
58 ** 'Verbruiken' - In-/Uitschakelen verbruiken modus. Deze modus zorgt ervoor dat MPD al reeds gespeelde nummers van de playlist verwijderd.
59 * Beeld
60 ** 'Breid beeld uit' - Zorgt ervoor dat GMPC meer functies krijgt. 
61 ** 'Vouw beeld samen' - Verbergt functies van GMPC.
62 ** 'Volledig Scherm' - GMPC in volledig scherm.
63 ** 'Toon artiesten afbeelding' - In-/Uitschakelen of de artiesten afbeelding links onder in het scherm wordt geimplementeerd.
64 * Optie
65 ** Dit menu item laat opties zien voor de browser die op dit moment open staat.
66 * Gereedschap
67 ** 'URL toevoegen' - Voeg een url toe aan de wachtrij. xref:add-url[(meer)]
68 ** Lijst van globale opties die worden geimplementeerd door plugins.
69 * Ga naar
70 ** Geeft een lijst van ingeschakelde browsers en staat het toe om snel tussen deze browsers te verwisselen.
71 * Hulp
72 ** 'Berichten weergeven' - Weergeeft een lijst met berichten, waarschuwingen en informatie dat GMPC in het verleden heeft laten zien.
73 ** 'Website bezoeken' - Opent de website van GMPC.
74 ** 'Hulp zoeken' - Opent de Wiki hulp pagina.
75 ** 'Bug informatie' -  Opent een venster met informatie over de huidige GMPC versie. xref:bug-information[(meer)]
76 ** 'Makkelijk commando hulp' - Opent een lijst met mogelijke commandos voor het makkelijk commando venster. xref:easy-command[meer].
77 ** 'About' - Opent een venster met informatie over GMPC.
79 === Bedienings paneel
80 image:Images/playback-control.png[]
82 De verschillende elementen zullen van links naar rechts worden uitgelegd.
84 ==== Album Hoes
85 image:Images/pc-cover.png[]
87 Dit laat het hoesje van het huidige afspelende album zien. Als er geen hoesje beschikbaar is, wordt er een leeg hoesje getoond.
88 This shows cover of the currently playing album. If no cover is available, or the song has not information about it, an empty case or cd is shown.
90 [TIP]
91 =================================
92 * Wanneer u met uw muis over het album hoesje beweegt, zal er een vergrote versie van het hoesje getoond worden.
93 * Met een rechter muisklik op het hoesje, kunt u het hoesje bewerken.
94 * U kunt in de opties de "look" van het hoesje veranderen. (Met of zonder omhulsel)
97 image:Images/pc-cover.png["Met omhulsel"]
98 image:Images/pc-cover-plain.png["Zonder omhulsel"]
100 =================================
102 ==== Nummer informatie
103 image:Images/pc-song-info.png[]
105 Rechts van het album hoesje staat informatie over het nummer dat op dit moment wordt afgespeeld.
106 Het laat de titel, artiest en album naam zien.
108 TIP: Als u op de titel, artiest of albumnaam klikt, springt u in de Metadata browser naar het juiste item.
111 ==== Favorieten 
112 image:Images/pc-favorite-nhl.png[]
114 Met het hartjes icoon, kunt u een nummer tot favoriet maken door er op te klikken.
116 Wanneer het nummer een favoriet is, zal het icoon fel zijn, is het geen favoriet, dan is het een donker icoon.
118 * image:Images/pc-favorite-hl.png["Song is a favorite"]
119 Gemarkeerd als favoriet:
120 * image:Images/pc-favorite-nhl.png["Sog is not a favorite"]
121 Niet gemarkeerd als favoriet:
124 Favoriete nummers worden in een speciale playlist opgeslagen die "Favorites" heet.
127 TIP: Met een rechter muisklik op het icoon, kunt u het huidige nummer aan elke playlist toevoegen.
129 WARNING: Om favorieten te laten werken, moet MPD de mogelijkheid hebben om playlists op te slaan en te laden.
132 ==== Playback Control
133 image:Images/pc-playback-control.png[]
135 Of course the playback control buttons are also available: Play/Pause, Previous, Next, Stop and volume control.
138 [CAUTION]
139 =====================================================================
140 * You need sufficient permission to control playback. If you do not have the permission, the buttons will be made insensitive.
141 * If there is no output mixer defined in MPD, or it is not currently available, the Volume control is made insensitive.
142 =====================================================================
144 TIP: Hovering your mouse over the next button will show a tooltip with the title of the next song.
146 ==== Seek bar
147 image:Images/pc-seek-bar.png[]
149 Below is the progress/seek bar. This indicates how much of the song is allready played. 
150 You can drag the bar to a certain position to seek. Pressing the middle mouse button will instantly jump to that position. 
152 On the right of the seekbar is the progressed time (or remaining, see tip) and the total time of the song (if available).
155 [TIP]
156 =======================
157 * Right mouse click on the seekbar changes the time indication from progressed time to remaining time and back.
158 * Hovering the progress bar  will show you the time (or remaining) under the cursor. Allowing you to seek exactly to one point.
159 =======================
161 NOTE: Seeking is not instant, but the seek is done as you drop the handle. This is done so MPD is not spammed with seek requests.
163 === Message bar
164 image:Images/message-bar.png[]
166 The message bar is only visible when GMPC has to tell you something. The messsage bar can show information, warning and errors. 
168 A list of previous shown (or hidden) messages can be seen in the Show messages window under Help->show messages.
170 TIP: You can set what message should be shown in the message bar in the xref:preferences[preferences].
172 [[sidebar]]
173 === Sidebar
174 image:Images/sidebar.png[]
176 The sidebar allows you to switch between different browsers. 
177 You can reorder the browsers by drag and dropping them to there new place in the list.
178 What browsers are visible depend on the plugins installed and settings.
180 If you collapse the view the sidebar is turned into a horizontal selector:
182 image:Images/sidebar-hori1.png[]
184 Or if configured differently in the xref:preferences[preferences], a list of buttons:
186 image:Images/sidebar-hori2.png[]
189 TIP: The top browser is always selected when you connect to an MPD server.
191 NOTE: When collapsing the view, the sidebar is turned into a horizontal view, below the playback controls and when collapsed further the sidebar is hidden.
193 === Browser window
195 The browser window contains the actual browser, how this looks depends on the selected view. Browsers should (normally) follow the same generic layout.
196 Either one large pane (like now playing, search, play-queue, etc). Or 2 panes (like database, metadata browser, etc), where the size of the panes is synced between the browsers. 
198 One pane view:
200 image:Images/browser-pane-single.png[]
202 Two pane view:
204 image:Images/browser-pane-double.png[]
206 NOTE: When the view is completely collapsed the Browser window is hidden.
208 === Statusbar
209 image:Images/status-bar.png[]
211 At the bottom of the screen is the status bar. The statusbar is hidden when gmpc is fully collapsed.
213 The status bar consists of 2 parts:
215 On the left there is a message block. This shows feedback about changes, like 'repeat enabled', '10 songs added to play-queue'. It indicates if some action was succesful.
217 On the right there are status icons. 
219 ==== Status icons
220 image:Images/status-icons.png[]
222 Status icons are small icons indicating the state of a setting, a plugin or shows that something is in progress. 
224 Currently GMPC always shows the following status icons:
226 * Repeat
227 * Random
228 * Single mode
229 * Consume 
231 Some icons only show when f.e. MPD is updating it database.
232 All status icons should have a tooltip.
234 NOTE: Clicking a status icon may change its state.
236 NOTE: Some status icons, like from the gmpc-shout plugin, can have a context menu.
238 [[preferences]]
239 == Preferences
241 === Connection
242 image:Images/preferences-connection.png[]
244 In the connection pane you can configure the connection to MPD.
245 You can define multiple connection profiles. GMPC allows you to quickly switch between the different profiles.
247 * The 'Name' field holds the name GMPC shows for this connection.
248 * The 'Host' field holds the hostname off the MPD machine. It may also holds the path to a socket.
249 * The 'Port' field holds the port where MPD listens on. 
250 * 'Use authentication' tells GMPC to send the 'Password' field on connection. You need this, if you want an authentication with your MPD Server.
251 * The 'Music Directory' field allows you to tell GMPC where it can find the music.
254 === Server Settings
255 image:Images/preferences-server-settings.png[]
257 When connected to MPD, you can configure several parameters in MPD:
259 * 'Enable Crossfade': Tells MPD to fade the song out and the fade in the new song in 'fade time(s)' seconds.
260 * 'Replaygain': Select the replaingain mode.
261 * 'Output devices': Enable/disable output devices.
264 === Interface 
265 image:Images/preferences-interface.png[]
267 Configure GMPC interface.
269 * 'Hide on close': If the GMPC is closed, hide to the notification tray.  (If no notification tray is present, GMPC is minimized.)
270 * 'Stylize album covers': Make covers look like it is placed inside a casing.
271   image:Images/pc-cover.png["With casing"]
272   image:Images/pc-cover-plain.png["Withouth casing"]
273   
274 * 'Stop playing on exit':  If you quit GMPC, stop playback.
275 * 'Show song tooltip': Enabled tooltips on the song list. Showing an information about the song under the mouse pointer.
276 * 'Enable search as you type': Make GMPC search directly as you type. (Might be slow).
277 * 'Show buttons instead of dropdown in collapsed view': Changes the dropdown to a button list. See xref:sidebar[Sidebar].
278 * 'Center playing song': Make GMPC center the playing song in the play queue.
279 * 'Save position and size between sessions': Make GMPC store and retstore it size between sessions.
281 === Tag Based Browser 
282 image:Images/preferences-tag-based-browser.png[]
284 === Multimedia Keys
285 image:Images/preferences-multimedia-keys.png[]
287 === Notification
288 image:Images/preferences-notification.png[]
290 * 'Show on song change': This will pop a notification as soon as the song changes with information about the new song.
291 * 'Timeout': This is the time in seconds for which the notification lasts on the screen.
292 * 'Position': There are five options.
293 ** 'At the notification area icon': Notification is at the gmpc icon in the notification area.
294 ** 'Upper Left Corner': Notification is in the upper left corner of the screen.
295 ** 'Upper Right Corner': Notification is in the upper right corner of the screen.
296 ** 'Lower Left Corner': Notification is in the lower left corner of the screen.
297 ** 'Lower Right Corner': Notification is in the lower right corner of the screen.
298 * 'Enable': Tick box which enables the gmpc icon in the notification area when ticked.
299 * 'Show severity': The amount of messages which will be displayed in the gmpc window. This dropdown has four options.
300 ** 'information and up': Information messages, warnings and errors will be displayed.
301 ** 'warnings and up': Warnings and errors will be displayed.
302 ** 'errors': Only errors will be displayed.
303 ** 'none': Nothing will be displayed.
305 === Metadata Handler
306 image:Images/preferences-metadata-handler.png[]
308 The metadata handler is a function in GMPC to give priority to different plugins.
309 You can give every plugin a number between 1 and 100 where 1 is the lowest and 100 the highest priority.
310 GMPC will use these numbers to share the amount of resources between every plugin, this means the higher priority a plugin has, the more resources it gets allocated.
312 === Proxy
313 image:Images/preferences-proxy.png[]
315 === Metadata Browser
316 image:Images/preferences-metadata-browser.png[]
318 == Metadata Selector
319 You can open the metadata selector by right clicking on the metadata item, f.e. a lyrics and selecting 'metadata selector'.
320 image:Images/meta-data-selector-artist.png[]
321 image:Images/meta-data-selector-lyrics.png[]
323 If gmpc fails to find the right metadata, you can view all the results in the metadata selector.  You can edit the exact value of the query fields and retry the query.
324 As you can see in the above screenshots you can see the results, where they came from and the size (if it is an image)
326 The following items can be selected:
328 * Artist art
329 * Album cover
330 * Song lyric
331 * Album Information
332 * Artist Biography
333 * Guitar tab.
335 == Browsers
337 === Now Playing
338 image:Images/nowplaying.png[]
340 The now playing browser shows you all sorts of information about the song playing right now.
341 Information found on the now playing page changes as soon as a new track starts. 
343 * 'Album picture': The image in the upper left corner is the album picture.
344 * 'Song title': The big headlining text is the song title.
345 * 'Artist name': The performers of the current song.
346 * 'Album name': The album name in which the current song is featured.
347 * 'Genre': This displays the genre of the current playing song.
348 * 'Format': Format is giving information about sound specific information, the amount of channels, the frequency of the song and the amount of kbps.
349 * 'Codec': Codec used for decoding the song.
350 * 'Length': Length of the song in minutes, rounded downwords (2:10 = 2 minutes, 1:59 = 1 minute)
351 * 'Track number': Track number of the album it's featuring in.
352 * 'Artist picture': Image in the upper right corner is a picture from the artist.
354 Under the general information you can see a tabbed view of more information which we will explain now.
356 * 'Lyrics': Fetches and displays them when possible. (Lyrics can only be fetched when lyrics plugins are installed)
357 * 'Guitar Tabs': Fetches guitar tabs for the current playing song. (This only works with the Guitar Tabs plugin installed)
358 * 'Similar Songs': Will find similar songs in your own database based on the genre of the song.
359 * 'Similar Artists': Last.fm checks for similar artists and these results are displayed.
360 * 'Web Links': Shows several links to different pages.
361 * 'Artist Information': Shows information about the artist fetched from last.fm.
363 === Database
365 === Play Queue
366 image:Images/play-queue.png[]
369 This is basically your master-playlist. Every title you want to listen to will appear here. You can add songs to the play-queue by opening the context menu (right mouse click) in either the file in the database or the playlist-editor and selecting "Add". 
371 ==== Sorting
372 You can move a single song to a new location using drag and drop. You can move a single row by selecting it, and dragging it to the new location.
373 To quickly move around multiple songs you can cut, copy and then paste songs within the play-queue. It is even possible to copy songs from other lists and insert them at a certain position in the play-queue.
375 NOTE: GTK does not yet provide a method of moving multiple rows using drag and drop. Instead of adding this using dirty hacks, a more robust cut/copy/paste system was added.
377 ==== Filter
378 You can filter the play-queue by pressing 'ctrl-f' or start typing when it is selecting. The playlist filter supports the xref:query-syntax[Query syntax]. 
380 TIP: If the filter is slow in updating the playlist, because you are on a slow connection or MPD runs on a slow machine. You can disable search-as-you-type in the xref:preferences[preferences] pane.
383 ==== Editing columns
384 You can edit what columns GMPC displays in the play-queue (or any song list), by opening the xref:play-queue-context-menu[context-menu] (right click) and selecting 'edit columns'
386 [[play-queue-context-menu]]
387 ==== Context menu
388 If you do a right click on an entry of the play queue, you will get this context-menu:
390 image:Images/play-queue-rightclick.png[]
393 NOTE: This context-menu will depend on the plugins you have installed and activated. Some plugins cause an entry here, others don't.
396 ==== Useful key-bindings
398 * 'Center playing song': Hit the space bar.
399 * 'Delete selected song':  Hit del.
400 * 'Opening filter': Ctrl-f.
401 * 'Empty filter': Escape.
402 * 'Close filter':  Escape or backspace when empty.
404 TIP: If you enable 'Enable songlist tooltip' in xref:preferences[preferences] pane. Gmpc will show a tooltip with the album cover and some information about the song you are hovering.
409 === Tag Browser
411 === Search
413 === Metadata Browser
415 == Server Information
416 image:Images/server-information.png[]
418 [[query-syntax]]
419 == Query Syntax
421 The query syntax is used in the search browser, the playlist quick search and in easy command.
423 The syntax consists of the following:
425 ---------------
426 <field>=<value>
427 ---------------
429 This will search for value in the field field.
431 The following fields are supported:
433     artist
434     album
435     title
436     track
437     Name (applies to streams)
438     Genre
439     Date
440     Composer
441     Performer
442     Comment
443     Disc
444     Filename
445     AlbumArtist
446     Any (searches all the above fields) 
448 If your MPD does not support any of these fields, they will be ignored and seen as part of the command.
450 The search is tokenized and case insensitive, so for example:
452 -------------------
453 artist=eric clapton
454 -------------------
456 Will match both "eric clapton", "Clapton, Eric". To stop this tokenization wrap the values in (). For example:
458 ---------------------
459 artist=(Eric Clapton)
460 ---------------------
462 Will not match "Clapton, Eric".
465 To refine your search multiple queries can be concatenated:
467 For example:
469 ----------------------------------
470 artist=Eric Clapton album=Slowhand
471 ----------------------------------
473 There is also an option to run multiple queries at once by using the or operator ||:
475 -----------------------------------------
476 artist=Eric Clapton || artist=Norah Jones
477 -----------------------------------------
479 This will return all songs by Eric Clapton and Norah Jones.
481 NOTE: If <field= > is ommited, all fields are searched. 
484 == Easy Command
485 image:Images/Gmpc-easy-command.png[]
487 GMPC has an feature called "Easy Command". Easy command gives you a small command box, allowing you to quickly execute commands without having to use the mouse.
489 For example, send the command to gmpc to search in the play queue for the song Holy Mother from the artist Eric Clapton and play that song immediately the following could easily be typed.
491 First, start the "easy command" mode:
493 ----------
494 ctrl-space
495 ----------
497 Next, type the following command:
499 ------------------------------------------
500 play title=Holy mother artist=Eric Clapton
501 ------------------------------------------
503 You can also concatenate commands:
505 --------------------------------------------
506 clear; add artist=Strehli; play title=SRV
507 --------------------------------------------
509 You can also bind a global one in preferences -> Multimedia Keys.
511 Some commands use the xref:query-syntax[Query syntax].
513 === Implemented Easy Commands
514 To get a more uptodate list of possible commands, see Help -> Easy command help in gmpc.
516 ====  Switch
518 *    switch play queue: Switch to play queue
519 *    switch metadata browser: Switch to the metadata browser
520 *    switch search: Switch to the search browser 
522 ==== Main
524 *    quit: Quit gmpc
525 *    hide: Hide gmpc
526 *    show: Show gmpc
527 *    show notification: Show the tray-icon notification. (if enabled) 
529 ==== Playback
531 *    play: start playback
532 *    pause: pause playback
533 *    next: next song
534 *    prev: previous song
535 *    stop: stop playback
536 *    random (on|off): Random (on|off)
537 *    repeat (on|off): Repeat (on|off)
538 *    volume [+-]?[0-9]+: Volume <level>
539 *    mute: Mute
540 *    play .*: Play <query> 
542 *    seek hh:mm:ss: Seek to position
543 *    seek +hh:mm:ss: Seek relative to current position
544 *    seek -hh:mm:ss: Seek backwards relative to current position 
546 *    repeat current song: Repeats the currently playing song forever
547 *    stop after current song: Stops playback after current song.
548 *    consume (on|off)
549 *    single (on|off) 
551 ==== Play-Queue Manipulation
553 *    add .*: Add <query>
554 *    replace .*: Replace <query>
555 *    Clear play queue: Clear play queue 
556 *    Crop current song: Clears the whole play queue without removing the current playing song. 
558 ==== Search
560 *    search database .*: Search database <query>
561 *    search playlist .*: Search playlist <query> 
563 ==== Metadata Browser
565 *    show current song: Show the page of the current playing song.
566 *    show current artist: Show the page of the current playing artist
567 *    show current album: Show the page of the current playing album