Startseite Erkunden Hilfe
Anmelden
LBP
/
mk6i-open-oscar-server
Mirror von https://github.com/mk6i/open-oscar-server.git
4
0
Fork 0
Dateien Issues 0 Wiki

Keine Beschreibung

Struktur: 51b4d44c94
Branches Tags
mk6i-open-oscar...
ZIP TAR.GZ
Mike 51b4d44c94 encapsulate cookie logic within AuthService vor 2 Jahren
.github ca608a1f07 upgrade github actions vor 2 Jahren
cmd 51b4d44c94 encapsulate cookie logic within AuthService vor 2 Jahren
config 3efdf20c8f Fix INVALID_SNAC error in gaim when loading icon vor 2 Jahren
docs 55c3ed0a66 Update WINDOWS.md vor 2 Jahren
foodgroup 51b4d44c94 encapsulate cookie logic within AuthService vor 2 Jahren
scripts c716ac3032 resolve confusion over which executable to run vor 2 Jahren
server 51b4d44c94 encapsulate cookie logic within AuthService vor 2 Jahren
state e217539ed1 add support for user-defined screen name formatting vor 2 Jahren
wire f95c180413 return error SNAC from OService ServiceRequest for unknown SNAC vor 2 Jahren
.gitignore 3a41734424 ignore .DS_Store vor 2 Jahren
.goreleaser.yaml c716ac3032 resolve confusion over which executable to run vor 2 Jahren
.mockery.yaml 51b4d44c94 encapsulate cookie logic within AuthService vor 2 Jahren
Dockerfile.goreleaser 2d0f7a2716 obfuscate windows builds to avoid defender quarantine vor 2 Jahren
LICENSE 84c6909f36 fix data race in bos_service and chat_service tests vor 2 Jahren
Makefile c716ac3032 resolve confusion over which executable to run vor 2 Jahren
README.md e217539ed1 add support for user-defined screen name formatting vor 2 Jahren
api.yml f05b0c1b05 implement DELETE http://localhost:8080/user vor 2 Jahren
codecov.yml 84c6909f36 fix data race in bos_service and chat_service tests vor 2 Jahren
go.mod 041c5270b7 use sqlite3 driver for migrations vor 2 Jahren
go.sum 041c5270b7 use sqlite3 driver for migrations vor 2 Jahren

README.md

Retro AIM Server

[![codecov](https://codecov.io/gh/mk6i/retro-aim-server/graph/badge.svg?token=MATKPP77JT)](https://codecov.io/gh/mk6i/retro-aim-server) [![Discord](https://img.shields.io/discord/1238648671348719626?logo=discord&logoColor=white)](https://discord.gg/2Xy4nF3Uh9)

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

screenshot of retro aim server running next to AIM

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
  • 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:

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

Invoke-WebRequest -Uri http://localhost:8080/user -Method Get

Create Users

Invoke-WebRequest -Uri http://localhost:8080/user `
  -Body '{"screen_name":"MyScreenName", "password":"thepassword"}' `
  -Method Post `
  -ContentType "application/json"

Delete Users

Invoke-WebRequest -Uri http://localhost:8080/user `
  -Body '{"screen_name": "user123"}' `
  -Method Delete `
  -ContentType "application/json"

Change Password

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.

Invoke-WebRequest -Uri http://localhost:8080/session -Method Get

macOS / Linux

List Users

curl http://localhost:8080/user

Create Users

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

Delete Users

curl -X DELETE -d '{"screen_name": "user123"}' 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.