Retro AIM Server

Retro AIM Server is an instant messaging server that revives AOL Instant Messenger clients from the 2000s.

The following features are supported:

• [x] Windows AIM client versions 3.5, 4.x, 5.x
• [x] Away Messages
• [x] Buddy Icons
• [x] Buddy List
• [x] Chat Rooms
• [x] Instant Messaging
• [x] User Profiles
• [x] Blocking / Visibility Toggle / Idle Notification
• [x] Warning

🏁 How to Run

Get up and running with Retro AIM Server using one of these handy server quickstart guides:

• Linux (x86_64)
• macOS (Intel and Apple Silicon)
• Windows 10/11 (x86_64)

Don't have AIM installed yet? Check out the AIM Client Setup Guide.

🛠️ Development

This project is under active development. Contributions are welcome!

Follow this guide to learn how to compile and run Retro AIM Server.

👤 Management API

The Management API provides functionality for administering the server (see OpenAPI spec):

List Users

curl http://localhost:8080/user

Create Users

curl -d'{"screen_name":"myScreenName", "password":"thepassword"}' http://localhost:8080/user

Change Password

curl -X PUT -d'{"screen_name":"myScreenName", "password":"thenewpassword"}' http://localhost:8080/user/password

List Active Sessions

This request lists sessions for all logged in users.

curl http://localhost:8080/session

🔗 Acknowledgements

• aim-oscar-server is another cool open source AIM server project.
• NINA Wiki is an indispensable source for figuring out the OSCAR API.
• libpurple is also an invaluable OSCAR reference (especially version 2.10.6-1).

📄 License

Retro AIM Server is licensed under the MIT license.