base on Self-hostable instant messaging server compatible with classic AIM and ICQ clients written in golang. (Independently developed, not affiliated with or endorsed by AOL) # Open OSCAR Server <div align="center"> <a href="">[](https://codecov.io/gh/mk6i/open-oscar-server)</a> <a href="">[](https://discord.gg/2Xy4nF3Uh9)</a> </div> **Open OSCAR Server** is an open-source instant messaging server compatible with classic AIM and ICQ clients written in golang. <p align="center"> <img width="816" alt="image" src="https://github.com/user-attachments/assets/4d76b06f-fd0c-4f0a-9e9f-d9516653cfb4" /> </p> | 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. ## 🌍 Community Check out the Open OSCAR Server [Discord server](https://discord.gg/zjFGGTa8mu) to get help or find out how to get involved. ## 👤 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). ", Assign "at most 3 tags" to the expected json: {"id":"12813","tags":[]} "only from the tags list I provide: []" returns me the "expected json"