https://github.com/mk6i/open-oscar-server
Self-hostable instant messaging server compatible with classic AIM and ICQ clients. (Independently developed, not affiliated with or endorsed by AOL)
https://github.com/mk6i/open-oscar-server
chat golang instant-messaging retrocomputing
Last synced: 29 days ago
JSON representation
Self-hostable instant messaging server compatible with classic AIM and ICQ clients. (Independently developed, not affiliated with or endorsed by AOL)
- Host: GitHub
- URL: https://github.com/mk6i/open-oscar-server
- Owner: mk6i
- License: mit
- Created: 2023-06-17T03:16:14.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-01-10T03:56:46.000Z (about 1 month ago)
- Last Synced: 2026-01-11T01:10:32.420Z (about 1 month ago)
- Topics: chat, golang, instant-messaging, retrocomputing
- Language: Go
- Homepage: https://discord.gg/E5etJfRAqR
- Size: 2.35 MB
- Stars: 976
- Watchers: 21
- Forks: 62
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- starred - mk6i/open-oscar-server - Self-hostable instant messaging server compatible with classic AIM and ICQ clients. (Independently developed, not affiliated with or endorsed by AOL) Formerly known as Retro AIM Server. (Go)
README
# Open OSCAR Server
[](https://codecov.io/gh/mk6i/open-oscar-server)
[](https://discord.gg/2Xy4nF3Uh9)
**Open OSCAR Server** is an open-source instant messaging server compatible with classic AIM and ICQ clients.
| Disclaimer |
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| This project is an independent, open-source initiative and is not affiliated with, endorsed by, or associated with AOL or Yahoo! Inc. This project is entirely non-commercial and does not generate any revenue or accept donations. |
The following features are supported:
**AIM**
- [x] Windows AIM Clients: [v1.x-v5.x](./docs/CLIENT.md), [v6.x-v7.x](docs/AIM_6_7.md)
- [x] Away Messages
- [x] Buddy Icons (v4.x, v5.x)
- [x] Buddy List
- [x] Chat Rooms
- [x] Public & Private Chat Exchanges
- [x] Instant Messaging
- [x] User Profiles
- [x] Privacy (allow or block specific users)
- [x] Warning
- [x] User Directory Search
- [x] TOC Protocol Clients: Quick Buddy, gaim, [TiK](./docs/CLIENT_TIK.md)
- [x] File Sharing
- LAN Only: Direct Connect, Get File
- Lan/Internet: [Send File](./docs/RENDEZVOUS.md)
**ICQ**
- [x] Windows ICQ Clients: 2000b (more to come soon)
- [x] Instant Messaging
- [x] Profiles
- [x] User Search
- [x] Presence Statuses
- [x] Offline Messaging
## 🏁 How to Run
Get up and running with Open OSCAR Server using one of these handy server quickstart guides:
* [Linux (x86_64)](./docs/LINUX.md)
* [macOS (Intel and Apple Silicon)](./docs/MACOS.md)
* [Windows 10/11 (x86_64)](./docs/WINDOWS.md)
Don't have AIM installed yet? Check out the [AIM Client Setup Guide](./docs/CLIENT.md).
...how about ICQ? Check out the [ICQ Client Setup Guide](./docs/CLIENT_ICQ.md).
## 🛠️ Development
This project is under active development. Contributions are welcome!
Follow [this guide](./docs/BUILD.md) to learn how to compile and run Open OSCAR Server.
## 👤 Management API
The Management API provides functionality for administering the server (see [OpenAPI spec](./api.yml)). The following
shows you how to run these commands via the command line.
### Windows PowerShell
> Run these commands from **PowerShell**, *not* **Command Prompt**.
#### List Users
```powershell
Invoke-WebRequest -Uri http://localhost:8080/user -Method Get
```
#### Create Users
```powershell
Invoke-WebRequest -Uri http://localhost:8080/user `
-Body '{"screen_name":"MyScreenName", "password":"thepassword"}' `
-Method Post `
-ContentType "application/json"
```
#### Delete Users
```powershell
Invoke-WebRequest -Uri http://localhost:8080/user `
-Body '{"screen_name": "user123"}' `
-Method Delete `
-ContentType "application/json"
```
#### Change Password
```powershell
Invoke-WebRequest -Uri http://localhost:8080/user/password `
-Body '{"screen_name":"MyScreenName", "password":"thenewpassword"}' `
-Method Put `
-ContentType "application/json"
```
#### List Active Sessions
This request lists sessions for all logged in users.
```powershell
Invoke-WebRequest -Uri http://localhost:8080/session -Method Get
```
#### Create Public Chat Room
```powershell
Invoke-WebRequest -Uri http://localhost:8080/chat/room/public `
-Body '{"name":"Office Hijinks"}' `
-Method Post `
-ContentType "application/json"
```
#### List Public Chat Rooms
```powershell
Invoke-WebRequest -Uri http://localhost:8080/chat/room/public -Method Get
```
### macOS / Linux / FreeBSD
#### List Users
```shell
curl http://localhost:8080/user
```
#### Create Users
##### AIM
```shell
curl -d'{"screen_name":"MyScreenName", "password":"thepassword"}' http://localhost:8080/user
```
##### ICQ
```shell
curl -d'{"screen_name":"100003", "password":"thepassw"}' http://localhost:8080/user
```
#### Delete Users
```shell
curl -X DELETE -d '{"screen_name": "user123"}' http://localhost:8080/user
```
#### Change Password
```shell
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.
```shell
curl http://localhost:8080/session
```
#### Create Public Chat Room
```shell
curl -d'{"name":"Office Hijinks"}' http://localhost:8080/chat/room/public
```
#### List Public Chat Rooms
```shell
curl http://localhost:8080/chat/room/public
```
## 📄 License
Open OSCAR Server is licensed under the [MIT license](./LICENSE).