mk6i-open-oscar-server

Retro AIM Server

[](https://codecov.io/gh/mk6i/retro-aim-server) [](https://discord.gg/2Xy4nF3Uh9)

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

The following features are supported:

• Windows AIM client v2.x, v3.x, v4.x, v5.x
• Away Messages
• Buddy Icons (v4.x, v5.x)
• Buddy List
• Chat Rooms (v4.x, v5.x)
• Instant Messaging
• User Profiles
• Blocking (v3.5+)
• Visibility Toggle / Idle Notification
• 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.

🌍 Community

Check out the Retro AIM Server Discord server to get help or find out how to get involved.

👤 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.