by Gabriel Indurskis
Overview
This is a command line based on the XOSD library.Installation and Configuration
Download
Latest Version: osd-cl-client-0.8.tar.gz (21kB)
Installation
Quick installation guide
(see README for more information)
This script can be run by any user on any machine with network access to the GiantDisc server. It was developed and tested on SuSE Linux 9.3, but should work on virtually any Linux/Unix system - possibly even on Windows, if you have the requirements mentioned below.
To install, simply put the script 'gdosdclient' somewhere in your path ("/home/user/bin" is a good candidate) and make sure it is executable ("chmod u+x gdosdclient").
To get started, make sure that the GiantDisc server plus one gdd-listener script is running on your music server, then simply run 'gdosdclient' in a shell. The script will automatically create a standard configuration file in /home/user/.gdosdclient/config and will set a few default values (including the server settings). Before continuing, you will have to make sure that the settings match your network. To change, select "options" from the main menu - or call "gdosdclient options".
Requirements:
on the server:
- working GiantDisc installation (possibly on a different machine) - IMPORTANT: the server scripts have to be recent, 1.41-3 (beta) or later (or revision 35 or later from the svn repository), as we use some new (beta) communication protocols.
- a GiantDisc listener script running on the server, only to be used by this client (see the manual: http://www.giantdisc.org/man/man2.php#Multiple_Clients_Controlling_One_Server )
- perl (for the script that sends the commands to the GiantDisc server)
- bash (for gdosdclient itself)
- dialog
- Xdialog (optional) - see http://xdialog.dyns.net if it missing on your system.
- X-OSD libraries (including the command 'osd_cat') - see http://www.ignavus.net/software.html
- standard tools like 'awk', 'sed', 'cut', 'grep' etc.