livechat.cr

Version, currently master branch1 version
  • master branchlatestAug 25, 2016

github.com/KCreate/livechat.cr

WORK IN PROGRESS livechat written in Crystal

1 stars
0 dependents
License: MIT

Installation

# Add this to your shard.yml
dependencies:
  livechat.cr:
    github: KCreate/livechat.cr
    branch: master

master is a branch, not a release, so this tracks it rather than pinning a version.

Then run:

shards install

shard.yml

Crystal
no constraint declared
License
MIT
Author
Leonard Schuetz

Dependencies

Runtime Dependencies

  • kemal*github: sdogruyol/kemal, branch: master
  • Events*github: kcreate/Events, branch: master

README

livechat.cr

Simple little Livechat written in crystal. It uses kemal, events and WebSockets.

Installation

Clone the repo and run src/main.cr. You may need to update your firewall settings for the server to be able to listen on port 3000.

This project is developed and tested on OS X El Capitan on a Retina Macbook Pro late 2013.

Usage

This is only the backend, you'd have to write your own front-end to really use this. Sorry.

Development

Launch the server and navigate to localhost:3000/index.html

This will do some initialization work in the background via Javascript. It just connects to the socket. You can then send your own commands to the livechat via the global socket variable in the Javascript console.

This looks something like that:

socket.send(JSON.stringify({
    type: 'change_name',
    name: 'Leonard Schuetz'
}));

A list of all available commands is inside the src/commands directory.

Contributing

  1. Fork it (https://github.com/kcreate/livechat.cr/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors

  • KCreate Leonard Schuetz - creator, maintainer