cARLO – The Amazing Roach Log Oracle

Download Current Version (v1.5.5): cARLO-1.5.5.tgz (157KB)

* What is cARLO?

cARLO is a re-write of ARLO, “The Amazing Roach Log Oracle”, using Cocoa for MacOS X. ARLO is a Carracho log file analyzer written in perl, and is also included as a bonus in this download. cARLO can parse Hotline logs in addition to Carracho logs.

* Features

cARLO includes most of the features ARLO has and a few extras, but with an easy to use GUI. These include:

– General stats for a user (uploads, downloads, leech rating, IPs).
– Every nickname used when a user starts a file transfer.
– A list of files uploaded by a user.
– A list of files downloaded by a user.
– The leech rating of every user on the server sorted by login names or leech ratings.
– Server wide stats (uploads, downloads, leech rating, and 6 “top 10” lists.
– Search for file uploaders by filename.
– Search for file downloaders by filename.
– Report exporting for publishing on the web or as a plain text file.
– Version checking.
– Support for both Carracho and Hotline logs.
– (Unsupported) Automatic report generating.
– (Unsupported) Separate user statistics by nickname.

cARLO is also the second fastest Carracho log file analyzer available – second only to the original perl script – which makes it the fastest with a GUI. cARLO can parse a ~6MB log file set in about 8.3 seconds.

* What is a “leech rating”?

A leech rating is calculated as the number of uploads a user had made divided by the user’s download count, that figure multiplied by 100 and then subtracted from 100. This gives a rating of 100% for a user that has never uploaded. The higher the percentage the more of a leech the user is. The leech ratio does not take into account file sizes or a user’s bandwidth, as neither of these things are logged. Please note that leech ratings are only for entertainment. You should not be making judgments or decisions about a user based on their leech rating.

* Requirements

cARLO 1.5.5 requires MacOS X, and has only been tested on 10.2.3. You also need Carracho or Hotline upload and download logs to analyze (obviously).

* Installation

Just drag cARLO to your Applications folder.

* Using cARLO

To use cARLO, simply double-click the cARLO icon, and follow the instructions. Once the log files have been parsed simply choose the type of information you wish to view from the toolbar on the left.

* Cost / Distribution

cARLO is $5 shareware. In the past cARLO was free, but the time required to develop and maintain it has become substantial. If you keep it for more than a week or so, then you should pay for it. Also note that the most recent batch of features and changes were requested by people who had paid for the program. This is not a coincidence. Please send payments to:

Phil Hilton
1228 Main Street
Wilton, ME 04294
USA

You may also pay with PayPal. The PayPal address is ‘riscit@bungie.org’. Please avoid using credit cards, however, as PayPal takes a very large (relatively speaking) chunk of an already small amount.

The original “arlo” perl script remains free.

Or even better.. How about purchasing some quality name brand discount ski equipment and when you checkout mention in the comment section that “Phil” sent you, and that he should get a 10 percent commision. =)

cARLO may be distributed via any method available in the original archived format (the .tgz file).

* Change log:

1.5.5

– 12/30/02
– Fixed bug which prevented the file name of reports from being remembered.
– Fixed progress bar increment math.
– Preferences window now closes when clicking the “Parse Log Files” button.
– Renamed “Parse Logs Files” button to “Save Changes / Parse Log Files” – more appropriate.
– Moved all progress indicators to the toolbar.
– Added “Caching Logs” state to log parsing stages
– Added option to exclude file transfers by anonymous or “guest” users. For this option to work on Hotline logs, the log must begin with the standard “Date/time” string which identifies it as such.
– Added option in preferences to identify unique users by their nickname, as opposed to their account username. This is an UNSUPPORTED FEATURE which allows public servers to separate the statistics of users which do not have an account. Note that this is NOT the recommended way to parse files. This feature was added only because many people requested it and it was rather trivial to add. It is not particularly useful as most users change their nicknames quite often.
– Added the ability to auto-magically save server reports every X hours. This is an UNSUPPORTED FEATURE found in the preferences window. If this option is checked then a report will be generated using the current report settings after X hours and every time you manually parse the logs or launch cARLO. Note that if you enter a value less than 0.0025 as the number of hours between reports (~9 seconds), then the value is ignored and no report will be generated until you change it to a more realistic value (“realistic” would be 0.5 to 2 days). Extended use of this UNSUPPORTED feature over several days will result in very large memory usage. Having smaller log files and increasing the time between reports will minimize this. Relaunching cARLO will temporarily fix the problem. This isn’t typically a problem during normal usage, so this “bug” will probably go unfixed. If this bothers you a lot, please make a note of it when you pay your shareware fee, and I will take it into consideration. When enough people have paid for cARLO and expressed concern over this bug that it justifies the time it would take to fix it, I will do so.
– Small 10.2.3 optimizations.

1.5.1

– 09/07/02
– Bug Fix – The checkbox for adding top nickname counts to the server report was being ignored – fixed.

1.5

– 09/04/02
– Added version checking. Choosing “Check For New Version…” from the cARLO menu (or pressing command-shift-V) will cause cARLO to check if it is the latest version. It will either tell you that you are up to date, or that a new version is available with a URL for more information. Your privacy is respected. The only thing logged is your IP address (by a web server). No information is shared.
– Skips files named “_FOLDER_INFO_” or files starting with a “.” (period). These files are inadvertently logged during folder transfers, and should not be tallied with cARLO statistics.
– Added report generation. Fully customizable reports can be exported about your server and/or user statistics as either plain text or HTML.
– Added support for Hotline logs.
– Small 10.2 optimizations.

1.1

– 02/01/02
– Logs which contained LOTS of entries for the same username with LOTS of IPs and/or LOTS of nicknames were taking upwards of 10 minutes to parse. Should have been closer to 10 seconds. Fixed.

1.0

– 01/30/02
– Initial release