Sometimes RBrowser takes a long time to start (or crashes on startup). What can be causing this?

Most apps use "file packages" as their documents. These are directories with an arbitrary file structure. They use a filename extension to associate with an app. Regrettably, some apps claim very generic names as their documents. In these cases both in the Finder and in RBrowser they appear as files, not folders. RBrowser does not maintain app-document file associations, it gets them from the Finder.
The "File/Show Package Contents" menu can always be used to browse into a file package (just like the Finder). In later versions RBrowser will have a way to be told to ignore certain filename extensions. Also, in the Finder can be configured to ignore certain filename extensions and not treat it like a document of some app. Please see Apple's documentation for this.

I use BBEdit Lite to edit my html files. How do I make RBrowser open my html files in BBEdit?

I use BBEdit Lite to edit my cgi scripts. When I upload them to my website, the web server cannot execute them. Why?

Most likely, the line endings in your file are mac (\r) and not UNIX (\n) which is used on most webservers. The best thing to do is to make sure your editor (BBEdit or TextEdit) uses unix line endings, and use the binary mode (OPTION-COMMAND-B) in RBrowser to upload them.

Site Aliases work intermittently

Be sure that .rbd files (in [YOURHOME]/Library/Application Support/RBrowser4) are associated properly with the installed RBrowser application. Select an rbd file in the Finder, click "Get Info" and make sure the "Open With" section shows the correct version of RBrowser. You may have to restart the Finder several times too.

How do I change login options like "use SSL" or "use Passive" on existing connections?

There are two ways to do this: when the site is not open go to  RBrowser/Site Preferences menu and find the site. Edit the options and save. The changes will show up next time you connect. The other way is for the impatient...Command-N for new empty login panel, using the popup on the panel find the site. Reset options, then click connect. The new options will be saved if connection is successful.

RBrowser is not loading the contents of my directories in FTP.. help!

Most likely you turned on your firewall, so the FTP data connection is blocked from the server. Before login, set Passive FTP, to "Auto Passive" on the Login Panel. This will allow RBrowser to test your setup and the remite site to determine if Passive FTP is allowed and necassary. There are times where it will simply not work because neither setting is allowed. For instance ftp.microsoft.com does not allow passive ftp, and your personal firewall will disallow non-passive ftp. In this case you will have to make sure your personal firewall is off, then to connecting to ftp.microsoft.com is possible in non-passive mode.

I get error messages like Connection Failed when I connect to my FTP server, even though some folders did load. Why?

There are some (especially Public FTP) servers that are very restrictive. RBrowser normally uses several simultaneous connections to the same site to speed up the initial load of a site. Some servers only allow a single connection. In these cases do the following:
1. Try a clean connection: before logging in, blow away the existing Site Preference file for the host-username in [YOURHOME]/Library/Appication Support/RBrowser4. When you connect the next time, RBrowser will reinitialize the site again.
2. Start RB. On the login panel, fill the fields, select FTP, then hit Site Preferences. On the limits tab put 1 for both "Max Connections" and "Max Persistent Connections", save then connect.
If things work, you can experiment with higher counts, but it is not really necessary. This will slow the initial connection down somewhat as you load one folder at a time, but it should work!

I cannot connect to my FTP or SSH host even though I could connect to it with previous versions of RBrowser!

One thing is for sure... If you connected to it before you will be able to connect to it again. It happens that because of recent changes in RBrowser compatibility with some hosts break. MAKE SURE THE SERVER HOST IS UP! If you are sute the server host is up and available, but you are unable to connect, please do the following:

I want to have a local copy of the file I'm editing, but RBrowser hides it somewhere. Why is it not kept in the "Download Folder" specified in the Preferences?

The [YOURHOME]/.rbtp/* location is used when you remote-edit. This is only temp storage while editing. RBrowser will clean up this path automatically when you are done, so do not put anything in there! Remote Editing is not a download. If you want a local copy of your file, either just drag&drop or select the remote file and click the File/Download menu and RBrowser will download the file to your designated download folder.

I want to make RBrowser use my ls, not the one in /bin. My ls is in /my/home/bin. How do I do this?

In some rare cases like on older linux systems, ls's output does not conform to the bsd standard, so RBrowser chokes on it. If you install a good version of ls in an alternate location, you can tell RB by adding it to the top of the search path. This very rare, so there is no GUI for it, but with a little hand editing it is totally possible. First make sure you have a Site Pref file, by clicking on "Site Preferences" on the login panel. Open the file (it is in YOURHOME/Library/Application Support/RBrowser4) and find the key called RBRemoteShellSearchPath. The value will look like this: /bin:/usr/bin:/usr/5bin:/usr/ucb:/sbin:/usr/sbin:/usr/local/bin Carefully edit it to include your bin dir: /your/home/bin:/bin:/usr/bin:/usr/5bin:/usr/ucb:/sbin:/usr/sbin:/usr/local/bin, save and connect!

I'm syncing my mac to another UNIX box and the sync fails, I get many failure messages.. why?

Depending on the files you sync and the protocol you use there are a large variety of errors you can get during the sync, especially the first time. Different UNIX systems have various levels of tolerance of certain filenames, character encodings, etc.. OSX is very permissive in filenames, for instance it allows very long file names with strange characters in them. Also, it is case preserving but NOT case sensitive. The other host you are syncing to may be much more limited. If you get errors, you should repeat the sync several times. If you keep getting failures always at a certain place, well, you may have to leave that folder out of the sync or try to change the source, or, if all fails and you cannot see what the incompatibility is, contact support with the error message, transcript, etc...

I lost my license string. How can I get it sent to me again?

How do I make RBrowser reread (and convert) my RB3 sites again?

Early versions of RBrowser4 had a problem causing only partial conversion of RB3 sites. These sites are still there in the folder ~/Library/Application\ Support/RBrowser. Current sites are stored in ~/Library/Application\ Support/RBrowser4. When the sites were converted, RBrowser put in a hidden file called .rb4.converted into the v3 site folder to prevent further conversions. You can delete this file causing RBrowser to reconvert again at the next launch. In your Terminal type
rm -rf ~/Library/Application\ Support/RBrowser/.rb4.converted
then restart RBrowser. Please note: SFTP and SSH sites are merged into one, also sites that already exist in the V4 site folder will not be overwritten again.

Remote-to-Local sync using FTP is not detecting file changes every time. Why?

Many times iWeb publishes your pages with : and ! characters in the filenames. When you try to upload these to an FTP server, it fails because these characters are not allowed in the filenames on most FTP servers. Solution: be sure to edit the filenames and make sure these characters are not used in the names (contents can have anything).