zik 0.16.1

data/doc/ChangeLog

@@ -0,0 +1,222 @@
+###Version 0.16.1
+Fix a bug in french translation
+
+###Version 0.16.0
+Install missing gstreamer plugins.
+Export current songs to a directory and write a playlist file. (close #28702)
+Add gemspec file.
+Add --show-* options to choose the view on ZiK start.
+
+Add an option to hide errors dialogs.
+Fix an infinite loop triggered when all songs are inacessible.
+Fix a bug in cover module: covers where hidden.
+Fix a bug in sessions (Multi and single were switched in preferences dialog).
+Show the right time remaining when playing a "taglib unsupported format" song.
+
+Add ModError class so ZiK can handle errors in modules.
+Improve description of version for git version.
+
+translation:
+ update french.
+
+###Version 0.15.3
+Bug fixes (in assistant and others).
+
+translation:
+ fix typos in french translation.
+
+###Version 0.15.2
+Fix ZiK crash when running the assistant.
+Do not crash on ZiK start if gstreamer ofa element is not found (brainz module).
+Hide edit in playlist menu to avoid a bug (#28638).
+
+translation:
+ fix typos in french.
+
+###Version 0.15.1
+Fix a bug in hotkeys module.
+
+###Version 0.15.0
+
+An assistant is showed first time ZiK is launched.
+Do not show a new window when editing playlist.
+ You can now edit playlist in main window even if you still need to hit the edit button before.
+Searching for tracks in playlist is now integrated to the main window.
+Add a compact view option to show more tracks in playlist.
+Hide modules configuration in preferences dialog.
+Move buttons to left side of the window in radio and cd views.
+Fix a bug in search window: do not show results of previous searches.
+Add a man page.
+Use sexier interface for extensions and directories configuration in preferences dialog and in assistant.
+Support new version (0.2.0) of rghk.
+ Old versions are still supported for now.
+Support ruby-taglib2
+ ruby-taglib is still supported but depracated
+Support gtk 2.22+
+Set the license for pix/ZiK.svg.
+
+translation:
+ fix typo in french translation.
+ update french translation.
+
+###Version 0.14.0
+
+Improve experience with ruby 1.9. (Thanks to Joël Obrecht for his reports on the forum)
+New feature: Single session.
+New Module: Brainz. Use musicbrainz.org to tag your tracks.
+Add modules authors in credits.
+Fix a typo: the playlist format is xspf not xspdf!
+
+Let users acces module configuration even if the module is not load. Close bug #27912.
+Update the displayed track name in player zone when the playlist is refreshed.
+Get track duration from GStreamer if taglib return a negative duration.
+
+Improve support of xspf format.
+Add xspf and pls support in desktop file.
+Reduce main menu. Show only items corresponding to the selected view.
+Deactivate previous/next buttons when playing webradios.
+Show module area when the expander is point down.
+Bug #27950: the add button can now add severals audio files. Only a playlist file could be add in previous versions.
+Fix bug #27948: tags of song longer than 1 hours cannot be edited.
+Add the quiet option on .desktop file to avoid filling ~/.xsession_errors file.
+Fix a bug: `ZiK --version` did not display the current version.
+Fix a bug: convert track to integer when reading configuration.
+Build modules area only when a module requires it.
+
+Drop support for old configuration file format.
+Redefine methods handling modules expander.
+
+translation:
+ update french.
+
+###Version 0.13.1
+Add credit for artists.
+Fix a bug. Playing radio could freeze ZiK.
+
+###Version 0.13.0
+ZiK will now use the active playlist when next/previous buttons are hitted and
+ do not rely on active view for choosing the next song.
+New module to define global hotkeys.
+Import of radios list in m3u format.
+
+More tooltips.
+Show hours if the song length is greater than 60 min.
+Add an expander in Cover module.
+Redirect error output to /dev/null when ZiK is called with the quiet option.
+Some change in the module API.
+Fix a bug: player could stop when deleting a radio.
+Fix a bug: seeking was disable when current view was different from current player.
+Fix a bug: the wrong track is played if player is paused when trying to play another tracks.
+
+I thank ubuntu-fr forum users for their tests.
+
+###Version 0.12.0
+Notify module : use of system notifications as an option.
+Trayicon module : icon can now interact with ZiK on scroll events.
+Cover module : hide if no cover is found (option).
+
+The mouse cursor show that ZiK is busy when refreshing the browser view.
+Show hours if song's duration > 3600 s. Reported by nexus5 on linuxfr.org
+Add some tooltips in preferences window.
+Add spaces between widgets in preferences window.
+Display ZiK version on start.
+Do not modify ruby LOAD_PATH anymore.
+Do not add track number to songs' name if this number is negative.
+
+Fix a bug : preferences dialog can crash ZiK. Thanks Simon Arnaud from ruby/gnome2 mailling list.
+Fix bug 27520: Finding in browser was broken. Reported by Balint Dobai-Pataky.
+Fix a bug in cover modules. Thanks soupaloignon for report on forum.ubuntu-fr.org
+Fix a small bug in configure script.
+
+###Version 0.11.2
+Previous versious was released with 0.11.0 code.
+
+###Version 0.11.1
+Drop Gtk.idle (deprecated) to GLib::IDle.
+Fix severals minor bugs in modules.
+
+###Version 0.11.0
+Radios list can now be reordered.
+Starting ZiK is faster.
+ Save the list of files shown on browser.
+ Change the code used to build browser tree.
+ Save tags of songs.
+Show song's name in trayicon tooltip.
+Hide covers when playing radios.
+Users can now choose forground color for notify module.
+Implements destdir in configure script.
+
+Fix a bug in configure script (bindir, datadir, etc were not set correctly).
+Fix bugs when dealing with xspdf files containing relative paths.
+
+###Version 0.10.0
+New module: cover.
+Display remaining time.
+New key binding to focus on current song.
+
+###Version 0.9.1
+Fix a bug: crash while reading configuration file.
+Fix a bug that occurs when deleting a "paused song".
+
+###Version 0.9.0
+Support xspdf format.
+Save playlist using relative path (option).
+New module: Notify.
+Improve launch time.
+Improve integration with desktop.
+ Add a desktop file.
+ Add some minetypes.
+Fix bug: crash when adding a playlist containing wrong path.
+Fix bug: song's name with "&" were not correctly displayed.
+Enable ZiK command (ZiK is a link to ZiK.rb).
+Enable double-click in browser to add a file in playlist.
+Add options to disable features.
+Write modclass (used to wrrite a module) and rewrite TrayIcon module.
+
+###Version 0.8.1
+Improve command line (add or append severals files).
+Add a dialog to edit webradios.
+Reorder playlist by drag&drop in "Edit playlist" window.
+Reorder directories in preferences.
+Add sort by track option.
+Add shuffle and repeat items in menu.
+Play next song on errors instead of stopping the player.
+Check for gst-plugins-base and svg rendering in dependencies script.
+ See bug 23569
+ Thanks to le.nox from the ubuntu-fr for the report.
+Display audio properties in edit tag windows.
+
+###Version 0.8.0
+Follow redirection when a webradio is moved (url changed).
+Drag&drop from browser to playlist.
+Drag&drop from other applications (nautilus).
+Add sort options for browser
+ directories before files,
+ case sensitive.
+Add tooltips
+Delete songs using delete key.
+
+Fix bug in webradio player.
+ Use other urls in playlist if the first one failed.
+Fix bug #23435 (crash when editing tags)
+Fix bug (Files not always added when directory names contain [ or ] carcters)
+ Thanks to draco for his test.
+Fix bug (crash  when editing an empty playlist)
+ Thanks to mathieuI from the ubuntu-fr for the report.
+Fix bug #23436 (crash when using a invalid search pattern)
+ thanks to le.nox for the report.
+
+###Version 0.7.1
+Fix bug #23404 (crash when selecting radio view).
+ Thanks to le.nox from ubntu-fr for the report.
+
+#***0.7.0***
+Change for ruby-gstreamer librairy (from ruby-gnome2 project).
+This change seems to fix bugs with recent gstreamer version (?).
+
+#***0.6.0***
+Rewrite from scratch.
+Add cd support.
+
+#***0.5.5***
+First public version on rubyforge.

data/doc/html/fr/index.html

@@ -0,0 +1,128 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" >
+	<head>
+		<title>Lecteur audio ZiK</title>
+		<meta name="Keywords" content="audio,lecteur, zik" /> 
+		<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+		<link rel="stylesheet" media="screen" type="text/css" title="main" href="../styles/main.css" />
+		<link rel="shortcut icon" href="../pix/icon.png" />
+	</head>
+	<body>
+		<div id="header"><p><img src="../pix/logo.png" alt="logo ZiK"/> Audio player ZiK</p></div>
+		
+		<div id="side">
+			<ul>
+				<li><a href="../index.html">English</a></li>
+				<li><a href="index.html">Français</a></li>
+			</ul>
+			<ul>
+				<li><a href="#main">Fenêtre principale</a></li>
+				<li><a href="#start">Premiers pas</a></li>
+				<li><a href="#compact">Vue compacte</a></li>
+				<li><a href="#edit">Éditer la liste de lecture</a></li>
+				<li><a href="#search">Recherche</a></li>
+				<li><a href="#cd">Cd</a></li>
+				<li><a href="#radio">Radio</a></li>
+				<li><a href="#format">Formats supportés</a></li>
+				<li><a href="#binding">Raccoucis clavier</a></li>
+			</ul>
+		</div>
+		
+		<div id="main">
+			<h1><img src="../pix/ZiK3.png" alt="ZiK"/></h1>
+			<p>
+				ZiK est un lecteur audio basé sur gstreamer.
+				L'interface n'utilise pas de bibliothèque audio mais s'appuye sur les chemins des fichiers.
+				Ce logiciel libre est distribué sous licence GPL.
+			</p>
+			
+			<h2 id="window">Fenêtre principale</h2>
+			<img src="../pix/capture.png" alt="capture de la fenêtre principale"/>
+			<ol>
+				<li>Navigateur: affiche le contenu audio des répertoires choisis.</li>
+				<li>Boutons: gérent la liste de lecture (ajouter des chansons depuis le navigateur, supprimer des chansons de la liste de lecture...).</li>
+				<li>Liste de lecture.</li>
+				<li id="selector">Sélecteur de vue: affiche ou non le navigateur, la liste de lecture.</li>
+			</ol>
+			
+			<h2 id="start">Premiers pas</h2>
+			<p>
+				Tout d'abord, ZiK doit savoir où se trouvent vos fichiers musicaux.
+				Préciser les répertoires dans les préférences (<em>Menu navigation, préférences</em>).
+				Seuls les répertoires indiqués (et leur sous-répertoires) sont affichés dans le navigateurs.
+				De plus, l'affichage ne prend en compte que les fichiers dont l'extension est explicitée dans les préférences.
+			</p>
+			<p>
+				Ajouter les fichiers choisis à la liste de lecture en cliquant le bouton <em>+</em>.
+				Écouter vos musiques préférées.
+			</p>
+			
+			<h2 id="compact">Vue compacte</h2>
+			<img src="../pix/capture_compact.png" alt="Capture de la vue compacte"/>
+			<p>
+				Sélectionner l'élément lecture grâce au <a href="#selector">sélecteur de vue</a>.
+			</p>
+			
+			<h2 id="edit">Éditer la liste de lecture</h2>
+			<p>
+				Modifier l'ordre des pistes de la liste ainsi que modifier le tag associé à chaque fichier.
+			</p>
+			
+			<h2 id="search">Recherche</h2>
+				<h3>Navigateur</h3>
+				<p>
+					Recherche de fichiers basée sur le chemin du fichier ou sur les métadonnées (tag).
+					Régler les options de la recherche dans les préférences.
+				</p>
+				
+				<h3>Liste de lecture</h3>
+				<p>
+					Recherche de chansons basée sur leur nom.
+					<em>Ctrl+f</em> permet de démarrer une recherche.
+				</p>
+			
+			<h2 id="cd">Cd</h2>
+			<img src="../pix/capture_cd.png" alt="Capture de la vue cd"/>
+			<p>
+				Sélectionner l'élément cd à l'aide du <a href="#selector">sélecteur de vue</a>.
+				Si votre cd n'est pas trouvé par le programme, modifier le chemin du lecteur dans les préférences.
+				Pour lire un cd, vous devez installer:
+			</p>
+			<ul>
+				<li><a href="http://pablotron.org/software/mb-ruby/">mb-ruby</a></li>
+				<li><a href="http://gstreamer.freedesktop.org/">gst-plugins-good</a></li>
+				<li><a href="http://gstreamer.freedesktop.org/">gst-plugins-ugly</a></li>
+			</ul>
+			
+			<h2 id="radio">Radio</h2>
+			<img src="../pix/capture_radio.png" alt="Capture de la vue radio"/>
+			<p>
+				Sélectionner l'élément radio l'aide du <a href="#selector">sélecteur de vue</a>.
+				Pour ajouter une radio, indiquer l'url de cette dernière ainsi qu'un nom.
+			</p>
+			
+			<h2 id="format">Formats supportés</h2>
+			<ul>
+				<li>
+					Fichier: tous les formats supportés par gstreamer.
+					Dépend de quel <a href="http://zik.rubyforge.org/wiki/wiki.pl?Supported_Formats">plug-ins pour gstreamer</a> sont installés.
+				</li>
+				<li>Liste de lecture: m3u, pls.</li>
+			</ul>
+			
+			<h2 id="binding">Raccoucis clavier</h2>
+			<ul>
+				<li><em>Ctrl+p</em>: lecture/pause</li>
+				<li><em>Ctrl+s</em>: arrêt</li>
+				<li><em>Ctrl+b</em>: piste précédente</li>
+				<li><em>Ctrl+n</em>: piste suivante</li>
+				<li><em>Ctrl+flèche vers le haut</em>: augmenter le volume</li>
+				<li><em>Ctrl+flèche vers le bas</em>: diminuer le volume</li>
+				<li><em>Ctrl+f</em>: recherche dans la liste de lecture</li>
+				<li><em>Ctrl+d</em>: centrer la liste de lecture sur la chanson courante</li>
+				<li><em>F1</em>: aide</li>
+				<li><em>Suppr</em>: supprimer les chansons sélectionnées de la liste de lecture</li>
+			</ul>
+		</div>
+	</body>
+</html>

data/doc/html/index.html

@@ -0,0 +1,126 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" >
+	<head>
+		<title>Audio player ZiK</title>
+		<meta name="Keywords" content="audio, player, zik" /> 
+		<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+		<link rel="stylesheet" media="screen" type="text/css" title="main" href="styles/main.css" />
+		<link rel="shortcut icon" href="pix/icon.png" />
+	</head>
+	<body>
+		<div id="header"><p><img src="pix/logo.png" alt="ZiK logo"/> Audio player ZiK</p></div>
+		
+		<div id="side">
+			<ul>
+				<li><a href="index.html">English</a></li>
+				<li><a href="fr/index.html">Français</a></li>
+			</ul>
+			<ul>
+				<li><a href="#main">Main window</a></li>
+				<li><a href="#start">Getting start</a></li>
+				<li><a href="#compact">Compact view</a></li>
+				<li><a href="#edit">Edit playlist</a></li>
+				<li><a href="#search">Search</a></li>
+				<li><a href="#cd">Cd</a></li>
+				<li><a href="#radio">Radio</a></li>
+				<li><a href="#format">Supported formats</a></li>
+				<li><a href="#binding">Key bindings</a></li>
+			</ul>
+		</div>
+		
+		<div id="main">
+			<h1><img src="pix/ZiK3.png" alt="ZiK"/></h1>
+			<p>
+				ZiK is an audio player based on gstreamer.
+				It uses the path of your audio files instead of a music library.
+				This free software is released under the GPL license.
+			</p>
+		
+			<h2 id="window">Main window</h2>
+			<img src="pix/capture.png" alt="Capture of the main window"/>
+			<ol>
+				<li>Browser: show the audio content of directories.</li>
+				<li>Buttons: manage the playlist (add songs from the broswer, remove song from the playlist...).</li>
+				<li>Playlist: show songs.</li>
+				<li id="selector">View selector: display or not the browser, the playlist.</li>
+			</ol>
+			
+			<h2 id="start">Getting start</h2>
+			<p>
+				First, ZiK need to know where is your audio collection.
+				Fill in the preferences dialog (<em>Menu browser, preferences</em>).
+				ZiK browse only the selected paths (and subfolders).
+				Only files with the selected extensions are shown in the broswer view.
+				<br />Select files from the browser and add them to the playlist by clicking the <em>+</em> button.
+				<br />Play your favorite songs.
+			</p>
+			
+			<h2 id="compact">Compact view</h2>
+			<img src="pix/capture_compact.png" alt="Capture of the compact view"/>
+			<p>
+				Select the play item on the <a href="#selector">view selector</a> to hide the browser and the playlist.
+			</p>
+			
+			<h2 id="edit">Edit playlist</h2>
+			<p>
+				Change songs order in playlist and edit songs' tag.
+			</p>
+			
+			<h2 id="search">Search</h2>
+				<h3>Browser</h3>
+				<p>
+					Search for files based on path or songs' tag.
+					Set the search options in the preferences dialog.
+				</p>
+				
+				<h3>Playlist</h3>
+				<p>
+					Search for songs based on names.
+					Use <em>Ctrl+f</em> to start a search.
+				</p>
+			
+			<h2 id="cd">Cd</h2>
+			<img src="pix/capture_cd.png" alt="Capture of the cd view"/>
+			<p>
+				Select the cd item with the <a href="#selector">view selector</a>.
+				If your cd is not found change the path of your cd device in the preferences dialog.
+				In order to enable cd support you have to install:
+			</p>
+			<ul>
+				<li><a href="http://pablotron.org/software/mb-ruby/">mb-ruby</a></li>
+				<li><a href="http://gstreamer.freedesktop.org/">gst-plugins-good</a></li>
+				<li><a href="http://gstreamer.freedesktop.org/">gst-plugins-ugly</a></li>
+			</ul>
+			
+			<h2 id="radio">Radio</h2>
+			<img src="pix/capture_radio.png" alt="Capture of the radio view"/>
+			<p>
+				Select the radio item with the <a href="#selector">view selector</a>.
+				To Add your webradio enter an url and choose a name.
+			</p>
+			
+			<h2 id="format">Supported formats</h2>
+			<ul>
+				<li>
+					File: all formats supported by gstreamer.
+					Depends on which <a href="http://zik.rubyforge.org/wiki/wiki.pl?Supported_Formats">gstreamer plug-ins</a> are installed.
+				</li>
+				<li>Playlist: m3u, pls.</li>
+			</ul>
+			
+			<h2 id="binding">Key bindings</h2>
+			<ul>
+				<li><em>Ctrl+p</em>: play/pause</li>
+				<li><em>Ctrl+s</em>: stop</li>
+				<li><em>Ctrl+b</em>: previous song</li>
+				<li><em>Ctrl+n</em>: next song</li>
+				<li><em>Ctrl+up</em>: volume up</li>
+				<li><em>Ctrl+down</em>: volume down</li>
+				<li><em>Ctrl+f</em>: search in playlist</li>
+				<li><em>Ctrl+d</em>: focus on current song</li>
+				<li><em>F1</em>: help</li>
+				<li><em>Del</em>: delete selected songs from playlist</li>
+			</ul>
+		</div>
+	</body>
+</html>