~ubuntu-branches/ubuntu/quantal/freeguide/quantal

<address><a href="index.html">Home</a> | <a href="README.html">README</a> | <a href="FAQ.html">FAQ</a> | <a href="userguide.html">User Guide</a> | <a href="LookAndFeel.html">Look and Feel Guide</a> | <a href="timezone.html">Timezones</a> | <a href="developers.html">Developers</a> | <a href="design.html">Design Document</a> | <a href="INSTALL-linux-noxmltv.html">Linux XMLTV Install</a> | <a href="contributors.html">Contributors</a></address>

<h1>FreeGuide FAQ</h1>

<h2>Contents</h2>

<ul>

<li><a href="#whatisfreeguide">What is FreeGuide?</a></li>

<li><a href="#howtoinstall">How do I install FreeGuide?</a></li>

<li><a href="#howtouse">How do I use FreeGuide?</a></li>

<li><a href="#executionerror">I got an "Execution Error" message. What is wrong?</a></li>

<li><a href="#newxmltv">FreeGuide used to work for me but now it's stopped. What is wrong?</a></li>

<li><a href="#grabberconfig">The grabber configuration step gives me an error. What is wrong?</a></li>

<li><a href="#javaversion">What version of Java does FreeGuide need?</a></li>

<li><a href="#winrar">When I double-click on a .jar file WinRAR comes up - what do I do?</a></li>

<li><a href="#firefox">Why isn't Firefox one of the browser options?</a></li>

<li><a href="#proxy">Can I use FreeGuide from behind a proxy server?</a></li>

<li><a href="#timezone">I get an error about "TZ" - what do I do?</a></li>

<li><a href="#channelorder">How do I change the order in which channels are listed?</a></li>

<li><a href="#twosources">How do I get listings from 2 different sources or channel lineups?</a></li>

<li><a href="#missinglistings">I've downloaded the listings but FreeGuide says some are still missing! What's happening?</a></li>

<li><a href="#missingfavs">Why are some of my favourites not selected?</a></li>

<li><a href="#looknfeel">Does FreeGuide support skins or themes? How do I use them?</a></li>

<li><a href="#todo">How do I find out what's being planned for future versions?</a></li>

<li><a href="#morequestions">How do I ask more questions?</a></li>

</ul>

<h2><a name="whatisfreeguide"></a>What is FreeGuide?</h2>

<p>See the <a href="README.html">README</a>.</p>

<h2><a name="howtoinstall"></a>How do I install FreeGuide?</h2>

<p>See the <a href="README.html">README</a>.</p>

<h2><a name="howtouse"></a>How do I use FreeGuide?</h2>

<p>See the <a href="userguide.html">User Guide</a>.</p>

<h2><a name="executionerror"></a>I got an "Execution Error" message. What is wrong?</h2>

<p>Note: if you very quickly get an "Execution Error" message, check that you're connected to the Internet and try again. If you have to wait quite a while and then get the "Execution Error" message, everything may still be alright - click "Continue" to see.</p>

<p>If you keep getting the "Execution Error" message and you don't see any listings when you click "Continue" then click "Show Details" and copy the error messages shown into an email and send it to <a href="mailto:freeguide-tv-users@lists.sourceforge.net">freeguide-tv-users@lists.sourceforge.net</a> with an explanation of what you were doing, what operating system you are on and what versions of Java and FreeGuide you are using.</p>

<h2><a name="newxmltv"></a>FreeGuide used to work for me but now it's stopped. What is wrong?</h2>

<p>If FreeGuide used to work for you and has now stopped, it is probably because the web site it grabs listings from has changed its format. Check the whether there is a new FreeGuide version here: <a href="http://sourceforge.net/project/showfiles.php?group_id=35309&package_id=27789">http://sourceforge.net/project/showfiles.php?group_id=35309&package_id=27789</a>.</p>

<p>If there isn't a new FreeGuide yet, you can see whether there's a new xmltv version here: <a href="http://sourceforge.net/project/showfiles.php?group_id=35309&package_id=103744">http://sourceforge.net/project/showfiles.php?group_id=35309&package_id=103744</a> and then follow these instructions to install it:</p>

<ul>

<li>Under Windows unzip the xmltv-x.x.x-tkgui-bin-windows.zip file and copy the file xmltv.exe over your file "C:\Program Files\FreeGuide\xmltv\xmltv.exe"</li>

<li>Under Linux, unzip the xmltv executable from the xmltv-x.x.x-tkgui-bin-linux.tar.bz2 file and use it to replace the file xmltv in the "xmltv" subdirectory of your FreeGuide install directory.</li>

<li>Under Linux-NoXMLTV, download the file xmltv-x.x.x-tkgui.tar.bz2 and install it <a href="INSTALL-linux-noxmltv.html">as usual</a>.</li>

</ul>

<h2><a name="grabberconfig"></a>The grabber configuration step gives me an error. What is wrong?</h2>

<p>If your grabber fails to configure or run because it can't seem to get any data from the Internet, it may be because you need to use a proxy server. Read <a href="#proxy">this question</a> for information on how to set one up.</p>

<h2><a name="javaversion"></a>What version of Java does FreeGuide need?</h2>

<p>FreeGuide needs Java version 1.4.0 or above. You can find out what version you are using by opening a DOS window or Cmd prompt and typing "java -version". If it says you've got an earlier version, or if you get an error, you need to get an upgrade from <a href="http://java.sun.com/getjava/">http://java.sun.com/getjava/</a>.</p>

<h2><a name="winrar"></a>When I double-click on a .jar file WinRAR comes up - what do I do?</h2>

<p>WinRAR is a program for unzipping zipped up files like .zip, .rar and .jar files. However, we want to run these .jar files instead of unzipping them. Open a DOS or Cmd window and cd into the directory containing the .jar file. Now type "java -jar [jarname]" to run the .jar file. Replace [jarname] with the name of the file you want to run (usually either FreeGuide-X.X-Win-Install.jar or just FreeGuide.jar).</p>

<h2><a name="firefox"></a>Why isn't Firefox one of the browser options?</h2>

<p>Because it has a bug that means it can't be called remotely to open a specific URL. There is more information in this <a href="http://bugzilla.mozilla.org/show_bug.cgi?id=177996">Firefox bug report</a>.</p>

<h2><a name="proxy"></a>Can I use FreeGuide from behind a proxy server?</h2>

<p>In the following replace "proxy.uni.ac.uk" with your proxy server address, and "8080" with the port it uses. On Windows you can find these out from the "Tools" menu on Internet Explorer by choosing "Options", going to the "Connections" tab and clicking "LAN Settings":</p>

<h3>With Windows 2000/XP:</h3>

<ul>

<li>Right Click "My Computer" -> Properties</li>

<li>Choose the Advanced Tab and click the Environment Variables button at the bottom middle of the window.</li>

<li>Click the "New" button in the Global Variables section.</li>

<li>Variable Name: http_proxy</li>

<li>Variable Value: http://proxy.uni.ac.uk:8080</li>

<li>Click OK</li>

</ul>

<h3>With Windows 95/98/ME:</h3>

100

<ul>

101

<li>Add a line "set http_proxy=http://proxy.uni.ac.uk:8080" to the file C:\Autoexec.bat</li>

102

<li>Restart your computer</li>

103

</ul>

104

<h3>With Linux:</h3>

105

<ul>

106

<li>Bash users: Add a line "export http_proxy=http://proxy.uni.ac.uk:8080" to the file ~/.bash_profile</li>

107

</ul>

108

109

<h3>Authenticating Proxies</h3>

110

111

<p>If you have an authenticating proxy, try "user:password@proxy.uni.ac.uk:8080" replacing "user" with your username and "password" with your password.</p>

112

113

<h2><a name="timezone"></a>I get an error about "TZ" - what do I do?</h2>

114

115

<p>You need to <a href="timezone.html">set your timezone</a> before you use FreeGuide.</p>

116

117

<h2><a name="channelorder"></a>How do I change the order in which channels are listed?</h2>

118

119

<p>To change the order of channels, you need to make a channel set. Choose "Channel Sets" from the "Tools" menu and create one there, than choose it from the drop-down in the top right hand corner of the screen.</p>

120

121

<h2><a name="twosources"></a>How do I get listings from 2 different sources?</h2>

122

123

<p>It is possible to make FreeGuide grab the listings from two different listings providers and merge the results for you to view. This might be useful if you want to see listings for 2 different channel lineups, for example. To do this you will need to configure your grabber twice, and save the config files as tv_grab_na_dd.conf and tv_grab_na_dd_b.conf in the normal directory for XMLTV config files. The example below is for the na_dd grabber, which is for people in North America.</p>

124

125

<p>You'll need to run one normal configuration by choosing "Choose Channels" from the "Tools" menu in FreeGuide, and one manually, by opening a Cmd or DOS window and typing:</p>

126

127

<p><tt>

128

cd "C:\Program Files\FreeGuide\xmltv"<br />

129

xmltv tv_grab_na_dd --configure --gui --config-file tv_grab_na_dd_b.conf

130

</tt></p>

131

132

<p>Now give the settings for the second lineup when you are asked.</p>

133

134

<p>Next you'll need to go to FreeGuide's "Advanced Options" screen and the "Grabber Command" tab. Instead of what's there you'll need these 3 lines:</p>

135

136

<p><tt>"%misc.xmltv_directory%\xmltv.exe" tv_grab_na_dd --config-file "%misc.xmltv_directory%\tv_grab_na_dd.conf" --offset %offset% --days 1 --output "%misc.working_directory%\tv-%date%.xmltv.tmp1" --dd-data "%misc.working_directory%\dd%offset%.xml"<br /><br />

137

138

"%misc.xmltv_directory%\xmltv.exe" tv_grab_na_dd --config-file "%misc.xmltv_directory%\tv_grab_na_dd_b.conf" --offset %offset% --days 1 --output "%misc.working_directory%\tv-%date%.xmltv.tmp2" --dd-data "%misc.working_directory%\dd%offset%.xml" --reprocess<br /><br />

139

140

"%misc.xmltv_directory%\xmltv.exe" tv_cat --output "%misc.working_directory%\tv-%date%.xmltv" "%misc.working_directory%\tv-%date%.xmltv.tmp1" "%misc.working_directory%\tv-%date%.xmltv.tmp2"

141

</tt></p>

142

143

<p>If you're in another region you'll need to adapt the commands to work with your grabber. On Linux you'll need to adapt the commands to be Linux-y. Do ask if you need help, and when we work out the solution for other regions and platforms we'll put the results up here.</p>

144

145

<h2><a name="missinglistings"></a>I've downloaded the listings but FreeGuide says some are still missing! What's happening?</h2>

146

147

<p>If you grab some listings late in a day, nearing the grabber's idea of the end of a day (e.g. close to 6am for the UK grabber) then you may be told that there are missing listings for that day even though you've just grabbed new listings. This is because the grabbing has started from tomorrow, so what's left of today doesn't have a full set of listings. Don't worry about this - just say "No" and you should be able to see what you need.</p>

148

149

<h2><a name="missingfavs"></a>Why are some of my favourites not selected?</h2>

150

151

<p>If your grabber works in midnight to midnight time slots, you may find that on the day you do a download, programmes which are favourites and are on after midnight are not chosen automatically. If you click "Reset Choices" in the bottom left, they will be chosen.</p>

152

153

<h2><a name="looknfeel">Does FreeGuide support skins or themes? How do I use them?</a></h2>

154

155

<p>Yes! See the <a href="LookAndFeel.html">Look and Feel Guide</a>.</p>

156

157

<h2><a name="todo">How do I find out what's being planned for future versions?</a></h2>

158

159

<p>Check out the <a href="TODO">TODO</a> file.</p>

160

161

<h2><a name="morequestions">How do I ask more questions?</a></h2>

162

163

<p>If you have a question about how to use FreeGuide, look through the archives of the <a href="http://sourceforge.net/mailarchive/forum.php?forum_id=7401">users' list</a> and the <a href="http://sourceforge.net/mailarchive/forum.php?forum_id=7396">developers' list</a> and if you can't find an answer send an email to: <a href="mailto:freeguide-tv-users@lists.sourceforge.net">freeguide-tv-users@lists.sourceforge.net</a>.</p>

164

165

<p>If you want to get involved with developing FreeGuide, read the <a href="developers.html">developers' page</a> and the <a href="http://sourceforge.net/mailarchive/forum.php?forum_id=7396">developers' list</a> and feel free to email the developers' list: <a href="mailto:freeguide-tv-devel@lists.sourceforge.net">freeguide-tv-devel@lists.sourceforge.net</a>.</p>

166

167

168

169

170

<address>Nothing to see here. Move along.</address>

171

<h1>Page moved - redirecting</h1>

<p>This page has moved to <a href="help.html">here</a>.</p>

172

</body>

173

</html>

Older »