CLIENT_ICQ.md

ICQ Client Setup

This guide explains how to install and configure ICQ 2000b for Retro AIM Server.

ICQ 2000b is the only version of ICQ currently supported by RAS.

Installation guides are available for the following operating systems:

• Windows
• Linux
• macOS (Intel & Apple Silicon)

Installation

Windows

1. Download ICQ

   Download ICQ 2000b from archive.org.

2. Run Installer

   Run the ICQ installer.

3. Close the Registration Window

   Once installation is complete, you'll be greeted by an ICQ registration window. Do not complete the registration wizard. Close the window and move on to the post-installation steps.

   

Linux

You can run ICQ 2000b under Linux via WINE.

1. Download ICQ

   Download ICQ 2000b from archive.org.

2. Install WINE

   Run and install WINE.

3. Run the Installer

   Start the ICQ installer under WINE from a terminal:

   wine icq2000b.exe

4. Close the Registration Window

   Once installation is complete, you'll be greeted by an ICQ registration window. Do not complete the registration wizard. Close the window and move on to the post-installation steps.

   

macOS (Intel & Apple Silicon)

Windows ICQ 2000b can run on modern macOS (including the Apple Silicon platform) without a VM using WineskinServer, a wrapper for WINE.

1. Install WineskinServer

   Install WineskinServer via homebrew:

   brew install --cask --no-quarantine gcenx/wine/wineskin

2. Create a Blank Application Wrapper

   Launch Wineskin Winery. Install the latest engine and create a new blank wrapper for installing ICQ.

   Generating the wrapper might take 1-2 minutes, and the application might not respond during this time. Once complete, click View wrapper in Finder.

   

3. Install ICQ into the Application Wrapper

   Launch the wrapper from the Finder window. Select Install Software.

   

   Select Choose Setup Executable and open the ICQ installer executable.

   

4. Run the Installer

   Complete the ICQ installation wizard.

5. Close the Registration Window

   Once installation is complete, you'll be greeted by an ICQ registration window. Do not complete the registration wizard. Close the window and move on to the post-installation steps.

   

Post-install Configuration

In this step, we'll replace ICQ's default server hostname with your Retro AIM Server's hostname in the Windows Registry.

Do not attempt to set the ICQ hostname via the registration Window. If you do this, a bug will surface that prevents the client from "remembering" settings such as saved passwords and OSCAR hostname.

1. Open Registry Editor

   • Windows
     • Open the Run dialog ⊞ Win + R.
     • Enter regedit and click OK.
   • Wine (Linux)
     • Open a terminal.
     • Run wine regedit in a terminal.
   • WineskinServer (macOS)
     • Open a terminal.
     • Run the following command, substituting icq2000b.app with the file name of your wrapper:

       ~/Applications/Wineskin/icq2000b.app/Contents/Wineskin.app/Contents/Resources/regedit

2. Open Default ICQ Settings

   Navigate to HKEY_CURRENT_USER\Software\Mirabilis\ICQ\DefaultPrefs.

   

3. Configure OSCAR Host

   • Double-click the Default Server Host registry entry.
   • Set Value data to the value of OSCAR_HOST found in Retro AIM Server configuration config/settings.env.
   • Click OK.

   

4. Configure Server Port (uncommon)

   Only change this value if your server does not listen on the default OSCAR ports.

   • Double-click the Default Server Port registry entry.
   • Tick the Decimal radio button.
   • Set Value data to the value of AUTH_PORT found in Retro AIM Server configuration config/settings.env.
   • Click OK.

   

5. Exit Registry Editor

   Client configuration is complete. Close the Registry Editor.

First Time Login

Start ICQ and complete the first-time registration wizard. Start by selecting Existing User.

Do not try to create a new user in the registration wizard. To create a new user in Retro AIM Server, follow account creation steps in the server quickstart guides.

Enter ICQ user credentials. If you're running RAS with the default settings, you can enter any UIN and password. Click next on the remaining screens until the wizard is finished.

You should now be able to connect to Retro AIM Server using ICQ 2000b.