Differences

This shows you the differences between two versions of the page.

--- third_party_apps:xchat [2008/11/11 01:06] – created lau1
+++ third_party_apps:xchat [2022/05/23 01:30] (current) – external edit 127.0.0.1
@@ Line 4: / Line 4: @@
 It's at a very early stage so be kind.
 It is inspired from rythmbox xchat perl plugin.
+The script is now capable of launching gmusicbrowser
+It will load gmusicbrowser automatically upon startup
+If you close gmusicbrowser then use one of the command it will let you know that it needs restarting.
+A new commands will let you do that.
 ===== Installing the script =====
-download it from
+Download it from
-http://sites.google.com/site/lcoudeur/Home/gmplay.pl.zip?attredirects=0
+https://sites.google.com/site/lcoudeur/Home/gmplay.pl4.zip?attredirects=0
+==== Changing the message displayed ====
+Edit the script (in your editor of choice) and update the message printed.
+<code perl>
+# message string
+my $playing ="écoute sur son magnétophone numérique"; #replace with your own message
+</code>
+The script can display all the informations provided by Dbus to modify the output:
+Dbus provides album, artist, disc, length, title, track.
+The current scrip displays artist - title - album
+As shown below.
+<code perl>
+sub gm_play{
+	my $info= $object->CurrentSong;
+	# hash keys are : album, artist, disc, length, title, track
+	# $info hash contains the keys value above. you can change below to display information you need. keep "me" (command will generate the slash).
+	Xchat::command "me $playing $info->{artist} - $info->{title} - $info->{album}";
+}
+</code>
+To display say artist - album - song - tracknumber
+you would use
+<code perl>
+Xchat::command "me $playing $info->{artist} - $info->{album} - $info->{title} - $info->{track}";
+</code>
+Once you are happy with it Load it into xchat.
+Xchat Menu -> Load plugin or script -> Browse to the location of the script.
+If you messed up you will get an error message :-P
+Along those lines... Compare the original script with your update, above or on the line number given.
+<code>
+ Error loading '/home/laurent/.xchat2/gmplay.pl':
+ Bareword found where operator expected at (eval 29) line 60, near ")
+ Xchat::print"
+ syntax error at (eval 29) line 60, near ")
+ Xchat::print"
+</code>
+If everything is fine Xchat will let you know by printing the message
+<code>
+ Loaded gmusic XChat 0.0.6:
+</code>
+===== gmusicbrowser is not loaded already. =====
+The script will start it.
+If you close gmusicbrowser and try to use a script command querying gmusicbrowser you will get a message telling you that it is not running.
+You can start then start it using the command /gm_start.
 ===== Commands available =====
-to be done (it's late ;))
+==== Help ====
+Now that you have installed and updated your script.
+What can it do ?
+In xchat type
+<code>
+/gm_help
+</code>
+You will be able to View this:
+<code>
+ gmusic XChat Help:
+   * Script Version:     0.0.6
+  About:
+   * Author: Laurent Coudeur <####################">
+  Commands:
+  * /gm_start	- starts gmusic browser when it has been closed.
+  * /gm_play - Display the current song playing to a channel.
+  * /gm_next - Skip to the next track.
+  * /gm_prev - Skip to the previous track.
+  * /gm_pause - Pause/start playback.
+  * /gm_browse - Open Gmusic UI window.
+  * /gm_volup - Increase volume.
+  * /gm_voldown - Decrease volume.
+  * /gm_help - Display this help screen.
+</code>
+There you have it
+  * /gm_start Starts gmusicbrowser if it's not present on dbus. It will not start a second instance. It pauses 4 seconds to allow the application to start.
+  * /gm_play does what it says on the tin. Displays the currently playing song information as set in previous paragraph.
+  * /gm_next skips the current song
+  * /gm_prev plays the previous song
+  * /gm_pause will pause a playing song, or restart a paused song.
+  * /gm_browse opens the gmusic browser window
+  * /gm_volup increase the volume (if your at the maximum level it won't)
+  * /gm_voldown decrease the volume (...)
 ===== Todo list =====
-Lots ;)
+Any suggestions?
-Updating the page...