Skip to content

pchchv/go-icq

Repository files navigation

go-icq Godoc Reference Go Report Card

Go ICQ is an self-hostable instant messaging server compatible for AIM and ICQ clients.

Features:

AIM

  • Windows AIM Clients
  • Away Messages
  • Buddy Icons (v4.x, v5.x)
  • Buddy List
  • Chat Rooms
  • Public & Private Chat Exchanges
  • Instant Messaging
  • User Profiles
  • Privacy (allow or block specific users)
  • Warning
  • User Directory Search
  • TOC Protocol Clients: Quick Buddy, gaim, TiK
  • File Sharing
    • LAN Only: Direct Connect, Get File
    • Lan/Internet

ICQ

  • Windows ICQ Clients: 2000b (more to come soon)
  • Instant Messaging
  • Profiles
  • User Search
  • Presence Statuses
  • Offline Messaging

Management API

The Management API provides functionality for administering the server. The following shows you how to run these commands via the command line.

Windows PowerShell

Run these commands from PowerShell.

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

Create Public Chat Room

Invoke-WebRequest -Uri http://localhost:8080/chat/room/public `
  -Body '{"name":"Office Hijinks"}' `
  -Method Post `
  -ContentType "application/json"

List Public Chat Rooms

Invoke-WebRequest -Uri http://localhost:8080/chat/room/public -Method Get

Linux / macOS

List Users

curl http://localhost:8080/user

Create Users

AIM
curl -d'{"screen_name":"MyScreenName", "password":"thepassword"}' http://localhost:8080/user
ICQ
curl -d'{"screen_name":"100003", "password":"thepassw"}' 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

Create Public Chat Room

curl -d'{"name":"Office Hijinks"}' http://localhost:8080/chat/room/public

List Public Chat Rooms

curl http://localhost:8080/chat/room/public

About

Self-hostable instant messaging server compatible for AIM and ICQ clients.

Resources

License

Stars

Watchers

Forks

Contributors

Languages