UpdateTitle par Loc - loic@magic-radio.fr
http://www.magic-radio.fr
http://utils.magic-radio.net
========================================================================

V2.9 pour windows NT4/2000/2003/2008/XP/Vista/7/8 (ne fonctionne plus sous 95/98/Me depuis l'ajout de la gestion de ZaraRadio).

Historique
========================================================================
2.9 (29/09/2012)
	Compatible avec SHOUTcast DNAS 2.0:
	Cela l'tait dj mais a updatait que le streamid=1 par dfaut, il est maintenant possible d'indiquer
	le streamid (champ sid) et donc le stream pour lequel on souhaite updater le titre

2.8.5
	Correction d'un bug apparu depuis la versio 2.8.2: lorsque dans le champ Advert on utilise ni F#, ni R# ni Z#,
	le titre courant et prcdent stocks dans title-current.txt et title-previous.txt taient crass  chaque nouvel advert.
	et celui-ci n'tait pas renseign dans title-next.txt !

	L'URL est maintenant appele avec l'advert. en parametre.
	Si par exmple vous avez indiqu l'URL suivante :
	http://mywebsite.com/page.php?title=
	Le propgramme appellera automatiquement cette 2eme URL  chaque nouvel advert. :
	http://mywebsite.com/page.php?title-advert=

2.8.4
	Il est maintenant possible d'indiquer un login/password et/ou un port diffrent de 80 dans le champ URL
	Exemple : http://login:password@mywebsite.com:8080/page.php?title=
	L'authentification gre est de type Base64.
2.8.3
	Correction d'un bug pour Zara lorsque le titre contient plus d'un ~ dans le nom de fichier
2.8.2
	Le titre suivant est stock dans le fichier title-next.txt
2.8.1
	Gestion de Zara 1.6

2.8 Beta
	permet de grer l'affichage tu titre courant et  suivre avec ZaraRadio.
	Si le titre suivant est un titre  ignorer (c'est  dire compris dans les tags),
	UpdateTitle2 va automatiquement chercher le titre suivant dans la playlist de ZaraRAdio jusqu'
	ce qu'il trouve un titre "conforme". 
	A t test sous XP SP2 avec ZaraRadio 1.4.4

2.7 Beta
	permet de grer correctement l'affichage du titre suivant avec Raduga.
	Si le titre suivant est un titre  ignorer (c'est  dire compris dans les tags),
	UpdateTitle2 va automatiquement chercher le titre suivant dans la playlist de Raduga jusqu'
	ce qu'il trouve un titre "conforme" avec une recherche maximum de n+10 dans la playlist. 

	Attention !!! La valeur du 2eme petit champ pour Raduga a chang : 
	pour Raduga 3.8, la valeur des 2 champs est en thorie 10/0 et pour Raduga 3.6 et 3.1.1
	la valeur 11/1. Utilisez le bouton Test pour valider. 

2.6
	Ajout de l'affichage du titre suivant pour Raduga.
	Possibilit d'insrer un texte devant l'advert. (exemple "A suivre : " si l'advert. est utilis pour l'affichage du titre suivant)
	Ajout d'un bouton Auto Start pour le titrage et l'advert.
2.5
	Ajout d'un bouton "Browse" pour l'advert.
	Permet d'indiquer un fichier texte pour l'affichage de l'advert.
	Peut tre utilis pour l'affichage du titre suivant par exemple.
2.4.1
	Boutons "Browse" activs.
2.4
	Possibilit d'indiquer un fichier texte pour le titre courant.

2.3
	Appel d'une URL pour MAJ de l'affichage du titre courant
	sur un site web.

2.2.1
	Sauvegarde des paramtres de l'"Advert." dans la registry

2.2
	Activation de l'"Advert.", permet d'afficher un message 
	intervalle rgulier

2.1
	Gestion de DRS2006 Radio Studio

2.0
	Version officielle publique

Description
========================================================================
UpdateTitle permet d'updater les titres que vous diffusez  partir
d'un player Winamp, Raduga, ZaraRadio, DRS2006 ou d'un fichier texte sur un serveur
shoutcast ou icecast.
Cet update est effectu au travers de Meta data contenus dans le stream
diffus par le serveur.

Il permet galement de grer l'affichage du titre courant et prcdent
sur un t'chat via des fichiers textes qui sont crs automatiquement
 chaque nouveau titre jou dans le player.

Le logiciel permet galement de prendre en compte le buffer du stream
ainsi que le buffer d'un ventuel crossfader utilis dans le player.
Cela permet d'updater de manire correcte les titres sur le serveur
de diffusion ainsi que sur le t'chat (affichage du titre au moment ou l'auditeur
entend le dbut de sa diffusion).

Utilisation gnrale
========================================================================
il suffit de renseigner les parametres du serveur shoutcast ou icecast
 updater, puis de choisir le type de player utilis ou un fichier texte.
Il suffit ensuite d'appuyer sur le bouton Start pour lancer la gestion automatique
de mise  jour des titres. Le gestion automatique continuera de fonctionner en permanence
jusqu' l'arrt du logiciel ou si on appuie sur Stop.
Si Winamp ou Raduga est ferm et r-ouvert alors que UpdateTitle tait en mode automatique,
celui-ci retrouvera automatiquement le player pour reprendre l'affichage des titres.
Un mise  jour manuelle des titres peut tre faite avec le champ "Titre" et le
bouton "Update".

Champs/Boutons			Dtails
========================================================================
Server IP			Entrez ici l'adress IP du serveur shoutcast ou icecast cible.

Server Port			Entrez ici le port du serveur shoutcast ou icecast cible.

Stream buffer			Entrez ici la dure en milliseconde du buffer du serveur de
				diffusion. Pour un serveur shoutcast > 1.7, la valeur par dfaut
				est de 15000ms,pour un serveur icecast 2.2.0, la valeur par dfaut est
				de 6000ms. Cette valeur sera utilise pour l'affichage
				des titres sur le chat afin de prendre en compte le dcalage
				de diffusion de la musique.

Server admin/dj password	Entrez ici le mot de passer admin/dj du serveur cible.
				S'il s'agit d'un serveur shoutcast, il peut s'agir du mot
				de passe admin, ou bien du mot de passe DJ. Pour un serveur
				icecast, cela doit tre le mot de passe admin du serveur.

Server type			Choisissez le type de serveur cible, shoutcast ou icecast.
				Seuls les serveurs icecast 2.0 de version >= 2.2.0 sont grs.

sid				Pour SHOUTcast DNAS 2.0, permet d'indiquer l'ID du stream pour lequel
				on souhaite updater le titre.

Mount point			Entrez le point de montage du stream icecast dont vous voulez updater
				l'affichage des titreS. N'est pas utilis pour un serveur de type
				shoutcast.

Titles directory		Entrez ici le chemin du repertoire dans lequel seront stocks les 3 fichiers
				permettants de grer l'affichage du titre courant, prcdent et suivant sur un t'chat.
				Fichiers : title-current.txt, title-previous.txt et title-next.txt
				Voir en annexe un exemple de script mIRC utilisant ces trois fichiers.

URL				Permet d'indiquer une URL qui sera appele pour metter  jour le titre courant
				sur un site web. Le titre courant sera concatn  cette URL.
				Exemple:
				si l'url est "http://mywebsite.com/page.php?title=" l'URL qui sera appele sera
				"http://mywebsite.com/page.php?title=artise - titre"
				La MAJ se fera en meme temps que le fichier title-current.txt, permettant ainsi
				d'avoir un affichage synchronis de la mme manire que le "chat".

Enable URL			Permet d'activer la fonction URL.

Update parameters		Ce bouton permet de mettre  jour dans le logiciel les parametres du serveur
				ainsi que le chemin du repertoire des fichiers. Vous devez appuyer sur ce bouton
				lorsque vous avez effectu un changement dans les paramtres. Lorsque vous lancez
				le logiciel et que les paramtres sont corrects, il n'est pas ncessaire d'appuyer
				sur le bouton.

Player type			Indiquez ici le type de player que vous utilisez, Raduga/ZaraRadio, Winamp, DRS2006 ou un fichier texte.
				Le logiciel trouvera automatiquement le player en question. Pour Winamp, il est possible d'indiquer une classe
				de fentre (voir champ Winamp windows class) si vous avez une instance particulire de Winamp
				qui est lance.
				Pour Raduga/ZaraRadio, vous pouvez rgler la position de la fentre de titre courant et suivant dans les 2 petits champs  cot
				du choix "Raduga/Zara". Pour Raduga 3.8/ZaraRadio 1.4.4, la valeur est en thorie 10/0, pour ZaraRadio 1.6 11/0,
				et pour Raduga 3.6 et 3.1.1 la valeur 11/1, mais si le soft ne trouve pas correctement le titre courant et suivant, modifiez cette valeur
				en mtant 9, 10, 11 ou 12 par exemple, jusqu' ce que le soft ait bien trouv le titre en cours dans Raduga/ZaraRadio.
				Utiliser le bouton Test afin de rgler les 2 positions.
				Si vous indiquez un fichier texte, celui-ci doit exister. Le logiciel lira la premiere ligne de texte contenu
				dans le fichier, il faut donc que la ligne contienne le titre en texte brut sous la forme "Artiste - Titre" par exemple.

Test				Permet de tester la valeur des champs positions pour Raduga afin de trouver la fentre du titre en cours
				et du titre suivant.

Player buffer (crossfader)	Indiquez ici la dure en milliseconde du buffer d'un ventuel crossfader utilis dans le player.
				Par exemple, si vous utilisez le crossfader SqrSoft et que celui-ci est paramtr avec
				un buffer de 15 secondes, indiquez 15000 dans le champ. Ce parametre permet de grer le fait que le changemet
				de titre sera effectu en avance par le crossfader, et donc permet d'viter que le titre ne s'affiche
				en avance sur le player de l'auditeur ou sur le t'chat.

Winamp window class		Permet d'indiquer le nom de la classe de fentre du Winamp dont on veut rcuprer les titres jous.
				La valeur par dfaut est "Winamp v1.x" mais si vous lancez une instance de Winamp avec une classe
				spcifique, undiquez dans ce champ le nom de la classe utilis.

Text file path			Permet d'indiquer le chemin complet du fichier contenant le titre en cours. Ce fichier doit tre de type
				texte et doit contenir le titre en cours sous forme de texte brut et sur la premire ligne.
				Exemple : "Artiste - Titre"

Default				Permet d'indiquer dans le champ "Winamp window class" la valeur du nom de la classe par dfaut
				de Winamp.

Title				Permet de saisir un titre ou un commentaire qui sera ensuite updat manuellement avec le bouton "Update"

Update				Permet de mettre  jour le titre ou le commentaire indiqu dans le champ "Title".
				Ce bouton n'est accessible que si le logiciel n'est pas en mode Automatique, c'est  dire avec le bouton
				Stop "gris".

Advert. (version Beta)		Permet d'indiquer un texte qui sera affich  la place du titre,  intervalle rgulier pendant un temps donn,
				le titre courant tant r-affich ensuite.
				Si un fichier texte est indiqu, il est possible d'insrer un texte devant l'advert. en utilisant la syntaxe suivante :
				F#A suivre : #D:\Studio\Titles\next.txt
				Pour afficher le titre suivant avec Raduga, il faut indiquer R#
				Pour afficher le titre suivant avec ZaraRadio, il faut indiquer Z#
				Il est galement possible d'insrer un texte devant l'advert. en utilisant la syntaxe suivante :
				R#A suivre : #
				Z#A suivre : #

	Browse			Permet d'indiquer un fichier texte pour l'affichage de l'advert.
				Peut tre utilis pour l'affichage du titre suivant par exemple.
				Le champ advert. commence alors obligatoirement par F# afin d'indiquer qu'il s'agit d'un fichier et non d'un texte simple.
	Start			Permet de dmarrer l'"Advert."
	Stop			Arrte l'"Advert."
	Timer			Indique l'intervalle d'affichage de l'"Advert."
	Delay			Indique le temps pendant lequel l'"Advert." doit rester affich

Start				Permet de lancer la gestion automatique de mise  jour des titres sur le serveur shoutcast ou icecast,
				ainsi que pour le t'chat.

Stop				Stoppe la gestion automatique.

Timer				Permet d'inidiquer l'intervalle utilis pour dtecter le changement du titre jou dans le player.
				1000 ms convient trs bien en gnral. Ne pas mettre une valeur trop faible, vous risquez de consommer
				un peu de CPU, il n'est de toute faon pas possible d'indiquer une valeur infrieure  1000 ms pour
				Winamp, Raduga ou DRS 2006, et 5000 ms pour un fichier texte afin d'viter de faire trop d'accs disque.

Auto start title		Permet de dmarrer automatiquement le titrage lors du lancement du logiciel.
				Une attente de 15 seconde est effectue au dbut pour attendre que le player (raduga, DRS ou Winamp) soit lanc (peut tre utile au boot)

Auto start advert.		Permet de dmarrer automatiquement l'advert. lors du lancement du logiciel.
				Une attente de 15 seconde est effectue au dbut pour attendre que le player (raduga, DRS ou Winamp) soit lanc (peut tre utile au boot)

Empty Titles or...		Permet d'indiquer des tags pour ignorer certains titres. Sparer les tags par des ;
				Par exemple, si vous indiquez -- comme tag, les titres commencant par -- seront ignors.

Ignore Titles...		Permet d'indiquer qu'il ne faut pas prendre en compte les titres qui ne contiennent pas " - ".

Quit				Permet de quitter l'application.

=================================================================
Si vous constatez que l'affichage des titres dans le player et/ou sur le chat n'est pas bien synchronis avec le titre en cours,
essayez de "jouer" sur les paramtres "Stream buffer" et "Player buffer (crossfader)".

Tous les peramtres du logiciel sont sauvegards dans la base de registre de Windows sous:
HKEY_CURRENT_USER\Software\UpdateTitleApp\UpdateTitle2\Params
Il est dconseill d'essayer de modifier la registry  la main.

Astuce:
si vous devez updater les titres sur plusieurs serveurs simultanment, vous pouvez copier l'executable UpdateTitle2.exe en UpdateTitle2-stream2.exe
par exemple et lancer le 2eme excutable en parallle du 1er. Indiquez les paramtres propres au 2eme serveur  grer et appuyez sur Start.
Les prfrences seront sauvegardes sparment. Par exemple, pour UpdateTitle2-stream2.exe, les prfrences se trouveront dans:
HKEY_CURRENT_USER\Software\UpdateTitleApp\UpdateTitle2-stream2\Params
Ainsi vous pouvez grer autant de serveur que ncessaire en copiant simplement l'excutable et en le renommant pour chaque nouveau serveur  grer.


Annexes
=================================================================
Exemple de script remote  insrer dans mIRC pour grer l'affichage des titres sur un t'chat :

on 1:TEXT:!titre*:#mawebradio: {
   /describe $chan **-*- En ce moment sur mawebradio : $read -nl1 C:\Titles\title-current.txt
}

on 1:TEXT:!avant*:#mawebradio: {
   /describe $chan **-*- Titre prcdent : $read -nl1 C:\Titles\title-previous.txt
}

on 1:TEXT:!apres*:#mawebradio: {
   /describe $chan **-*- Titre suivant : $read -nl1 C:\Titles\title-next.txt
}
