This page describes the visible features of the tuner, principally its tabbed pages and menus. It is reference material; other pages provide a tuner quick start and descriptions of common tasks.
Satellite Dish Icon
Marimba Page
Channels Page
Listing Page
Hot Page
Configure PagesConfigure:Loading Page
Configure:User Page
Configure:Network Page
Configure:Options Page
The satellite dish icon to the right of the tuner page tabs shows the tuner's communication status. When the dish appears to be receiving red beams from space, the tuner is communicating with a transmitter. Press Ctrl-C to abort the transmission.
The Marimba page identifies your tuner version, including when it last updated itself.
The Marimba button switches the tuner to the Listing page and shows the channels served by the Marimba transmitter.
The Channels page lists subscribed and unsubscribed channels, organized by transmitter. Each transmitter's list of channels can be exposed or hidden by clicking the + or - symbol next to the transmitter tower icon.
Status values:
- nnnK
- The approximate space occupied by a channel on your disk; the figure does not include files the channel has created; it is inflated by files the channel shares with other channels (the tuner stores only one copy of a shared file).
- launching
- The tuner is starting the channel.
- running
- The channel is running; double-click to stop the channel.
- . (dot)
- The channel is unsubscribed; double-click to resubscribe.
- loading/installing/notifying
- The channel is being downloaded or updated from its transmitter; type Ctrl-C to abort. Progress is shown at the bottom of the tuner window.
- error
- The tuner encountered an error when downloading or updating the channel; move the pointer to the channel's name for a description of the error.
This page lists the channels served by transmitters. To obtain a list of a new transmitter's channels, type the transmitter's name into the text field, then press Return/Enter. Include the transmitter's port number (e.g., :5282) if it's not :80.
The drop-down list contains the names of transmitters you've entered in the past; select a transmitter from this list to see its channels. Note that the channel list may be stale; click the Refresh button to download the current list.
The Browse button passes the transmitter name to your Web browser so you can see the channel listing in a Web page. Some transmitter Web pages provide more channel information than the Listing page shows.
The Refresh button downloads the latest channel information from the transmitter named in the text field.
A + symbol next to a channel indicates that a short description of the channel is available; click the + to see it. Click the - to hide the channel description.
The Hot page contains a list of interesting new transmitters or channels selected by Marimba. Click an icon to visit a transmitter or subscribe to a channel.
The Register button is for channel developers; if you are one, click the button to register your channel with Marimba for possible inclusion in the a future Hot page update.
The Hot page contents may change when the tuner updates itself. That's because the tuner is a channel and the Hot page is a tuner content file. When Marimba changes the Hot file, the next tuner update downloads the new file. You may want to check the Hot page after each tuner update.
Change the value(s) on a page, then click Apply to make the changes take effect.
Or press Reset to make the values as they were when you opened the page (or last clicked Apply).
Use this page to set limits for automatic channel updating. For example, you may not want connections to be made as often if you're using a dial-up Internet connection. Or, if your network is commonly busy during the day, you may wish for updates to be made only at night.
Use the "Automatic updates can be made" drop-down list to select the hours during which the tuner can make updates: any time (the default), never (manual updating only), daytime office hours, nighttime.
Use the "Frequency of automatic updates" drop-down list to select the maximum frequency for automatic updates: whenever scheduled; every 15 minutes (the default); every 30 minutes; every hour; every day.
The values you enter on this page are optional; enter as much as you wish channel developers to know about you. When the tuner updates a channel, it sends this information to the transmitter which will pass it to the channel plug-in if there is one.
If your computer is not behind a firewall you can ignore this page.
If your computer is behind a firewall, the tuner cannot communicate directly with transmitters located outside the firewall. (Just as Web browsers inside a firewall cannot directly contact HTTP servers outside the firewall.) The solution is a proxy in the firewall: The tuner communicates with the proxy, the proxy communicates with the transmitter.
The tuner can use an HTTP proxy or a Castanet (Marimba) proxy. You will probably need to ask a network administrator which of these you have, and what their host names and port numbers are. If you have either type of proxy, specify it on this page; if you have both, specify both. If you can't contact a network administrator, you may be able to determine your site's HTTP proxy information from your Web browser's setup if you are sure your browser can reach Internet sites outside your firewall (try www.marimba.com).
Use Connection Options to select the kind of Internet connection you have:
Use the Channel Options checkboxes as follows:
- New Channel
- Subscribe to a channel whose transmitter name you know. If you don't know the channel name, click List to show the channels on the Listing page. If you know the channel name, click Subscribe to switch to the Channels page where you'll see the progress of the download.
- Listing Page
- Show Listing page.
- Channels Page
- Show Channels page
- Cancel Transfers
- Abort any download in progress.
- Show Console
- Display a Java console window for debugging channels.
- Update Tuner
- Quit running channels, updates, and restarts tuner.
- Quit
- Quit the tuner. (Unlike the Close box, choosing Quit stops in-progress updates and channels, and exits the tuner.)
- Channel Description
- Show brief description of selected channel.
- Channel Properties
- Show the selected channel's properties sheet.
- Create Shortcut (for Windows platforms only)
- Create a shortcut for the selected channel.
- Subscribe
- Subscribe to the selected channel.
- Update
- Manually initiate update of the selected channel.
- Start
- Launch the selected channel.
- Stop
- Quit the selected channel.
- Unsubscribe
- Unsubscribe the selected channel. Note: Unsubscribe deletes the channel's code and content files, but preserves its data files in case you resubscribe.
- Remove
- Remove the selected channel. Note: Remove deletes the channel completely: its code and content files, and any data files you have created with the channel.
- Quick Start
- The bare essentials of using the tuner.
- Introducing Castanet
- Concepts and components of the Castanet system.
- How To
- Step-by-step instructions for common tasks.
- What Is
- Detailed descriptions of the tuner's menus and pages.
- FAQ
- Frequently asked questions.
- License Agreement
- The tuner license agreement.
- Release Notes
- Known anomalies and notes for the current tuner release.
- Website Documentation
- Link to Marimba's Castanet documentation.
- Marimba
- Link to Marimba's home page.
When you click the tuner's Close button, the program does not quit, but continues running in the background, displaying its icon (similar to a satellite dish) in the taskbar status area as a reminder. Running in the background, the tuner can pull updates from transmitters while you do other work (red beams coming into the tuner icon indicate an update in progress). However, your computer must be connected to the network, or able to establish a dial-up connection, for background operation to be useful.
Copyright
© 1997 Marimba, Inc. All rights reserved.