base on Self-hostable instant messaging server that makes classic AIM and ICQ clients work again. (Independently developed, not affiliated with or endorsed by AOL) # Retro AIM Server <div align="center"> <a href="">[](https://codecov.io/gh/mk6i/retro-aim-server)</a> <a href="">[](https://discord.gg/2Xy4nF3Uh9)</a> </div> **Retro AIM Server** is an open-source instant messaging server that makes classic AIM and ICQ clients work again. <p align="center"> <img width="616" alt="screenshot of retro aim server running next to AIM" src="https://github.com/mk6i/retro-aim-server/assets/2894330/81ff419f-50fa-4961-bd2f-ac7dcac903b5"> </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, v2.x, v3.x, v4.x, v5.x - [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 Retro AIM 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 Retro AIM Server. ## 🌍 Community Check out the Retro AIM Server [Discord server](https://discord.gg/2Xy4nF3Uh9) 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 ``` ## 🔗 Acknowledgements - [aim-oscar-server](https://github.com/ox/aim-oscar-server) is another cool open source AIM server project. - [NINA Wiki](https://wiki.nina.chat/wiki/Main_Page) is an indispensable source for figuring out the OSCAR API. - [libpurple](https://developer.pidgin.im/wiki/WhatIsLibpurple) is also an invaluable OSCAR reference (especially version [2.10.6-1](https://github.com/Tasssadar/libpurple)). ## 📄 License Retro AIM 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: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"